Định dạng dữ liệu người dùng

Data Manager API hỗ trợ việc 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á cho 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 yêu cầu

Đối tượng UserData là một tập hợp các đối tượng UserIdentifier. Mỗi UserIdentifier có đúng một trong các thuộc tính trong bảng sau.

UserIdentifier
email_address
Định dạng
string
Chuyển đổi thành chữ thường.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu, ở cuối và ở giữa.
Băm Băm bằng thuật toán SHA-256. Mã hoá các byte hàm băm bằng phương thức mã hoá hex hoặc Base64.
phone_number
Định dạng
string
Nhập cả dấu cộng (+) và mã quốc gia.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Băm bằng thuật toán SHA-256. Mã hoá các byte hàm băm bằng phương thức mã hoá hex hoặc Base64.
address
AddressInfo đối tượng

Định dạng: AddressInfo

Hãy sử dụng các nguyên tắc định dạng sau để tạo thuộc tính address của UserIdentifier.

AddressInfo
given_name
Định dạng
string
Chuyển đổi thành chữ thường.
Đừng thêm tiền tố như Mrs.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Băm bằng thuật toán SHA-256. Mã hoá các byte hàm băm bằng phương thức mã hoá hex hoặc Base64.
family_name
Định dạng
string
Chuyển đổi thành chữ thường.
Đừng thêm hậu tố như Jr.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Băm bằng thuật toán SHA-256. Mã hoá các byte hàm băm bằng phương thức mã hoá hex hoặc Base64.
region_code
Định dạng
string
Mã ISO-3166-1 alpha-2 gồm 2 ký tự.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Đừng băm region_code.
postal_code
Định dạng
string
Có thể sử dụng cả mã bưu chính của Hoa Kỳ và mã bưu chính quốc tế.
Đối với địa chỉ ở Hoa Kỳ, hãy sử dụng 5 chữ số hoặc 5 chữ số, sau đó là 4 chữ số bổ sung. Việc sử dụng số mở rộng gồm 4 chữ số có thể giúp tăng tỷ lệ khớp.
Đối với tất cả các quốc gia khác, đừng sử dụng phần mở rộng của mã bưu chính.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Đừng băm postal_code.

PairData yêu cầu

Điền vào trường pair_ids của đối tượng PairData bằng danh sách mã nhận dạng. Định dạng từng phần tử trong danh sách theo các bước sau:

  1. Băm dữ liệu PII do clean room cung cấp bằng thuật toán SHA-256.
  2. Mã hoá các byte băm bằng một thuật toán 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.
  3. Mã hoá dữ liệu đã mã hoá bằng cách sử dụng phương thức mã hoá hex hoặc Base64.

MobileData yêu cầu

Điền vào trường mobile_ids của đối tượng MobileData bằng 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 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.

Nếu sử dụng định dạng bộ đệm giao thức, hãy đặt seconds và (không bắt buộc) nanos khi tạo Timestamp.

Các bước tiếp theo