Membuat audiens Customer Match

Buat audiens Customer Match dengan mengirimkan CreateUserListRequest.

Buat isi permintaan

Buat resource UserList. Berikut adalah 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, defaultnya adalah 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 sejak 90 * 86400 = 7776000.

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

Kolom wajib diisi untuk Customer Match

Kolom ingestedUserListInfo wajib diisi untuk audiens Customer Match.

Berikut adalah kolom yang harus 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 yang di-hash, nomor telepon, atau alamat) untuk menentukan anggota audiens:

uploadKeyTypes

Disetel 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

Disetel 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 enum DataSourceType.
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.

Daftar ID pengguna

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

uploadKeyTypes

Disetel ke daftar yang berisi jenis kunci upload USER_ID.

Daftar uploadKeyTypes hanya boleh berisi satu entri.

Buat permintaan

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

Tetapkan kolom parent ke nama resource akun. Nama resource harus mengikuti format accountTypes/{accountType}/accounts/{account_id}.
Gunakan UserList yang Anda buat untuk isi permintaan.
Jika kredensial Anda bukan untuk Akun Google yang merupakan pengguna di parent, tetapkan header seperti yang dijelaskan dalam Mengonfigurasi tujuan dan header.

Berikut adalah 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 Open in API Explorer untuk mencoba permintaan.

Informasi kontak

Buka di API Explorer

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

ID Seluler

Buka di API Explorer

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

ID pengguna

Buka di API Explorer

{
    "description": "Customer Match for user IDs",
    "displayName": "User ID audience",
    "ingestedUserListInfo": {
        "userIdInfo": {
            "dataSourceType": "DATA_SOURCE_TYPE_FIRST_PARTY"
        },
        "uploadKeyTypes": [
            "USER_ID"
        ]
    },
    "membershipDuration": "2592000s"
}

Kirim permintaan

Kirim permintaan dan, jika diperlukan, sertakan header permintaan.

Jika permintaan berhasil, respons akan berisi UserList yang dibuat dengan id dan name yang 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 telah diperbarui.

Sebelumnya

Ringkasan

Berikutnya

Mengupload anggota ke audiens