Mengupload anggota ke audiens

Upload anggota ke audiens Customer Match dengan mengirimkan IngestAudienceMembersRequest.

Untuk mengonfigurasi dan mengirim permintaan, selesaikan langkah-langkah berikut:

1. Tetapkan kolom termsOfService ke pesan TermsOfService dengan customerMatchTermsOfServiceStatus ditetapkan ke ACCEPTED untuk mengonfirmasi bahwa operatingAccount menyetujui persyaratan layanan Customer Match.

2. Pada setiap AudienceMember dalam daftar audienceMembers, tetapkan kolom data berdasarkan jenis data yang dimuat dalam upload:

   • Jika upload berisi informasi kontak, data alamat IP, atau keduanya, tetapkan kolom compositeData ke objek CompositeData. Untuk informasi kontak, tetapkan kolom userData ke objek UserData dan tambahkan entri terpisah dalam daftar userIdentifiers untuk setiap ID anggota audiens. Untuk data alamat IP, tambahkan entri IpData dalam daftar ipData untuk setiap alamat IP anggota audiens.

     Meskipun userData masih didukung, sebaiknya gunakan compositeData untuk memastikan integrasi Anda siap untuk peningkatan di masa mendatang. Lihat Data gabungan untuk mengetahui detailnya.

   • Jika upload berisi Mobile ID, tetapkan kolom mobileData ke pesan MobileData. Tambahkan entri terpisah dalam daftar mobileIds untuk setiap Mobile ID bagi anggota audiens.

   • Jika upload berisi ID pengguna, tetapkan kolom userIdData ke pesan UserIdData, dan tetapkan kolom userId ke ID pengguna untuk anggota audiens.

3. Kirim data Customer Match menggunakan langkah-langkah di bagian Mengirim anggota audiens.

Contoh anggota audiens

Contoh berikut menunjukkan cara menyusun objek AudienceMember untuk setiap jenis data anggota. Setiap AudienceMember dalam satu permintaan harus memiliki jenis data ID yang sama yang ditetapkan (compositeData, mobileData, atau userIdData):

Informasi kontak

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

Data alamat 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"
      }
    ]
  }
}

Data kontak dan 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"
    ]
  }
}

ID pengguna

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