Panduan Developer Audiens Pemasaran Ulang

Dokumen ini menjelaskan cara menggunakan Management API untuk mengelola audiens pemasaran ulang Google Analytics.

Catatan: Saat menggunakan API ini, Anda harus mematuhi Kebijakan Fitur Iklan Google Analytics, termasuk aturan seputar kategori sensitif.

Pengantar

Management API memungkinkan Anda create, get, delete, list, update dan patch audiens pemasaran ulang untuk properti Google Analytics. Untuk mempelajari lebih lanjut cara kerja audiens pemasaran ulang, lihat artikel pusat bantuan Tentang Audiens Pemasaran Ulang di Analytics.

Kasus penggunaan

Resource Audiens Pemasaran Ulang mendukung get, delete, list, patch, dan update, tetapi kasus penggunaan utamanya adalah:

• Cantumkan audiens pemasaran ulang.
• Buat audiens pemasaran ulang baru.
• Memperbarui audiens pemasaran ulang yang ada.

Catatan: Audiens pemasaran ulang Anda akan tetap kosong dan kampanye pemasaran ulang mungkin tidak berjalan jika tag tidak diaktifkan untuk mengumpulkan data yang sesuai. Mulai dengan mengaktifkan Fitur Iklan dalam Setelan Properti Google Analytics Anda.

Membuat daftar audiens pemasaran ulang

Untuk mencantumkan semua audiens pemasaran ulang untuk properti:

1. Gunakan Management API atau Account Explorer untuk mengambil accountId dan webPropertyId.
2. Jalankan metode list dari resource Audiens Pemasaran Ulang.

Lihat referensi API untuk mengetahui detail metode list bagi resource audiens pemasaran ulang.

Membuat audiens pemasaran ulang baru

Untuk membuat audiens pemasaran ulang baru untuk properti:

1. Gunakan Management API atau Account Explorer untuk mengambil accountId dan webPropertyId.
2. Gunakan Management API atau Account Explorer untuk mengambil ID tampilan (profil) untuk properti linkedViews [].
3. Gunakan koleksi Google Ads Links untuk mengambil ID akun Google Ads untuk linkedAdAccounts.linkedAccountId.
   • Properti linkedAdAccounts[] saat ini terbatas hanya untuk satu linkedForeignAccount.
   • linkedAdAccounts[].type dapat ditetapkan ke ADWORDS_LINKS, DBM_LINKS, MCC_LINKS, atau OPTIMIZE.
4. Gunakan koleksi Segmen untuk opsi guna menyetel properti segment dari includeConditions, dan jika membuat audiens berbasis status lakukan hal yang sama untuk excludeConditions. Lihat juga referensi segmen untuk menentukan segmen.
   • includeConditions secara opsional dapat memiliki nilai untuk membershipDurationDays dan daysToLookBack
   • excludeConditions.exclusionDuration (opsional) dapat disetel ke PERMANENT.
5. Jalankan metode insert dari resource Audiens Pemasaran Ulang.

API ini memungkinkan Anda membuat dua jenis audiens: SIMPLE dan STATE_BASED. Untuk audiens SIMPLE, Anda hanya perlu membuat audienceDefinition dengan segment positif, tanpa operator NOT (karakter !). Jika ingin menyertakan kondisi pengecualian, Anda harus menentukan statebasedDefinition; lihat Audiens Berbasis Status untuk mempelajari lebih lanjut. Lihat contoh referensi untuk mengetahui detailnya.

Catatan: Anda dapat menentukan audienceDefinition atau stateBasedAudienceDefinition dan menetapkan audienceType ke nilai yang sesuai. Ada juga batas 2.000 audiens pemasaran ulang yang diizinkan. Hati-hati saat mengotomatiskan pembuatan audiens pemasaran ulang.

Memperbarui audiens pemasaran ulang yang ada

Untuk memperbarui audiens pemasaran ulang yang ada untuk properti:

1. Jika sudah memiliki ID Audiens Pemasaran Ulang, Anda dapat memanggil get. Jika tidak, Anda dapat memanggil list dan memilih audiens yang ingin diperbarui.
2. Perbarui salah satu kolom yang dapat ditulis dan panggil update yang meneruskan objek audiens yang diperbarui.

Catatan: Setelah audiens dibuat, Anda tidak dapat mengubah audienceType-nya. Dengan kata lain, jika audience memiliki nilai untuk audienceDefinition, Anda tidak bisa memanggil update dengan nilai untuk stateBasedAudienceDefinition. Lihat Audiens Berbasis Status untuk mempelajari lebih lanjut. Lihat contoh referensi untuk mengetahui detailnya.