Tải thành viên lên đối tượng

Tải thành viên lên đối tượng So khớp khách hàng bằng cách gửi một IngestAudienceMembersRequest.

Để định cấu hình và gửi yêu cầu, hãy hoàn tất các bước sau:

1. Đặt trường termsOfService thành thông báo TermsOfService có customerMatchTermsOfServiceStatus được đặt thành ACCEPTED để xác nhận rằng operatingAccount đã chấp nhận Điều khoản dịch vụ của tính năng So khớp khách hàng.

2. Trên mỗi AudienceMember trong danh sách audienceMembers, hãy đặt trường dữ liệu dựa trên loại dữ liệu mà tệp tải lên chứa:

   • Nếu tệp tải lên chứa thông tin liên hệ, hãy đặt trường compositeData thành đối tượng CompositeData và đặt trường userData thành đối tượng UserData. Thêm một mục riêng biệt trong danh sách userIdentifiers cho mỗi giá trị nhận dạng của thành viên trong phân khúc đối tượng.

     Mặc dù userData vẫn được hỗ trợ, nhưng bạn nên sử dụng compositeData để đảm bảo quá trình tích hợp của bạn sẵn sàng cho những điểm cải tiến trong tương lai. Hãy xem phần Dữ liệu tổng hợp để biết thông tin chi tiết.

   • Nếu tệp tải lên chứa Mobile ID, hãy đặt trường mobileData thành thông báo MobileData. Thêm một mục riêng biệt trong danh sách mobileIds cho mỗi Mobile ID của thành viên trong phân khúc đối tượng.

3. Gửi dữ liệu So khớp khách hàng theo các bước trong phần Gửi thành viên trong phân khúc đối tượng.

Thành viên mẫu trong đối tượng

Các ví dụ sau đây cho thấy cách tạo cấu trúc cho đối tượng AudienceMember cho từng loại dữ liệu thành viên. Mỗi AudienceMember trong một yêu cầu phải có cùng một loại dữ liệu mã nhận dạng được đặt (compositeData, mobileData):

Thông tin liên hệ

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    }
  }
}

Mobile ID

{
  "mobileData": {
    "mobileIds": [
      "123e4567-e89b-12d3-a456-426614174000"
    ]
  }
}