Mengupload anggota ke audiens

Upload anggota ke audiens Customer Match dengan mengirimkan IngestAudienceMembersRequest.

Untuk mengonfigurasi dan mengirimkan 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 berisi 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 bagi anggota audiens. Untuk data alamat IP, tambahkan IpDataentri dalam ipData daftar untuk setiap alamat IP bagi 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 ID seluler, 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 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 kumpulan data ID yang sama (compositeData, mobileData, atau 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"
  }
}