Melacak penempatan dan performa iklan

Google Ads API menawarkan beberapa tampilan untuk menganalisis tempat iklan Anda muncul dan performanya: managed_placement_view, group_placement_view, detail_placement_view, dan performance_max_placement_view. Setiap tampilan memberikan perspektif yang berbeda tentang data penempatan Anda. Untuk kueri Google Ads Query Language (GAQL) dan curl siap pakai yang mereplikasi layar penempatan di UI Google Ads, lihat Query cookbook.

Tampilan penempatan terkelola

  • Yang ditampilkan: Resource managed_placement_view menyediakan data performa yang digabungkan berdasarkan kriteria penempatan positif yang Anda targetkan di grup iklan. Tampilan ini mencakup kelima jenis kriteria yang dikelola di bagian Content > Placements di UI Google Ads: situs, channel YouTube, video YouTube, aplikasi seluler, dan kategori aplikasi seluler.
  • UI Equivalent: Content > Placements
  • Pembuat Kueri: Pelajari di Pembuat Kueri

Jenis kriteria penempatan yang ditarget

Setiap baris dalam resource managed_placement_view mengisi kolom AdGroupCriterion yang cocok dengan nilai ad_group_criterion.type-nya dan membiarkan kolom penempatan lainnya tidak ditetapkan:

Jenis penempatan UI Nilai ad_group_criterion.type Kolom detail kriteria Catatan
Situs PLACEMENT ad_group_criterion.placement.url URL situs atau domain target.
Channel YouTube YOUTUBE_CHANNEL ad_group_criterion.youtube_channel.channel_id ID channel YouTube. Kolom ad_group_criterion.display_name menampilkan nama channel.
Video YouTube YOUTUBE_VIDEO ad_group_criterion.youtube_video.video_id ID video YouTube. Kolom ad_group_criterion.display_name menampilkan judul video.
Aplikasi MOBILE_APPLICATION ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name ID aplikasi dalam format {platform}-{platform_native_id} (1- untuk iOS, 2- untuk Android) dan nama aplikasi.
Kategori aplikasi MOBILE_APP_CATEGORY ad_group_criterion.mobile_app_category.mobile_app_category_constant Nama resource dalam format mobileAppCategoryConstants/{mobile_app_category_id}. Lihat Nama dan hierarki kategori aplikasi seluler.

Contoh kueri

Untuk mengambil metrik performa di semua jenis penempatan yang ditarget selama 30 hari terakhir, pilih kolom ad_group_criterion.type bersama kolom khusus jenis:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Nama dan hierarki kategori aplikasi seluler

Di UI Google Ads, kategori aplikasi seluler yang ditargetkan menampilkan jalur app store lengkapnya, seperti App categories > Apple App Store > Education. Saat membuat kueri Google Ads API, perhatikan perilaku berikut:

  • Atribusi konstanta kategori aplikasi seluler: Resource mobile_app_category_constant bukan resource yang diatribusikan dari resource managed_placement_view. Pilih kolom ad_group_criterion.mobile_app_category.mobile_app_category_constant (misalnya, mobileAppCategoryConstants/60503), atau buat kueri resource ad_group_criterion jika Anda tidak memerlukan metrik.
  • Nama tampilan khusus leaf: Kolom ad_group_criterion.display_name dan mobile_app_category_constant.name hanya menampilkan nama kategori leaf, seperti "Education" atau "Games". Kedua kolom tidak menyertakan jalur app store induk.
  • Menyelesaikan jalur app store: Google Play dan Apple App Store menggunakan nama kategori leaf yang sama di berbagai ID kriteria yang berbeda. Misalnya, ID kriteria 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education), dan 60503 (/All Apps/Apple App Store/Education) semuanya menampilkan "Education" di kolom name dan display_name. Ekstrak akhiran {mobile_app_category_id} dari nama resource dan cari jalur hierarki lengkapnya di tabel atau file CSV kategori aplikasi seluler.

Tampilan penempatan grup

  • Yang ditampilkan: Resource group_placement_view menampilkan tempat iklan Anda benar-benar ditayangkan di Jaringan Display dan YouTube, terlepas dari apakah penempatan tersebut ditargetkan secara eksplisit atau ditemukan secara otomatis oleh sistem Google. Penempatan ini dapat mencakup situs, channel atau video YouTube, dan aplikasi.
  • UI Equivalent: Content > Where ads showed
  • Pembuat Kueri: Pelajari di Pembuat Kueri

Contoh kueri

Kueri berikut mengambil metrik performa untuk domain, aplikasi seluler, dan channel YouTube tempat iklan ditampilkan selama 30 hari terakhir:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

Baris "Total: Lainnya"

Untuk mempercepat pembuatan laporan, resource group_placement_view dan detail_placement_view mengecualikan penempatan individual yang tidak memenuhi nilai minimum aktivitas tayangan iklan atau interaksi.

  • Di UI Google Ads: UI menggabungkan penempatan yang tidak memenuhi nilai minimum aktivitas ini ke dalam baris ringkasan berlabel Total: Lainnya.
  • Di Google Ads API: API menghilangkan penempatan yang tidak memenuhi nilai minimum aktivitas dari hasil laporan dan tidak menampilkan baris ringkasan jika kolom group_placement_view.placement atau detail_placement_view.placement memiliki nilai "Other".

Akibatnya, jumlah baris penempatan individual di resource group_placement_view dan detail_placement_view mungkin lebih rendah daripada total metrik untuk grup iklan atau kampanye. Untuk informasi selengkapnya, lihat artikel Tentang laporan "Tempat iklan tampil". Untuk mengetahui detail tentang pengaruh nilai minimum dan metadata yang tidak ada terhadap perbandingan lintas-tampilan, lihat Perbedaan metrik antara tampilan penempatan dan Baris dengan detail penempatan yang tidak tersedia.

Setelan penargetan penempatan

Perilaku dan utilitas group_placement_view dipengaruhi oleh TargetingSetting untuk dimensi PLACEMENT di tingkat grup iklan. Setelan ini berisi daftar target_restrictions, masing-masing dengan kolom boolean bid_only yang menentukan apakah iklan Anda hanya ditampilkan di penempatan yang ditargetkan atau di penempatan lain juga. Lihat artikel Tentang setelan "Penargetan" dan "Pengamatan".

  • bid_only = false: Nilai ini sesuai dengan Penargetan di UI Google Ads untuk penempatan. Jika grup iklan Anda ditetapkan ke "Penargetan", iklan Anda hanya akan ditampilkan di penempatan yang telah Anda tambahkan secara eksplisit sebagai kriteria. Anda dapat memilih untuk menerapkan penyesuaian bid ke penempatan ini. Dalam skenario ini, group_placement_view sebagian besar mencerminkan managed_placement_view, tetapi masih tunduk pada nilai minimum aktivitas.
  • bid_only = true: Nilai ini sesuai dengan Pengamatan di UI Google Ads untuk penempatan. Jika grup iklan Anda ditetapkan ke "Pengamatan", iklan Anda dapat ditampilkan di penempatan yang memenuhi syarat di Jaringan Display dan YouTube. Anda juga dapat menerapkan penyesuaian bid ke penempatan yang telah Anda targetkan. Dalam hal ini, group_placement_view sangat penting untuk menemukan penempatan baru tempat iklan Anda ditampilkan, yang kemudian dapat Anda pilih untuk ditambahkan sebagai penempatan terkelola atau pengecualian.

Tampilan penempatan detail

  • Yang ditampilkan: Resource detail_placement_view memberikan perincian penempatan yang lebih mendetail, yang menawarkan detail di luar tingkat domain atau channel. Misalnya, laporan ini dapat menampilkan URL atau ID video YouTube tertentu tempat iklan Anda muncul.
  • UI Equivalent: Setara dengan memilih baris di Content > Where ads showed, lalu mengklik View details.
  • Pembuat Kueri: Pelajari di Pembuat Kueri
  • Pertimbangan Penting: Serupa dengan resource group_placement_view, tampilan ini menghilangkan penempatan dengan aktivitas rendah yang tidak memenuhi nilai minimum aktivitas (lihat bagian baris "Total: Lainnya").

Contoh kueri

Untuk membatasi volume hasil, kueri berikut mengambil metrik penempatan tingkat URL dan tingkat video selama periode 7 hari. Untuk akun besar, filter lebih lanjut berdasarkan kolom campaign.id atau ad_group.id:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

Untuk mengecualikan baris yang metadata penempatannya tidak tersedia, tambahkan AND detail_placement_view.target_url IS NOT NULL (lihat Baris dengan detail penempatan yang tidak tersedia). Jika Anda tidak memerlukan kolom resource_name yang ditampilkan, tambahkan klausa PARAMETERS omit_unselected_resource_names = true.

Perbedaan metrik antara tampilan penempatan

Nilai minimum aktivitas dievaluasi secara independen di setiap tingkat perincian:

  • Resource group_placement_view mengevaluasi nilai minimum di seluruh domain, aplikasi seluler, atau channel YouTube gabungan.
  • Referensi detail_placement_view mengevaluasi nilai minimum secara terpisah untuk setiap URL halaman atau video YouTube.

Resource detail_placement_view menghilangkan URL halaman individual atau video YouTube yang tidak memenuhi nilai minimum. Akibatnya, menjumlahkan baris detail_placement_view untuk domain atau channel YouTube (difilter menurut kolom detail_placement_view.group_placement_target_url) dapat menampilkan tayangan iklan yang lebih sedikit daripada baris group_placement_view yang sesuai.

Baris dengan detail penempatan yang tidak tersedia

Kueri terhadap resource group_placement_view atau detail_placement_view dapat menampilkan beberapa baris dalam grup iklan yang sama dengan kolom placement, display_name, dan target_url yang tidak ditetapkan serta nilai resource_name yang identik (misalnya, diakhiri dengan ~MTRf).

Perilaku ini terjadi karena alasan berikut:

  • Pengelompokan penempatan internal: Kedua tampilan mengelompokkan metrik performa berdasarkan ID penempatan internal yang unik, bukan berdasarkan kolom string resource_name atau placement.
  • Metadata penempatan tidak tersedia: Di UI Google Ads, penempatan tanpa metadata dalam tabel pencarian backend akan muncul sebagai Tidak diketahui, Channel tidak lagi tersedia, atau Video tidak lagi tersedia. Di API, setiap ID penempatan yang berbeda masih menampilkan baris metrik, dengan kolom placement, display_name, dan target_url tidak ditetapkan.
  • Nama resource yang disintesis: Akhiran {base64_placement} di kolom resource_name dienkode Base64 dari {type_id}_{placement}, dengan {type_id} adalah ID jenis penempatan internal, bukan nomor enum PlacementType. Jika kolom placement_type adalah WEBSITE (ID internal 14) dan kolom placement tidak ditetapkan, string "14_" akan dienkode ke MTRf (demikian pula, MOBILE_APPLICATION mengenkode "55_" ke NTVf, YOUTUBE_VIDEO mengenkode "89_" ke ODlf, dan YOUTUBE_CHANNEL mengenkode "90_" ke OTBf). Oleh karena itu, beberapa penempatan dari jenis yang sama dengan metadata yang tidak tersedia di grup iklan yang sama akan memiliki nilai resource_name yang sama saat melaporkan baris metrik yang terpisah.

Saat memproses hasil group_placement_view atau detail_placement_view dalam kode klien, jangan menghapus duplikat baris hanya berdasarkan kolom resource_name, karena tindakan ini dapat menimpa metrik di berbagai penempatan yang berbeda dengan metadata yang tidak tersedia. Untuk mengecualikan baris dengan metadata yang tidak tersedia di GAQL, filter kolom target_url atau display_name, karena kolom placement dan resource_name tidak dapat difilter. Misalnya, gunakan WHERE group_placement_view.target_url IS NOT NULL atau WHERE detail_placement_view.target_url IS NOT NULL.

Tampilan penempatan Performa Maksimal

  • Yang ditampilkan: Resource performance_max_placement_view menyediakan data tayangan iklan (metrics.impressions) untuk penempatan tempat iklan Performa Maksimal ditayangkan. Di v24 dan yang lebih baru, Anda dapat menyegmentasikan performance_max_placement_view menurut segments.ad_network_type (tidak didukung di v23).
  • UI Equivalent: Insights and reports > Report editor > Performance Max campaigns placement
  • Pembuat Kueri: Pelajari di Pembuat Kueri

Contoh kueri

Kueri berikut mengambil tayangan iklan penempatan yang disegmentasikan menurut jenis jaringan iklan untuk kampanye Performa Maksimal selama 30 hari terakhir:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

Memilih tampilan penempatan

  • Gunakan managed_placement_view untuk menilai performa penempatan yang Anda targetkan dan bid secara aktif.
  • Gunakan group_placement_view untuk memahami cakupan penuh tempat iklan Anda muncul, terutama saat menggunakan setelan "Pengamatan", untuk menemukan peluang penargetan atau pengecualian baru.
  • Gunakan detail_placement_view untuk mendapatkan detail paling terperinci tentang URL atau video tertentu tempat iklan Anda ditampilkan, yang sering digunakan setelah mengidentifikasi domain atau channel yang diminati di group_placement_view.
  • Gunakan performance_max_placement_view untuk memeriksa tayangan iklan penempatan untuk kampanye Performa Maksimal.