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

API Trình quản lý dữ liệu hỗ trợ việc tải nhiều loại dữ liệu người dùng lên. Hãy làm theo các yêu cầu về định dạng, băm và mã hoá cho từng phần tử dữ liệu để đảm bảo dữ liệu của bạn được nhận và xử lý thành công.

Yêu cầu về UserData

Đố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 băm bằng cách sử dụng phương thức mã hoá hex hoặc Base64.
phone_number
Định dạng
string
Bao gồm 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 băm bằng cách sử dụng phương thức mã hoá hex hoặc Base64.
address
Đối tượng AddressInfo

Đị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.
Không bao gồ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 băm bằng cách sử dụ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.
Khô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 băm bằng cách sử dụ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 hai ký tự.
Khoảng trắng Cắt bỏ khoảng trắng ở đầu và cuối.
Băm Không băm region_code.
postal_code
Định dạng
string
Bạn 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ố theo sau là một số phụ 4 chữ số. Việc sử dụng phần mở rộng gồm 4 chữ số có thể giúp bạn cải thiện 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 Không băm postal_code.

Yêu cầu về 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:

  1. Băm dữ liệu PII do phòng sạch cung cấp bằng thuật toán SHA-256.
  2. Mã hoá các byte băm bằng thuật toán mật mã hoá hoán vị EC bằng khoá 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.

Yêu cầu về 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. Không băm mã nhận dạng thiết bị di động.

Các bước tiếp theo