Gửi thuộc tính người dùng

Thuộc tính người dùng mô tả các phân khúc trong cơ sở người dùng, chẳng hạn như lựa chọn ưu tiên về ngôn ngữ hoặc vị trí địa lý. Analytics tự động ghi lại một số thuộc tính người dùng. Nếu bạn muốn thu thập thêm tài sản, bạn có thể thiết lập thêm tối đa 25 người dùng thuộc tính cho mỗi dự án. Xem Thuộc tính người dùng tuỳ chỉnh để tìm hiểu cách đặt và đăng ký thuộc tính người dùng.

Thuộc tính người dùng giúp cải thiện phân khúc người dùng, nhưng dữ liệu thuộc tính người dùng thường chỉ khả dụng ở phía máy chủ. Measurement Protocol cho phép bạn tăng thêm đo lường phía máy khách với dữ liệu phía máy chủ (thường không khả thi) chỉ dùng các giải pháp phía máy khách.

Tên dành riêng

Một số tên thuộc tính người dùng đã được dành riêng và không thể sử dụng trong các phép đo lường:

  • first_open_time
  • first_visit_time
  • last_deep_link_referrer
  • user_id
  • first_open_after_install

Ngoài ra, tên thuộc tính người dùng không được bắt đầu bằng:

  • google_
  • ga_
  • firebase_

Ví dụ về cách sử dụng

Trong ví dụ sau, CRM của bạn có một thuộc tính người dùng (customer_tier) mà bạn muốn thêm vào kết quả đo lường của bạn. Bạn có thể đặt customer_tier thành một trong premium hoặc standard. Để đưa thuộc tính người dùng này vào báo cáo, bạn sẽ làm như như sau:

Trước tiên, hãy yêu cầu ứng dụng gửi một sự kiện add_payment_info cùng với lệnh gọi đến máy chủ API có quyền truy cập vào hệ thống CRM của bạn:

mã khách hàng

Sau đó, máy chủ của bạn sẽ tăng cường kết quả đo lường bằng thuộc tính người dùng customer_tier bằng Measurement Protocol:

mã máy chủ

Thuộc tính người dùng này báo cáo 2 phân khúc premium và standard.

Hãy xem phần Gửi sự kiện để biết toàn bộ thông tin chi tiết về cách gửi sự kiện bằng Measurement Protocol.

Ghi đè dấu thời gian

Measurement Protocol sử dụng dấu thời gian đầu tiên được tìm thấy trong các kết quả sau cho từng thuộc tính người dùng trong yêu cầu:

  1. timestamp_micros của mục nhập trong user_properties.
  2. timestamp_micros của yêu cầu.
  3. Thời gian mà Measurement Protocol nhận được yêu cầu.

Ví dụ sau đây sẽ gửi dấu thời gian ở cấp yêu cầu áp dụng cho tất cả các thuộc tính người dùng trong yêu cầu. Do đó, Measurement Protocol sẽ chỉ định dấu thời gian của cả hai thuộc tính người dùng customer_tier và customer_group requestUnixEpochTimeInMicros.

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

Ví dụ sau đây gửi cả dấu thời gian ở cấp yêu cầu và dấu thời gian cho thuộc tính người dùng customer_tier. Do đó, Measurement Protocol sẽ chỉ định customer_tier là dấu thời gian của customerTierUnixEpochTimeInMicros và customer_group có dấu thời gian là requestUnixEpochTimeInMicros.

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