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ệ, dữ liệu địa chỉ IP, hoặc cả hai, hãy đặt trường compositeData thành một đối tượng CompositeData. Đối với thông tin liên hệ, hãy đặt trường userData của thông tin đó thành đối tượng UserData và 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. Đối với dữ liệu địa chỉ IP, hãy thêm một mục nhập IpData vào danh sách ipData cho mỗi địa chỉ IP 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.

   • Nếu tệp tải lên chứa mã nhận dạng người dùng, hãy đặt trường userIdData thành thông báo UserIdData và đặt trường userId thành mã nhận dạng người dù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 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 hoặc userIdData):

Thông tin liên hệ

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

Dữ liệu địa chỉ IP

{
  "compositeData": {
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Thông tin liên hệ và dữ liệu IP

{
  "compositeData": {
    "userData": {
      "userIdentifiers": [
        {
          "emailAddress": "07e2f1394b0ea80e2adca010ea8318df697001a005ba7452720edda4b0ce57b3"
        },
        {
          "phoneNumber": "59d82f53a4fb9f3a3cd16e8b92bc41908db7a8bc3c90e292ef99fe19260292d1"
        }
      ]
    },
    "ipData": [
      {
        "ipAddress": "203.0.113.98",
        "observeStartTime": "2026-06-10T20:17:52.0-04:00",
        "observeEndTime": "2026-06-17T04:02:04.123-04:00"
      }
    ]
  }
}

Mobile ID

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

Mã nhận dạng người dùng

{
  "userIdData": {
    "userId": "user_987654321"
  }
}