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ụ về 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 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 vào danh sách mobileIds cho từng mã nhận dạng thiết bị di động 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 bằng cách làm 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 duy nhất phải có cùng một loại tập dữ liệu mã nhận dạng (compositeData, mobileData):

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

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