Panduan Developer Audiens Pemasaran Ulang

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

Pengantar

Management API memungkinkan Anda create, get, delete, list, update, dan audiens pemasaran ulang patch 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 dapatkan, hapus, daftarkan, patch, dan pembaruan, tetapi kasus penggunaan utamanya adalah:

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 resource Audiens Pemasaran Ulang.

Lihat referensi API untuk mengetahui detail metode list bagi 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 hanya dibatasi untuk satu linkedForeignAccount.
    • linkedAdAccounts[].type dapat ditetapkan 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
    • Secara opsional, excludeConditions.exclusionDuration dapat ditetapkan 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.

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, lalu panggil update yang meneruskan objek audiens yang telah diperbarui.