UserData

可識別使用者的資料。至少須提供一個 ID。

JSON 表示法 
{
  "userIdentifiers": [
    {
      object (UserIdentifier)
    }
  ]
}
欄位
userIdentifiers[]

object (UserIdentifier)

必填。使用者的 ID。您可以提供相同類型資料的多個執行個體 (例如多個電子郵件地址)。如要提高比對成功率，請盡可能提供多種 ID。單一 AudienceMember 或 Event 最多可提供 10 個 userIdentifiers。

UserIdentifier

使用者的單一 ID。

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.
}
欄位
必須指定一個選項。以下列出互斥的欄位。回應中最多只會設定一個欄位：
emailAddress

string

使用 SHA-256 雜湊函式，對正規化後的電子郵件地址進行雜湊處理。
phoneNumber

string

使用 SHA-256 雜湊函式，對經過正規化 (E164 標準) 的電話號碼進行雜湊處理。
address

object (AddressInfo)

使用者地址的已知元件。包含一次比對的所有 ID 分組。
互斥欄位的結尾。

AddressInfo

使用者的地址資訊。

JSON 表示法 
{
  "givenName": string,
  "familyName": string,
  "regionCode": string,
  "postalCode": string,
  "addressLine": string,
  "city": string,
  "administrativeArea": string
}
欄位
givenName

string

必填。使用者名字 (不含標點符號、開頭或結尾的空白字元，且一律為小寫)，並以 SHA-256 雜湊處理。
familyName

string

必填。使用者姓氏，須為全小寫，不得包含標點符號、開頭或結尾空白字元，並以 SHA-256 雜湊處理。
regionCode

string

必填。使用者地址的 ISO-3166-1 alpha-2 雙字母區域代碼。
postalCode

string

必填。使用者地址的郵遞區號。
addressLine

string

(選用步驟) 使用者的街道和門牌號碼。僅適用於 Google Analytics。這個欄位經過雜湊處理，可能也經過加密。

先將值正規化，再進行雜湊處理：

  • 移除符號字元
  • 轉換為小寫
  • 移除開頭和結尾的空白字元
city

string

(選用步驟) 使用者地址的城市。僅適用於 Google Analytics。

值應正規化如下：

  • 移除符號字元
  • 轉換為小寫
  • 移除開頭和結尾的空白字元
administrativeArea

string

(選用步驟) 使用者地址的行政區 (州/省)。僅適用於 Google Analytics。

值應正規化如下：

  • 移除符號字元
  • 轉換為小寫
  • 移除開頭和結尾的空白字元