Membuat audiens Customer Match

Buat audiens Customer Match dengan mengirim CreateUserListRequest.

Membuat isi permintaan

Buat UserList resource. Berikut kolom umum yang perlu ditetapkan.

displayName

Wajib Nama tampilan daftar. Nama harus unik di antara semua daftar yang dimiliki oleh akun.

description

Deskripsi singkat daftar.

integrationCode

ID dari sistem Anda.

membershipDuration

Durasi anggota audiens tetap berada dalam daftar setelah ditambahkan. Nilai harus sesuai dengan hari penuh. Jika tidak ditetapkan, nilai defaultnya adalah nilai maksimum.

Jika menggunakan JSON, hitung jumlah detik dengan mengalikan hari durasi dengan 86400 (jumlah detik per hari). Kemudian, tetapkan nilai ke hasil perkalian, diikuti dengan s. Misalnya, jika Anda menginginkan durasi keanggotaan 90 hari, gunakan nilai 7776000s karena 90 * 86400 = 7776000.

Jika menggunakan format buffer protokol, gunakan metode praktis untuk membuat objek Duration berdasarkan jumlah hari, jika metode praktis tersebut ada. Misalnya, library protobuf-java-util untuk Java memiliki fromDays() metode praktis. Jika tidak, hitung jumlah detik dengan mengalikan hari durasi dengan 86400 (jumlah detik per hari), dan gunakan hasilnya untuk menetapkan kolom seconds dari objek Duration.

Kolom yang diperlukan untuk Customer Match

Kolom ingestedUserListInfo diperlukan untuk audiens Customer Match.

Berikut kolom yang perlu ditetapkan di IngestedUserListInfo berdasarkan jenis data yang ingin Anda gunakan untuk menambahkan anggota audiens ke daftar.

Daftar informasi kontak

Tetapkan kolom berikut jika Anda ingin menggunakan informasi kontak (alamat email, nomor telepon, atau alamat yang di-hash) untuk menentukan anggota audiens:

uploadKeyTypes

Tetapkan ke daftar yang berisi jenis kunci upload CONTACT_ID.

Daftar uploadKeyTypes hanya boleh berisi satu entri.

contactIdInfo

Tetapkan ke pesan ContactIdInfo dengan dataSourceType yang ditetapkan ke nilai yang sesuai dari enum DataSourceType.

Daftar ID seluler

Tetapkan kolom berikut jika Anda ingin menggunakan ID seluler untuk menentukan anggota audiens:

uploadKeyTypes

Tetapkan ke daftar yang berisi jenis kunci upload MOBILE_ID.

Daftar uploadKeyTypes hanya boleh berisi satu entri.

mobileIdInfo

Tetapkan ke pesan:MobileIdInfo

• Tetapkan dataSourceType ke nilai yang sesuai dari DataSourceType enum.

• Tetapkan keySpace ke IOS atau ANDROID.

• Tetapkan appId ke string yang secara unik mengidentifikasi aplikasi seluler tempat data dikumpulkan.

  • Untuk iOS, string ID-nya adalah string berisi 9 digit yang terdapat di akhir URL App Store. Misalnya, 476943146 untuk aplikasi "Flood-It!" dengan link App Store https://apps.apple.com/us/app/flood-it/id476943146.

  • Untuk Android, string ID-nya adalah nama paket aplikasi. Misalnya, com.labpixies.flood untuk aplikasi "Flood-It!" dengan link Google Play https://play.google.com/store/apps/details?id=com.labpixies.flood.

Membuat permintaan

Untuk membuat audiens Customer Match, buat create permintaan untuk resource UserList.

1. Tetapkan kolom parent ke nama resource akun. Nama resource harus mengikuti format accountTypes/{accountType}/accounts/{account_id}.

2. Gunakan UserList yang Anda buat untuk isi permintaan.

3. Jika kredensial Anda bukan untuk Akun Google yang merupakan pengguna di parent, tetapkan header seperti yang dijelaskan dalam Mengonfigurasi tujuan dan header.

Berikut contoh permintaan dalam JSON untuk berbagai jenis informasi pengguna. Setiap permintaan menetapkan membershipDuration ke 2592000s, dengan 2592000 adalah jumlah detik dalam 30 hari. Klik tombol Buka di API Explorer untuk mencoba permintaan.

{
    "description": "Customer Match for contact info",
    "displayName": "Contact info audience",
    "ingestedUserListInfo": {
        "contactIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "CONTACT_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

{
    "description": "Customer Match for mobile IDs",
    "displayName": "Mobile ID audience",
    "ingestedUserListInfo": {
        "mobileIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY",
            "keySpace": "ANDROID",
            "appId": "com.labpixies.flood"
        },
        "uploadKeyTypes": [
            "MOBILE_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Mengirim permintaan

Kirim permintaan dan, jika diperlukan, sertakan header permintaan.

Jika permintaan berhasil, respons akan berisi yang dibuat UserList dengan id dan name diisi. Catat nilai di kolom ini karena Anda akan memerlukannya dalam permintaan untuk menambahkan anggota audiens ke audiens.

Jika permintaan gagal, periksa error untuk menentukan penyebab kegagalan, perbarui permintaan dan header untuk memperbaiki masalah, lalu kirim permintaan dan header yang diperbarui.