Membuat audiens Customer Match

Buat audiens Customer Match dengan mengirimkan CreateUserListRequest.

Membuat 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, setelan 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 buffering protokol, gunakan metode praktis untuk membuat objek Duration berdasarkan jumlah hari, jika metode praktis tersebut ada. 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 dari 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, 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 ditetapkan ke nilai yang sesuai dari enum DataSourceType.

Daftar Mobile ID

Tetapkan kolom berikut jika Anda ingin menggunakan Mobile ID 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:

Daftar ID pengguna

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

uploadKeyTypes

Tetapkan ke daftar yang berisi jenis kunci upload USER_ID.

Daftar uploadKeyTypes hanya boleh berisi satu entri.

Membuat permintaan

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

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

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

Mobile ID

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 seperti login-account atau linked-account.

Jika permintaan berhasil, respons akan berisi UserList yang dibuat dengan kolom id dan name khusus output yang diisi.

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