Skip to content

Commit bd41e66

Browse files
committed
Rephrase disclaimer
1 parent fc5e3b2 commit bd41e66

File tree

3 files changed

+23
-17
lines changed

3 files changed

+23
-17
lines changed

docs/attributes-registry/device.md

+8-6
Original file line numberDiff line numberDiff line change
@@ -14,20 +14,22 @@ Describes device attributes.
1414
| <a id="device-model-identifier" href="#device-model-identifier">`device.model.identifier`</a> | string | The model identifier for the device [3] | `iPhone3,4`; `SM-G920F` | ![Development](https://img.shields.io/badge/-development-blue) |
1515
| <a id="device-model-name" href="#device-model-name">`device.model.name`</a> | string | The marketing name for the device model [4] | `iPhone 6s Plus`; `Samsung Galaxy S6` | ![Development](https://img.shields.io/badge/-development-blue) |
1616

17-
**[1] `device.id`:** **The `device.id` SHOULD NOT be used in most user-facing applications due to privacy regulations.
18-
Consequently, instrumentations that provide it MUST provide it as an opt-in feature.**
19-
20-
Its value SHOULD be identical for all apps on a device and it SHOULD NOT change if an app is uninstalled and re-installed.
17+
**[1] `device.id`:** Its value SHOULD be identical for all apps on a device and it SHOULD NOT change if an app is uninstalled and re-installed.
2118
However, it might be resettable by the user for all apps on a device.
2219
Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MIGHT be used as values.
2320

2421
More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
2522

2623
> [!WARNING]
2724
>
28-
> This attribute contains sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
25+
> This attribute may contain sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
2926
> ensure you do your own due diligence.
30-
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) as a more privacy-preserving alternative.
27+
>
28+
> Due to these reasons, this identifier is not recommended for consumer applications and will likely result in rejection from both Google Play and App Store.
29+
> However, it may be appropriate for specific enterprise scenarios, such as kiosk devices or enterprise-managed devices, with appropriate compliance clearance.
30+
> Any instrumentation providing this identifier MUST implement it as an opt-in feature.
31+
>
32+
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) for a more privacy-preserving alternative.
3133
3234
**[2] `device.manufacturer`:** The Android OS provides this field via [Build](https://developer.android.com/reference/android/os/Build#MANUFACTURER). iOS apps SHOULD hardcode the value `Apple`.
3335

docs/resource/device.md

+8-6
Original file line numberDiff line numberDiff line change
@@ -27,20 +27,22 @@
2727

2828
**[3] `device.model.name`:** It's recommended this value represents a human-readable version of the device model rather than a machine-readable alternative.
2929

30-
**[4] `device.id`:** **The `device.id` SHOULD NOT be used in most user-facing applications due to privacy regulations.
31-
Consequently, instrumentations that provide it MUST provide it as an opt-in feature.**
32-
33-
Its value SHOULD be identical for all apps on a device and it SHOULD NOT change if an app is uninstalled and re-installed.
30+
**[4] `device.id`:** Its value SHOULD be identical for all apps on a device and it SHOULD NOT change if an app is uninstalled and re-installed.
3431
However, it might be resettable by the user for all apps on a device.
3532
Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MIGHT be used as values.
3633

3734
More information about Android identifier best practices can be found [here](https://developer.android.com/training/articles/user-data-ids).
3835

3936
> [!WARNING]
4037
>
41-
> This attribute contains sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
38+
> This attribute may contain sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
4239
> ensure you do your own due diligence.
43-
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) as a more privacy-preserving alternative.
40+
>
41+
> Due to these reasons, this identifier is not recommended for consumer applications and will likely result in rejection from both Google Play and App Store.
42+
> However, it may be appropriate for specific enterprise scenarios, such as kiosk devices or enterprise-managed devices, with appropriate compliance clearance.
43+
> Any instrumentation providing this identifier MUST implement it as an opt-in feature.
44+
>
45+
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) for a more privacy-preserving alternative.
4446
4547
<!-- markdownlint-restore -->
4648
<!-- prettier-ignore-end -->

model/device/registry.yaml

+7-5
Original file line numberDiff line numberDiff line change
@@ -11,9 +11,6 @@ groups:
1111
brief: >
1212
A unique identifier representing the device
1313
note: |
14-
**The `device.id` SHOULD NOT be used in most user-facing applications due to privacy regulations.
15-
Consequently, instrumentations that provide it MUST provide it as an opt-in feature.**
16-
1714
Its value SHOULD be identical for all apps on a device and it SHOULD NOT change if an app is uninstalled and re-installed.
1815
However, it might be resettable by the user for all apps on a device.
1916
Hardware IDs (e.g. vendor-specific serial number, IMEI or MAC address) MIGHT be used as values.
@@ -22,9 +19,14 @@ groups:
2219
2320
> [!WARNING]
2421
>
25-
> This attribute contains sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
22+
> This attribute may contain sensitive (PII) information. Caution should be taken when storing personal data or anything which can identify a user. GDPR and data protection laws may apply,
2623
> ensure you do your own due diligence.
27-
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) as a more privacy-preserving alternative.
24+
>
25+
> Due to these reasons, this identifier is not recommended for consumer applications and will likely result in rejection from both Google Play and App Store.
26+
> However, it may be appropriate for specific enterprise scenarios, such as kiosk devices or enterprise-managed devices, with appropriate compliance clearance.
27+
> Any instrumentation providing this identifier MUST implement it as an opt-in feature.
28+
>
29+
> See [`app.installation.id`](/docs/attributes-registry/app.md#app-installation-id) for a more privacy-preserving alternative.
2830
examples:
2931
- '123456789012345'
3032
- 01:23:45:67:89:AB

0 commit comments

Comments
 (0)