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

Tải các 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à quá trình tải lên chứa:

   • Nếu quá trình 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 đối tượng CompositeData. Đối với thông tin liên hệ, hãy đặt trường userData thành đối tượng UserData và thêm một mục riêng trong danh sách userIdentifiers cho từng 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 IpData mục trong danh sáchipData cho từng đị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 được chuẩn bị cho các cải tiến trong tương lai. Xem bài viết Dữ liệu tổng hợp dữ liệu để biết thông tin chi tiết.

   • Nếu quá trình 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 trong danh sách mobileIds cho từng Mobile ID của thành viên trong phân khúc đối tượng.

   • Nếu quá trình 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 bằng các bước trong bài viết 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 cấu trúc đố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 tập dữ liệu mã nhận dạng (compositeData, mobileData hoặc userIdData):

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

{
  "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"
      }
    ]
  }
}

{
  "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"
      }
    ]
  }
}

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

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