設定使用者資料格式

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

• UserData：使用者提供的資料，例如電子郵件地址或電話號碼。
• PairData：發布商廣告主身分核對 (PAIR) ID。
• MobileData：用於識別行動裝置的資料。

UserData 需求條件

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

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

AddressInfo格式

請按照下列格式規範建構 UserIdentifier 的 address 屬性。

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 欄位 (例如 Event 的 timestamp 和 last_updated_timestamp)，請使用 RFC 3339 格式。

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

後續步驟

• 瞭解如何加密使用者資料。