Membuat dan mengelola audiens

Audience adalah kumpulan segmen terfokus, penargetan demografis, dan pengecualian yang dapat digunakan kembali. Penargetan audiens didukung untuk kampanye Performa Maksimal, Peningkat Permintaan, dan Aplikasi. Jika Anda ingin menargetkan segmen audiens secara langsung dalam kampanye Display, Penelusuran, Video, Hotel, atau Shopping Standar, lihat Segmen audiens.

Membuat audiens

Membuat dan memperbarui audiens menggunakan AudienceService. Setiap Audience harus memiliki nama yang unik. Audiens yang dapat digunakan kembali ini memungkinkan kombinasi beberapa dimensi audiens:

Periksa MutateAudienceResult untuk audience_id

Saat membuat audiens dengan AudienceService.MutateAudiences, setiap operasi menampilkan MutateAudienceResult. Anda dapat memeriksa MutateAudienceResult untuk mendapatkan audience_id dengan mengurai resource_name yang ditampilkan, dan Anda dapat memeriksa kolom yang dapat diubah (seperti name) pada objek audience yang ditampilkan saat response_content_type disetel ke MUTABLE_RESOURCE:

# Configure the request to return the mutable resource in the response.
request = googleads_client.get_type("MutateAudiencesRequest")
request.customer_id = customer_id
request.operations = [operation]
request.response_content_type = (
    googleads_client.enums.ResponseContentTypeEnum.MUTABLE_RESOURCE
)

response = audience_service.mutate_audiences(request=request)

for result in response.results:
    resource_name = result.resource_name
    # Format: customers/{customer_id}/audiences/{audience_id}
    audience_id = audience_service.parse_audience_path(resource_name)[
        "audience_id"
    ]
    print(f"Created audience '{resource_name}' with ID '{audience_id}'.")

    # Access mutable fields on result.audience when MUTABLE_RESOURCE is requested.
    if result.audience.resource_name:
        print(f"Audience name from mutable resource: {result.audience.name}")

Mengambil audiens

Seperti resource lainnya, Anda dapat menggunakan GoogleAdsService.SearchStream untuk mengambil atribut audiens.

SELECT
  audience.id,
  audience.resource_name,
  audience.name,
  audience.status,
  audience.description,
  audience.dimensions,
  audience.exclusion_dimension
FROM audience

Pemirsa target

Audiens dapat ditargetkan dengan berbagai cara, bergantung pada jenis kampanye.

Sinyal grup aset

Kampanye Performa Maksimal menggunakan AssetGroupSignal untuk menargetkan audiens. Lihat panduan Sinyal grup aset untuk mempelajari cara menargetkan audiens menggunakan sinyal grup aset.

Kriteria grup iklan

Kampanye Peningkat Permintaan dan Aplikasi mendukung penambahan kriteria grup iklan audiens menggunakan AdGroupCriterion untuk menargetkan audiens atau memberikan sinyal audiens. Anda dapat menargetkan audiens di tingkat grup iklan menggunakan kriteria AudienceInfo di AdGroupCriterion.audience dengan menetapkan kolom AudienceInfo.audience (ad_group_criterion.audience.audience) ke nama resource audiens.

Berikut adalah langkah-langkah untuk menyiapkan penargetan audiens:

Aktifkan penargetan audiens di AdGroup

Anda harus mengaktifkan penargetan audiens di AdGroup dengan menyetel use_audience_grouped ke true saat grup iklan dibuat. Setelan ini tidak dapat diubah setelah grup iklan dibuat.

Dengan begitu, Anda dapat menambahkan AdGroupCriterion dengan audiens. Jika nilai ini tidak ditetapkan ke true, permintaan berikutnya untuk menargetkan audiens akan gagal.

Membuat AdGroupCriterion

Buat AdGroupCriterion, dan tetapkan kolom AudienceInfo.audience di AdGroupCriterion.audience ke nama resource audiens yang dibuat di Buat audiens.

Opsional: Aktifkan penargetan audiens di Campaign

Anda dapat secara opsional menetapkan use_audience_grouped ke true saat kampanye dibuat. Dengan setelan ini, Anda akan menerima error jika mencoba menambahkan kriteria yang akan mengecualikan segmen dan demografi di tingkat kampanye.

Praktik terbaik

  • Gunakan audiens untuk membuat persona. Audiens paling baik digunakan di kampanye Performa Maksimal, Peningkat Permintaan, dan Aplikasi jika Anda ingin menggabungkan beberapa segmen dan kriteria demografi untuk menargetkan persona tertentu.
  • Gunakan segmen audiens untuk penargetan langsung. Untuk kampanye Display, Penelusuran, Video, Hotel, dan Shopping Standar, atau saat Anda hanya perlu menargetkan satu segmen (seperti daftar pemasaran ulang), gunakan Segmen audiens, bukan Audiens.

Error yang biasa terjadi

Saat membuat atau mengupdate Audience, Google Ads API akan memvalidasi permintaan dan menampilkan error dari enum AudienceError jika validasi gagal.

AudienceError
AUDIENCE_SEGMENT_NOT_FOUND
Ringkasan Segmen audiens dalam permintaan tidak ditemukan.
Penyebab umum Merujuk ke ID segmen yang tidak ada atau tidak dapat diakses.
Cara menangani Pastikan semua ID segmen ada dan dapat diakses sebelum membuat atau memperbarui audiens.
Tips pencegahan Validasi ID segmen sebelum menyertakannya dalam audiens.
DIMENSION_INVALID
Ringkasan Dimensi audiens tidak valid.
Penyebab umum Termasuk detailed_demographic di exclusion_dimension.
Cara menangani Hanya gunakan user_list untuk pengecualian di exclusion_dimension.
Tips pencegahan Pastikan hanya user_list yang digunakan di exclusion_dimension saat membuat atau memperbarui audiens.
DUPLICATE_AUDIENCE_SEGMENT
Ringkasan Audiens berisi segmen duplikat.
Penyebab umum Menambahkan segmen yang sama beberapa kali ke audiens yang sama.
Cara menangani Hapus segmen duplikat dari definisi audiens.
Tips pencegahan Pastikan semua segmen dalam audiens bersifat unik.
NAME_ALREADY_IN_USE
Ringkasan Nama audiens sudah digunakan.
Penyebab umum Mencoba membuat beberapa audiens dengan nama yang sama.
Cara menangani Gunakan nama unik saat membuat audiens.
Tips pencegahan Periksa nama audiens yang ada sebelum membuat yang baru.
TOO_MANY_DIMENSIONS_OF_SAME_TYPE
Ringkasan Audiens berisi terlalu banyak dimensi dengan jenis yang sama.
Penyebab umum Menyertakan beberapa dimensi dari jenis yang sama (misalnya, beberapa dimensi usia) dalam satu audiens.
Cara menangani Pastikan definisi audiens hanya berisi satu dimensi dari setiap jenis.
Tips pencegahan Tinjau definisi audiens untuk memastikan tidak ada jenis dimensi duplikat yang disertakan.
TOO_MANY_SEGMENTS
Ringkasan Audiens berisi terlalu banyak segmen.
Penyebab umum Melebihi jumlah maksimum segmen yang diizinkan dalam audiens.
Cara menangani Kurangi jumlah segmen dalam definisi audiens.
Tips pencegahan Lihat dokumentasi untuk mengetahui batas jumlah segmen per audiens.