Merge pull request #128 from flashcatcloud/doc-review/2026-06-30-rum-user-fields

[codex] clarify mobile RUM user fields

Author: Fiona2016

en/rum/sdk/android/advanced-config.mdx

@@ -246,9 +246,9 @@ public void onHeroImageLoaded() {
 After setting timing, access it via `@view.custom_timings.<timing_name>`, e.g., `@view.custom_timings.hero_image`.
 </Tip>
 
-### Add User Attributes
+### Set User Information
 
-The RUM SDK automatically tracks user attributes. You can also add additional custom user attributes like user plan, user group, etc.
+The RUM SDK supports standard user information.
 
 <Tabs>
 <Tab title="Kotlin">
@@ -258,38 +258,28 @@ import com.datadog.android.rum.GlobalRumMonitor
 GlobalRumMonitor.get().setUserInfo(
     id = "1234",
     name = "John Doe",
-    email = "john@doe.com",
-    extraInfo = mapOf(
-        "plan" to "premium",
-        "group" to "vip"
-    )
+    email = "john@doe.com"
 )
 ```
 </Tab>
 
 <Tab title="Java">
 ```java
 import com.datadog.android.rum.GlobalRumMonitor;
-import java.util.HashMap;
-import java.util.Map;
-
-Map<String, Object> extraInfo = new HashMap<>();
-extraInfo.put("plan", "premium");
-extraInfo.put("group", "vip");
 
 GlobalRumMonitor.get().setUserInfo(
     "1234",
     "John Doe",
     "john@doe.com",
-    extraInfo
+    null
 );
 ```
 </Tab>
 </Tabs>
 
-<Tip>
-Custom user attributes can be used to group and filter data in the Insights dashboard, helping you understand usage patterns of different user groups.
-</Tip>
+<Warning>
+Only standard user fields are supported: `id`, `name`, `email`, and `anonymous_id`. Other user attributes are not supported. If needed, configure them under `context`.
+</Warning>
 
 ## Event and Data Management
 

en/rum/sdk/android/data-collection.mdx

@@ -47,7 +47,7 @@ The SDK automatically attaches the following system context to help diagnose per
 | OS information | Android version, major version, build number, locale, time zone | Diagnose OS-version or region-specific issues |
 | Network information | Network type, cellular technology, carrier name, uplink/downlink bandwidth, signal strength | Analyze how network quality affects user experience |
 | RUM events | View, Action, Resource, Error, Long Task, app startup timing | Reconstruct user journeys and diagnose errors or performance bottlenecks |
-| User information | `usr.id`, `usr.name`, `usr.email`, and custom attributes | Attached only when your app explicitly sets user data through the API |
+| User information | `usr.id`, `usr.name`, `usr.email`, `usr.anonymous_id` | Attached only when your app explicitly sets user data through the API; other user attributes are not supported. If needed, configure them under `context` |
 
 <Info>
 The geo-location fields documented below are inferred by the Flashduty backend from the client request IP address. They are not collected from Android system location APIs. The SDK does not call GPS, cell-tower location, or fused location APIs, and it does not require location permissions.
@@ -189,10 +189,11 @@ You can set user information via the `setUser()` API, which will be attached to
 | `usr.id` | string | User's unique identifier |
 | `usr.name` | string | User's friendly name |
 | `usr.email` | string | User's email address |
+| `usr.anonymous_id` | string | Anonymous user identifier |
 
-<Tip>
-You can also add custom user attributes such as `usr.plan`, `usr.role`, etc.
-</Tip>
+<Note>
+Only the standard user fields above are supported. Other user attributes are not supported. If needed, configure them under `context`.
+</Note>
 
 </Accordion>
 

en/rum/sdk/ios/advanced-config.mdx

@@ -172,7 +172,7 @@ RUMMonitor.shared().addError(
 </Tab>
 </Tabs>
 
-### Add User Attributes
+### Set User Information
 
 Set user information for the current session:
 
@@ -184,11 +184,7 @@ import DatadogCore
 Datadog.setUserInfo(
     id: "user-123",
     name: "John Doe",
-    email: "john.doe@example.com",
-    extraInfo: [
-        "plan": "premium",
-        "signup_date": "2024-01-15"
-    ]
+    email: "john.doe@example.com"
 )
 ```
 </Tab>
@@ -200,17 +196,14 @@ Datadog.setUserInfo(
 [DDDatadog setUserInfoWithId:@"user-123"
                         name:@"John Doe"
                        email:@"john.doe@example.com"
-                   extraInfo:@{
-                       @"plan": @"premium",
-                       @"signup_date": @"2024-01-15"
-                   }];
+                   extraInfo:nil];
 ```
 </Tab>
 </Tabs>
 
-<Tip>
-Custom user attributes can be used to group and filter data in the Insights dashboard.
-</Tip>
+<Warning>
+Only standard user fields are supported: `id`, `name`, `email`, and `anonymous_id`. Other user attributes are not supported. If needed, configure them under `context`.
+</Warning>
 
 ## Event and Data Management
 

en/rum/sdk/ios/data-collection.mdx

@@ -122,11 +122,16 @@ You can enable user tracking on all RUM events to correlate user sessions and si
 | `usr.id` | String | User unique identifier |
 | `usr.name` | String | User-friendly name, displayed by default in RUM UI |
 | `usr.email` | String | User email address, displayed if no username |
+| `usr.anonymous_id` | String | Anonymous user identifier |
 
 <Tip>
 User attributes are optional but we recommend providing at least one. See [Track User Information](/en/rum/sdk/ios/sdk-integration#track-user-information).
 </Tip>
 
+<Note>
+Only the standard user fields above are supported. Other user attributes are not supported. If needed, configure them under `context`.
+</Note>
+
 </Accordion>
 
 </AccordionGroup>

en/rum/sdk/ios/sdk-integration.mdx

@@ -419,17 +419,13 @@ import DatadogCore
 Datadog.setUserInfo(
     id: "user-123",
     name: "John Doe",
-    email: "john.doe@example.com",
-    extraInfo: [
-        "plan": "premium",
-        "signup_date": "2024-01-15"
-    ]
+    email: "john.doe@example.com"
 )
 ```
 
-<Tip>
-Custom user attributes (like `plan`, `signup_date`) can be used to group and filter data in the Insights dashboard.
-</Tip>
+<Warning>
+Only standard user fields are supported: `id`, `name`, `email`, and `anonymous_id`. Other user attributes are not supported. If needed, configure them under `context`.
+</Warning>
 
 ### Offline Data Handling
 

zh/rum/sdk/android/advanced-config.mdx

@@ -247,9 +247,9 @@ public void onHeroImageLoaded() {
 设置计时后，可通过 `@view.custom_timings.<timing_name>` 访问，例如 `@view.custom_timings.hero_image`。
 </Tip>
 
-### 添加用户属性
+### 设置用户信息
 
-RUM SDK 会自动追踪用户属性。您还可以添加额外的自定义用户属性，例如用户计划、用户组等。
+RUM SDK 支持设置标准用户信息。
 
 <Tabs>
 <Tab title="Kotlin">
@@ -259,38 +259,28 @@ import com.datadog.android.rum.GlobalRumMonitor
 GlobalRumMonitor.get().setUserInfo(
     id = "1234",
     name = "John Doe",
-    email = "john@doe.com",
-    extraInfo = mapOf(
-        "plan" to "premium",
-        "group" to "vip"
-    )
+    email = "john@doe.com"
 )
 ```
 </Tab>
 
 <Tab title="Java">
 ```java
 import com.datadog.android.rum.GlobalRumMonitor;
-import java.util.HashMap;
-import java.util.Map;
-
-Map<String, Object> extraInfo = new HashMap<>();
-extraInfo.put("plan", "premium");
-extraInfo.put("group", "vip");
 
 GlobalRumMonitor.get().setUserInfo(
     "1234",
     "John Doe",
     "john@doe.com",
-    extraInfo
+    null
 );
 ```
 </Tab>
 </Tabs>
 
-<Tip>
-自定义用户属性可用于在分析看板中分组和过滤数据，帮助您了解不同用户群体的使用情况。
-</Tip>
+<Warning>
+当前仅支持设置用户标准字段：`id`、`name`、`email`、`anonymous_id`；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Warning>
 
 ## 事件和数据管理
 
@@ -464,6 +454,10 @@ GlobalRumMonitor.get().setUserInfo("1234", "John Doe", "john@doe.com", null);
 </Tab>
 </Tabs>
 
+<Warning>
+当前仅支持设置用户标准字段：`id`、`name`、`email`、`anonymous_id`；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Warning>
+
 <Note>
 **参数说明：**
 - `id` (String) - 唯一用户标识符

zh/rum/sdk/android/data-collection.mdx

@@ -48,7 +48,7 @@ SDK 会自动附加以下系统上下文，帮助排查性能、崩溃和网络
 | 系统信息 | Android 版本、系统主版本、系统构建号、语言、时区 | 定位系统版本或区域相关问题 |
 | 网络信息 | 网络类型、蜂窝网络制式、运营商名称、上下行带宽、信号强度 | 分析网络质量对体验的影响 |
 | RUM 事件 | View、Action、Resource、Error、Long Task、启动耗时 | 还原用户旅程、定位错误和性能瓶颈 |
-| 用户信息 | `usr.id`、`usr.name`、`usr.email` 及自定义属性 | 仅在业务主动调用 API 设置时附加 |
+| 用户信息 | `usr.id`、`usr.name`、`usr.email`、`usr.anonymous_id` | 仅在业务主动调用 API 设置时附加；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置 |
 
 <Info>
 本文档列出的“地理位置”字段由 Flashduty 后端根据客户端请求 IP 推断，不是 Android 客户端读取系统定位。SDK 不调用 GPS、基站定位或融合定位 API，也不需要定位权限。
@@ -190,10 +190,11 @@ RUM 可以从用户的 IP 地址推断出地理位置信息：
 | `usr.id` | string | 用户的唯一标识符 |
 | `usr.name` | string | 用户的友好名称 |
 | `usr.email` | string | 用户的电子邮件地址 |
+| `usr.anonymous_id` | string | 匿名用户标识符 |
 
-<Tip>
-您还可以添加自定义用户属性，例如 `usr.plan`、`usr.role` 等。
-</Tip>
+<Note>
+当前仅支持以上用户标准字段，其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Note>
 
 </Accordion>
 

zh/rum/sdk/ios/advanced-config.mdx

@@ -272,11 +272,7 @@ import DatadogCore
 Datadog.setUserInfo(
     id: "1234",
     name: "John Doe",
-    email: "john@doe.com",
-    extraInfo: [
-        "plan": "premium",
-        "signup_date": "2024-01-15"
-    ]
+    email: "john@doe.com"
 )
 ```
 </Tab>
@@ -288,11 +284,15 @@ Datadog.setUserInfo(
 [DDDatadog setUserInfoWithId:@"1234"
                         name:@"John Doe"
                        email:@"john@doe.com"
-                   extraInfo:@{@"plan": @"premium", @"signup_date": @"2024-01-15"}];
+                   extraInfo:nil];
 ```
 </Tab>
 </Tabs>
 
+<Warning>
+当前仅支持设置用户标准字段：`id`、`name`、`email`、`anonymous_id`；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Warning>
+
 <Note>
 **参数说明：**
 - `usr.id` (字符串) - 唯一用户标识符
@@ -637,19 +637,7 @@ Datadog.set(trackingConsent: .granted)
 
 ## 添加用户属性
 
-您可以使用 `Datadog.addUserExtraInfo(_:)` API 将额外的用户属性附加到先前设置的属性上。
-
-```swift
-import DatadogCore
-
-Datadog.addUserExtraInfo(["company": "Flashduty"])
-```
-
-```objective-c
-@import DatadogObjc;
-
-[DDDatadog addUserExtraInfo:@{@"company": @"Flashduty"}];
-```
+当前仅支持设置用户标准字段：`id`、`name`、`email`、`anonymous_id`；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
 
 ## 数据管理
 

zh/rum/sdk/ios/data-collection.mdx

@@ -123,11 +123,16 @@ iOS RUM SDK 为所有事件自动附加默认属性，帮助您了解用户设
 | `usr.id` | 字符串 | 用户的唯一标识符 |
 | `usr.name` | 字符串 | 用户友好名称，默认显示在 RUM UI 中 |
 | `usr.email` | 字符串 | 用户电子邮件地址，如果没有用户名则显示电子邮件 |
+| `usr.anonymous_id` | 字符串 | 匿名用户标识符 |
 
 <Tip>
 用户属性是可选的，但建议至少提供一个。详见 [追踪用户信息](/zh/rum/sdk/ios/sdk-integration#追踪用户信息)。
 </Tip>
 
+<Note>
+当前仅支持以上用户标准字段，其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Note>
+
 </Accordion>
 
 </AccordionGroup>

zh/rum/sdk/ios/sdk-integration.mdx

@@ -420,17 +420,13 @@ import DatadogCore
 Datadog.setUserInfo(
     id: "user-123",
     name: "John Doe",
-    email: "john.doe@example.com",
-    extraInfo: [
-        "plan": "premium",
-        "signup_date": "2024-01-15"
-    ]
+    email: "john.doe@example.com"
 )
 ```
 
-<Tip>
-自定义用户属性（如 `plan`、`signup_date`）可用于在分析看板中分组和过滤数据。
-</Tip>
+<Warning>
+当前仅支持设置用户标准字段：`id`、`name`、`email`、`anonymous_id`；其他用户属性不支持。如有需求，可以在 `context` 字段进行配置。
+</Warning>
 
 ### 离线数据处理