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:

• Buat daftar 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 Anda tidak mengaktifkan tag untuk mengumpulkan data yang sesuai. Mulai dengan mengaktifkan Fitur Iklan di Setelan Properti Google Analytics.

Membuat daftar audiens pemasaran ulang

Untuk menampilkan daftar semua audiens pemasaran ulang untuk properti:

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

Lihat referensi API untuk mengetahui detail metode list untuk referensi 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 Penautan Google Ads guna mengambil ID akun Google Ads untuk linkedAdAccounts.linkedAccountId.
   • Properti linkedAdAccounts[] saat ini dibatasi hanya untuk satu linkedForeignAccount.
   • linkedAdAccounts[].type dapat disetel ke ADWORDS_LINKS, DBM_LINKS, MCC_LINKS, atau OPTIMIZE.
4. Gunakan kumpulan Segmen untuk opsi guna menetapkan properti segment dari includeConditions, dan jika membuat audiens berbasis status, lakukan hal yang sama untuk excludeConditions. Lihat juga referensi segmen untuk menentukan segmen.
   • includeConditions dapat memiliki nilai untuk membershipDurationDays dan daysToLookBack secara opsional
   • excludeConditions.exclusionDuration dapat ditetapkan ke PERMANENT secara opsional.
5. Jalankan metode insert pada referensi 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. Selain itu,ada batas 2.000 audiens pemasaran ulang yang diizinkan. Berhati-hatilah 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, atau 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 audiens memiliki nilai untuk audienceDefinition, Anda tidak dapat memanggil update dengan nilai untuk stateBasedAudienceDefinition. Lihat Audiens Berbasis Status untuk mempelajari lebih lanjut. Lihat contoh referensi untuk mengetahui detailnya.