資料管理工具 API 支援上傳多種使用者資料。請遵循各項資料元素的格式、雜湊和編碼規定,確保系統能順利接收及處理資料。
UserData
:使用者提供的資料,例如電子郵件地址或電話號碼。PairData
:發布商廣告主身分核對 (PAIR) ID。MobileData
:用於識別行動裝置的資料。
UserData
需求條件
UserData
物件是 UserIdentifier
物件的集合。每個 UserIdentifier
都必須具備下表中的其中一個屬性。
UserIdentifier | |||||||
---|---|---|---|---|---|---|---|
email_address |
|
||||||
phone_number |
|
||||||
address |
AddressInfo
物件請參閱
AddressInfo 格式規格。 |
AddressInfo
格式
請按照下列格式規範建構 UserIdentifier
的 address
屬性。
AddressInfo | |||||||
---|---|---|---|---|---|---|---|
given_name |
|
||||||
family_name |
|
||||||
region_code |
|
||||||
postal_code |
|
PairData
需求條件
在 PairData
物件的 pair_ids
欄位中填入 ID 清單。
請按照下列步驟設定清單中每個元素的格式:
- 使用 SHA-256 演算法,對 Cleanroom 提供的 PII 資料進行雜湊處理。
- 使用發布商金鑰,透過 EC 可交換密碼,加密 PAIR 使用者清單的雜湊位元組。
- 使用十六進位或 Base64 編碼方式,為加密資料編碼。
MobileData
需求條件
在 MobileData
物件的 mobile_ids
欄位中填入行動 ID 清單。請勿對行動 ID 進行雜湊處理。
時間戳記格式
如果使用 JSON 格式的 Timestamp
欄位 (例如 Event
的 timestamp
和 last_updated_timestamp
),請使用 RFC 3339 格式。
如果使用通訊協定緩衝區格式,請在建構 Timestamp
時設定 seconds
,並視需要設定 nanos
。
後續步驟
- 瞭解如何加密使用者資料。