发送用户属性

用户属性用于描述用户群细分，例如语言偏好设置或地理位置。Google Analytics 会自动记录一些用户属性。如果要收集其他属性，每个项目最多可以设置 25 个其他用户属性。如需了解如何设置和注册用户属性，请参阅自定义用户属性。

用户属性用于改进用户细分，不过用户属性数据通常仅在服务器端提供。利用 Measurement Protocol，您可以 使用服务器端数据进行客户端衡量，这通常不可行 仅使用客户端解决方案

预留名称

部分用户属性名称已预留，不能用于衡量：

• first_open_time
• first_visit_time
• last_deep_link_referrer
• user_id
• first_open_after_install

此外，用户属性名称不能以下列内容开头：

• google_
• ga_
• firebase_

用法示例

在下面的示例中，您的 CRM 系统具有一个要在衡量中添加的用户属性 (customer_tier)。customer_tier 可以设置为 premium 或 standard 中的一个。如需在报告中显示此用户属性，您需要执行以下操作：

首先，让客户端发送 add_payment_info 事件并调用 有权访问您的客户关系管理系统的服务器 API：

客户端代码

然后，您的服务器会使用 customer_tier 用户属性增强衡量 使用 Measurement Protocol：

服务器代码

此用户属性会报告 premium 和 standard 这两个细分。

请参阅发送事件，详细了解如何使用 Measurement Protocol。

替换时间戳

Measurement Protocol 使用在以下代码中发现的第一个时间戳 每个用户属性的列表：

1. user_properties 中条目的 timestamp_micros。
2. 请求的 timestamp_micros。
3. Measurement Protocol 收到请求的时间。

以下示例会发送一个请求级时间戳，该时间戳应用于 请求中的用户属性因此，Measurement Protocol 分配给 customer_tier 和 customer_group 用户属性的时间戳均为 requestUnixEpochTimeInMicros。

{
  "timestamp_micros": requestUnixEpochTimeInMicros,
  "user_properties": {
      "customer_tier": {
        "value": customerTierValue
      },
      "customer_group": {
        "value": customerGroupValue
      }
  }
}

以下示例同时发送请求级时间戳和 customer_tier 用户属性。因此，Measurement Protocol 分配给 customer_tier 和 customerTierUnixEpochTimeInMicros 时间戳，以及 customer_group 是 requestUnixEpochTimeInMicros 的时间戳。

"timestamp_micros": requestUnixEpochTimeInMicros,
"user_properties": {
    "customer_tier": {
      "value": customerTierValue,
      "timestamp_micros": customerTierUnixEpochTimeInMicros
    },
    "customer_group": {
      "value": customerGroupValue
    }
}