UserData

Dữ liệu nhận dạng người dùng. Bạn phải có ít nhất một giá trị nhận dạng.

Biểu diễn dưới dạng JSON
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ]
}
Trường
userIdentifiers[]

object (UserIdentifier)

Bắt buộc. Giá trị nhận dạng của người dùng. Bạn có thể cung cấp nhiều phiên bản của cùng một loại dữ liệu (ví dụ: nhiều địa chỉ email). Để tăng khả năng trùng khớp, hãy cung cấp càng nhiều giá trị nhận dạng càng tốt. Bạn có thể cung cấp tối đa 10 userIdentifiers trong một AudienceMember hoặc Event.

UserIdentifier

Giá trị nhận dạng duy nhất cho người dùng.

Biểu diễn dưới dạng JSON
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "emailAddress": string,
  "phoneNumber": string,
  "address": {
    object (AddressInfo)
  }
  // End of mutually exclusive fields.
}
Trường
Bạn phải chỉ định đúng một. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
emailAddress

string

Địa chỉ email đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá.

phoneNumber

string

Số điện thoại đã băm bằng hàm băm SHA-256 sau khi chuẩn hoá (tiêu chuẩn E164).

address

object (AddressInfo)

Các thành phần đã biết trong địa chỉ của người dùng. Chứa một nhóm giá trị nhận dạng được so khớp cùng một lúc.

Kết thúc các trường xung khắc.

AddressInfo

Thông tin địa chỉ của người dùng.

Biểu diễn dưới dạng JSON
{
  "givenName": string,
  "familyName": string,
  "regionCode": string,
  "postalCode": string,
  "addressLine": string,
  "city": string,
  "administrativeArea": string
}
Trường
givenName

string

Bắt buộc. Tên (tên riêng) của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.

familyName

string

Bắt buộc. Họ của người dùng, tất cả đều là chữ thường, không có dấu câu, không có khoảng trắng ở đầu hoặc cuối và được băm dưới dạng SHA-256.

regionCode

string

Bắt buộc. Mã vùng gồm 2 chữ cái theo chuẩn ISO-3166-1 alpha-2 trong địa chỉ của người dùng.

postalCode

string

Bắt buộc. Mã bưu chính trong địa chỉ của người dùng.

addressLine

string

Không bắt buộc. Đường phố và số nhà trong địa chỉ của người dùng. Chỉ dùng cho Google Analytics. Trường này được băm và có thể được mã hoá.

Chuẩn hoá giá trị trước khi băm:

  • Xoá ký tự biểu tượng
  • Chuyển đổi thành chữ thường
  • Xoá khoảng trắng ở đầu và cuối
city

string

Không bắt buộc. Thành phố trong địa chỉ của người dùng. Chỉ dùng cho Google Analytics.

Bạn nên chuẩn hoá giá trị như sau:

  • Xoá ký tự biểu tượng
  • Chuyển đổi thành chữ thường
  • Xoá khoảng trắng ở đầu và cuối
administrativeArea

string

Không bắt buộc. Khu vực hành chính (tiểu bang/tỉnh) trong địa chỉ của người dùng. Chỉ dùng cho Google Analytics.

Bạn nên chuẩn hoá giá trị như sau:

  • Xoá ký tự biểu tượng
  • Chuyển đổi thành chữ thường
  • Xoá khoảng trắng ở đầu và cuối