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_viewmenyediakan 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_constantbukan resource yang diatribusikan dari resourcemanaged_placement_view. Pilih kolomad_group_criterion.mobile_app_category.mobile_app_category_constant(misalnya,mobileAppCategoryConstants/60503), atau buat kueri resourcead_group_criterionjika Anda tidak memerlukan metrik. - Nama tampilan khusus leaf: Kolom
ad_group_criterion.display_namedanmobile_app_category_constant.namehanya 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), dan60503(/All Apps/Apple App Store/Education) semuanya menampilkan"Education"di kolomnamedandisplay_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_viewmenampilkan 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.placementataudetail_placement_view.placementmemiliki 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_viewsebagian besar mencerminkanmanaged_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_viewsangat 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_viewmemberikan 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_viewmengevaluasi nilai minimum di seluruh domain, aplikasi seluler, atau channel YouTube gabungan. - Referensi
detail_placement_viewmengevaluasi 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_nameatauplacement. - 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, dantarget_urltidak ditetapkan. - Nama resource yang disintesis: Akhiran
{base64_placement}di kolomresource_namedienkode Base64 dari{type_id}_{placement}, dengan{type_id}adalah ID jenis penempatan internal, bukan nomor enumPlacementType. Jika kolomplacement_typeadalahWEBSITE(ID internal14) dan kolomplacementtidak ditetapkan, string"14_"akan dienkode keMTRf(demikian pula,MOBILE_APPLICATIONmengenkode"55_"keNTVf,YOUTUBE_VIDEOmengenkode"89_"keODlf, danYOUTUBE_CHANNELmengenkode"90_"keOTBf). Oleh karena itu, beberapa penempatan dari jenis yang sama dengan metadata yang tidak tersedia di grup iklan yang sama akan memiliki nilairesource_nameyang 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_viewmenyediakan data tayangan iklan (metrics.impressions) untuk penempatan tempat iklan Performa Maksimal ditayangkan. Di v24 dan yang lebih baru, Anda dapat menyegmentasikanperformance_max_placement_viewmenurutsegments.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_viewuntuk menilai performa penempatan yang Anda targetkan dan bid secara aktif. - Gunakan
group_placement_viewuntuk memahami cakupan penuh tempat iklan Anda muncul, terutama saat menggunakan setelan "Pengamatan", untuk menemukan peluang penargetan atau pengecualian baru. - Gunakan
detail_placement_viewuntuk mendapatkan detail paling terperinci tentang URL atau video tertentu tempat iklan Anda ditampilkan, yang sering digunakan setelah mengidentifikasi domain atau channel yang diminati digroup_placement_view. - Gunakan
performance_max_placement_viewuntuk memeriksa tayangan iklan penempatan untuk kampanye Performa Maksimal.