傳送使用者屬性

使用者屬性描述使用者族群區隔,例如語言偏好設定 或地理位置Analytics 會自動記錄部分使用者屬性。如果 如想收集額外資源,您最多可以再設定 25 位使用者 每項專案的屬性請參閱自訂使用者屬性,瞭解如何設定和 登錄使用者屬性

使用者屬性能增強使用者區隔,但使用者屬性資料通常只會 可用的伺服器端Measurement Protocol 能讓您 使用伺服器端資料進行用戶端評估,但通常無法這麼做 只使用用戶端解決方案

保留名稱

部分使用者屬性名稱為預留名稱,無法用於評估:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

此外,使用者屬性名稱的開頭不得為:

  • google_
  • ga_
  • firebase_

使用案例:

在以下範例中,您的客戶關係管理系統中有使用者屬性 (customer_tier) 我想加入測量資料customer_tier 可設為以下其中一個值: premiumstandard。如要在報表中取得這項使用者屬性,請按照下列步驟進行: 包括:

首先,請客戶傳送 add_payment_info 事件以及呼叫 具有您客戶關係管理系統存取權的伺服器 API:

用戶端代碼

接著,您的伺服器使用 customer_tier 使用者屬性擴增測量結果 使用 Measurement Protocol:

伺服器程式碼

這項使用者屬性會回報 premiumstandard 這兩個區隔。

如需如何使用 Measurement Protocol。

覆寫時間戳記

Measurement Protocol 會使用在下列時間找到的第一個時間戳記 列出每個使用者屬性的清單:

  1. user_properties 中項目的 timestamp_micros
  2. 要求的 timestamp_micros
  3. Measurement Protocol 接收要求的時間。

以下範例傳送的要求層級時間戳記會套用至所有 使用者屬性。因此,Measurement Protocol 會指派 customer_tiercustomer_group 使用者屬性的時間戳記 requestUnixEpochTimeInMicros

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

以下範例會同時傳送要求層級的時間戳記和 customer_tier 使用者屬性。因此,Measurement Protocol 會指派 customer_tiercustomerTierUnixEpochTimeInMicros 的時間戳記,而 customer_grouprequestUnixEpochTimeInMicros 的時間戳記。

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