Đị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 để đảm bảo nhận được và xử lý thành công dữ liệu của bạn.

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 sang chữ thường.
Khoảng trắngCắt bỏ khoảng trắng ở đầu, ở cuối và ở giữa.
BămHàm băm bằng thuật toán SHA-256. Mã hoá các byte băm bằng phương thức mã hoá hex hoặc Base64.
phone_number
Định dạng
string
Thêm dấu cộng (+) và mã quốc gia.
Khoảng trắngCắt bỏ khoảng trắng ở đầu và ở cuối.
BămHàm băm bằng thuật toán SHA-256. Mã hoá các byte băm bằng phương thức mã hoá hex hoặc Base64.
address
Đối tượng AddressInfo

Định dạng: AddressInfo

Hãy làm theo các nguyên tắc định dạng sau đây để tạo thuộc tính address của UserIdentifier.

AddressInfo
given_name
Định dạng
string
Chuyển đổi sang chữ thường.
Không thêm các tiền tố như Mrs.
Khoảng trắngCắt bỏ khoảng trắng ở đầu và ở cuối.
BămHàm băm bằng thuật toán SHA-256. Mã hoá các byte băm bằng phương thức mã hoá hex hoặc Base64.
family_name
Định dạng
string
Chuyển đổi sang chữ thường.
Không thêm các hậu tố như Jr.
Khoảng trắngCắt bỏ khoảng trắng ở đầu và ở cuối.
BămHàm băm bằng thuật toán SHA-256. Mã hoá các byte băm bằng phương thức mã hoá hex hoặc Base64.
region_code
Định dạng
string
Mã gồm hai ký tự theo chuẩn ISO-3166-1 alpha-2.
Khoảng trắngCắt bỏ khoảng trắng ở đầu và ở cuối.
BămĐừng băm region_code.
postal_code
Định dạng
string
Được phép sử dụng cả mã zip và mã bưu chính quốc tế cũng như mã zip và mã bưu chính của Hoa Kỳ.
Đố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 phần mở rộng gồm 4 chữ số. Việc sử dụng mã bưu chính gồm 4 chữ số có thể giúp cải thiện tỷ lệ khớp.
Đối với tất cả các quốc gia khác, không sử dụng phần mở rộng của mã bưu chính.
Khoảng trắngCắt bỏ khoảng trắng ở đầu và ở cuối.
BămĐừng băm postal_code.

PairData yêu cầu

Điền một 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ã giao hoán EC bằng khoá nhà xuất bản cho danh sách người dùng PAIR (GHÉP NỐI).
  3. Mã hoá dữ liệu đã mã hoá bằng bộ mã hoá hex hoặc Base64.

MobileData yêu cầu

Điền danh sách mã thiết bị di động vào trường mobile_ids của đối tượng MobileData. Đừng băm mã nhận dạng thiết bị di động.

Các bước tiếp theo