設定使用者資料格式

資料管理工具 API 支援上傳多種使用者資料。請遵循各項資料元素的格式、雜湊和編碼規定,確保系統能順利接收及處理資料。

UserData 需求條件

UserData 物件是 UserIdentifier 物件的集合。每個 UserIdentifier 都必須具備下表中的其中一個屬性。

UserIdentifier
email_address
格式
string
轉換為小寫。
空白字元 修剪開頭、結尾和中間的空白字元。
雜湊 使用 SHA-256 演算法進行雜湊處理。 使用十六進位或 Base64 編碼,為雜湊位元組編碼。
phone_number
格式
string
請使用 E.164 格式
包含加號 (+) 和國家/地區代碼。
空白字元 修剪開頭和結尾的空白字元。
雜湊 使用 SHA-256 演算法進行雜湊處理。 使用十六進位或 Base64 編碼,為雜湊位元組編碼。
address

AddressInfo格式

請按照下列格式規範建構 UserIdentifieraddress 屬性。

AddressInfo
given_name
格式
string
轉換為小寫。
請勿加入 Mrs. 等前置字元
空白字元 修剪開頭和結尾的空白字元。
雜湊 使用 SHA-256 演算法進行雜湊處理。 使用十六進位或 Base64 編碼,為雜湊位元組編碼。
family_name
格式
string
轉換為小寫。
請勿加入 Jr. 等後置字元
空白字元 修剪開頭和結尾的空白字元。
雜湊 使用 SHA-256 演算法進行雜湊處理。 使用十六進位或 Base64 編碼,為雜湊位元組編碼。
region_code
格式
string
雙字元 ISO-3166-1 alpha-2 代碼。
空白字元 修剪開頭和結尾的空白字元。
雜湊 請勿對 region_code 進行雜湊處理。
postal_code
格式
string
美國與國際郵遞區號皆可使用。
美國地址的郵遞區號應為 5 位數,或 5 位數加上 4 位數的延伸號碼。使用 4 碼額外編碼的郵遞區號,有助於提升媒合率。
如為其他國家/地區,請勿使用郵遞區號擴展資訊。
空白字元 修剪開頭和結尾的空白字元。
雜湊 請勿對 postal_code 進行雜湊處理。

PairData 需求條件

PairData 物件的 pair_ids 欄位中填入 ID 清單。 請按照下列步驟設定清單中每個元素的格式:

  1. 使用 SHA-256 演算法,對 Cleanroom 提供的 PII 資料進行雜湊處理。
  2. 使用發布商金鑰,透過 EC 可交換密碼,加密 PAIR 使用者清單的雜湊位元組。
  3. 使用十六進位或 Base64 編碼方式,為加密資料編碼。

MobileData 需求條件

MobileData 物件的 mobile_ids 欄位中填入行動 ID 清單。請勿對行動 ID 進行雜湊處理。

時間戳記格式

如果使用 JSON 格式的 Timestamp 欄位 (例如 Eventtimestamplast_updated_timestamp),請使用 RFC 3339 格式。

如果使用通訊協定緩衝區格式,請在建構 Timestamp 時設定 seconds,並視需要設定 nanos

後續步驟