Chuẩn bị dữ liệu người dùng

Tải dữ liệu khách hàng đã thu thập lên để tạo đối tượng So khớp khách hàng. Đây là dữ liệu nhạy cảm. Bạn phải chuẩn bị đúng cách trước khi tải lên.

Định dạng dữ liệu

Định dạng dữ liệu thô bằng cách làm như sau:

  • Xoá mọi khoảng trắng khỏi các giá trị tên, họ và địa chỉ email.
  • Đặt tất cả giá trị chuỗi ở chế độ chữ thường.
  • Định dạng giá trị số điện thoại bằng định dạng E.164. Nhập cả mã quốc gia.

Băm dữ liệu

Băm các giá trị dữ liệu thô thuộc các loại sau bằng thuật toán SHA256:

  • Tên
  • Họ
  • Địa chỉ email
  • Số điện thoại

Chỉ định dữ liệu

Dữ liệu mà bạn đang sử dụng sẽ xác định loại đối tượng. Phương thức này cũng xác định đối tượng API dùng để truyền dữ liệu.

Thông tin liên hệ

Nếu bạn đang sử dụng thông tin liên hệ để so khớp người dùng:

  • Sử dụng loại đối tượng CUSTOMER_MATCH_CONTACT_INFO.
  • Truyền dữ liệu trong đối tượng ContactInfo.

Lựa chọn về dữ liệu được cung cấp cho một khách hàng sẽ xác định phương thức được dùng để so khớp họ:

Phương thức so khớp
Đối sánh địa chỉ email Bạn phải chỉ định ít nhất một giá trị cho trường hashedEmails.
So khớp số điện thoại Bạn phải chỉ định ít nhất một giá trị cho trường hashedPhoneNumbers.
So khớp địa chỉ gửi thư Giá trị được chỉ định cho các trường hashedFirstName, hashedLastName, zipCodescountryCode.
Kết hợp so khớp địa chỉ email, địa chỉ gửi thư và số điện thoại Các giá trị được chỉ định cho các trường hashedEmails, hashedPhoneNumbers, hashedFirstName, hashedLastName, zipCodescountryCode.

Đưa tất cả các đối tượng ContactInfo cho một lần tải lên duy nhất vào một đối tượng ContactInfoList.

Mã thiết bị di động

Nếu bạn đang sử dụng mã thiết bị di động để so khớp người dùng:

  • Sử dụng loại đối tượng CUSTOMER_MATCH_DEVICE_ID.
  • Truyền dữ liệu bằng chuỗi mã thiết bị di động.

Đưa tất cả mã nhận dạng thiết bị di động cho một lần tải lên vào một đối tượng MobileDeviceIdList.

Đặt trường consent trong đối tượng dữ liệu có liên quan để truyền tín hiệu về sự đồng ý mà người dùng đã đưa ra.

Việc đặt một trong hai trường trong đối tượng Consent thành CONSENT_STATUS_DENIED sẽ trả về lỗi.

Tín hiệu về sự đồng ý áp dụng cho tất cả người dùng trong một yêu cầu. Sử dụng các yêu cầu riêng biệt để tải người dùng lên bằng các tín hiệu đồng ý khác nhau.