API Trình quản lý dữ liệu hỗ trợ tải nhiều loại dữ liệu người dùng lên. Hãy tuân thủ các yêu cầu về định dạng, băm và mã hoá đối với từng phần tử dữ liệu để dữ liệu của bạn được nhận và xử lý thành công.
UserData: Dữ liệu do người dùng cung cấp, chẳng hạn như địa chỉ email hoặc số điện thoại.IpData: Dữ liệu IP, chẳng hạn như địa chỉ IP và dấu thời gian được liên kết.PairData: Mã nhận dạng đối chiếu nhà quảng cáo của nhà xuất bản (PAIR).MobileData: Dữ liệu xác định một thiết bị di động.
Yêu cầu đối với UserData
Đối tượng UserData là một tập hợp các đối tượng UserIdentifier. Mỗi UserIdentifier có chính xác một trong các thuộc tính trong bảng sau.
| UserIdentifier | |||||||
|---|---|---|---|---|---|---|---|
email_address |
|
||||||
phone_number |
|
||||||
address |
AddressInfo
đối tượngTham khảo thông số định dạng
AddressInfo. |
||||||
Định dạng AddressInfo
Hãy làm theo các nguyên tắc định dạng sau để tạo thuộc tính address của UserIdentifier.
| AddressInfo | |||||||
|---|---|---|---|---|---|---|---|
given_name |
|
||||||
family_name |
|
||||||
region_code |
|
||||||
postal_code |
|
||||||
Yêu cầu đối với IpData
Đối tượng IpData có các thuộc tính sau.
| IpData | |||||||
|---|---|---|---|---|---|---|---|
ip_address |
|
||||||
Yêu cầu đối với PairData
Điền danh sách mã nhận dạng vào trường pair_ids của đối tượng PairData.
Định dạng từng phần tử trong danh sách theo các bước sau:
- Băm dữ liệu PII do cleanroom cung cấp bằng thuật toán SHA-256.
- Mã hoá các byte băm bằng mật mã giao hoán EC bằng khoá của nhà xuất bản cho danh sách người dùng PAIR.
- Mã hoá dữ liệu đã mã hoá bằng cách mã hoá hex hoặc Base64.
Yêu cầu đối với MobileData
Điền danh sách mã nhận dạng thiết bị di động vào trường mobile_ids của đối tượng MobileData với danh sách
mã nhận dạng thiết bị di động. Không băm mã nhận dạng thiết bị di động.
Định dạng dấu thời gian
Nếu bạn sử dụng định dạng JSON cho các trường Timestamp, chẳng hạn như
timestamp và last_updated_timestamp của Event, hãy sử dụng định dạng RFC
3339. Dưới đây là một số ví dụ về thời gian UTC vào ngày 8 tháng 8 năm 2025 lúc 5:18:44.291 chiều theo định dạng RFC 3339 và các múi giờ khác:
- Múi giờ UTC:
2025-08-08T17:18:44.291Z - Múi giờ EDT, sớm hơn 4 giờ so với UTC vào thời điểm đó:
2025-08-08T13:18:44.291-04:00 - Múi giờ PDT, sớm hơn 7 giờ so với UTC vào thời điểm đó:
2025-08-08T10:18:44.291-07:00 - Múi giờ của Tokyo, Nhật Bản, sớm hơn 9 giờ so với UTC và không áp dụng giờ mùa hè:
2025-08-08T22:18:44.291+09:00
Nếu bạn sử dụng định dạng vùng đệm giao thức, hãy đặt seconds và tuỳ ý đặt nanos khi tạo Timestamp. Dưới đây là các giá trị seconds và nanos cho thời gian UTC vào ngày 8 tháng 8 năm 2025 lúc 5:18:44.291 chiều:
seconds:1754683124nanos:291000000
Mã hóa
Hãy lưu ý những điều sau khi mã hoá dữ liệu:
- Bạn không cần quan tâm đến cách viết hoa của kết quả mã hoá khi sử dụng phương thức mã hoá thập lục phân (hex).
- Bạn cần quan tâm đến cách viết hoa của kết quả mã hoá khi sử dụng phương thức mã hoá Base64 encoding.