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. Di setiap AudienceMember dalam daftar audienceMembers, tetapkan kolom data berdasarkan jenis data yang dimuat dalam upload:

   • Jika upload berisi informasi kontak, tetapkan kolom compositeData ke objek CompositeData, dan tetapkan kolom userData ke objek UserData. Tambahkan entri terpisah dalam daftar userIdentifiers untuk setiap ID anggota audiens.

     Meskipun userData masih didukung, sebaiknya gunakan compositeData untuk memastikan integrasi Anda siap menghadapi peningkatan kualitas pada 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.

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):

Informasi kontak

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

Mobile ID

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