Di Google Ads API, setiap laporan kriteria diwakili oleh resource terpisah.
Kecuali jika diperlukan, resource *_view hanya berisi kolom resource_name.
Klien Google Ads API harus menentukan kolom ad_group_criterion atau campaign_criterion yang sesuai jika ada data spesifik per kriteria yang perlu diambil.
Setiap tampilan bergabung ke resource kriteria yang cocok dengan tingkat penargetannya (misalnya, keyword_view bergabung ke ad_group_criterion, sedangkan location_view bergabung ke campaign_criterion). Hal ini memungkinkan klien Google Ads API meminta kolom ad_group_criterion atau campaign_criterion dan resource *_view dalam permintaan yang sama ke metode GoogleAdsService.SearchStream.
Contoh permintaan kueri
SELECT
ad_group_criterion.keyword.text,
ad_group.name,
campaign.name,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS
Untuk mengambil data performa (metrik) untuk jenis kriteria tertentu, tentukan
resource tampilan yang sesuai dalam klausa FROM. Misalnya, gunakan
keyword_view dalam klausa FROM dan kolom metrics dalam klausa SELECT
untuk mengambil metrik kata kunci.
Anda dapat memilih kolom dari resource induk hingga customer dari tampilan kriteria. Misalnya, saat memilih FROM keyword_view, Anda dapat
meminta kolom dari semua resource berikut:
ad_group_criterionad_groupcampaigncustomer
Untuk menemukan resource yang dapat diminta dengan cara ini untuk resource tertentu, periksa baris Resource yang diatribusikan di halaman referensinya. Misalnya, untuk keyword_view, Anda dapat menemukan referensinya di
halaman referensi.
Memetakan ke UI
Setiap laporan kriteria sesuai dengan tampilan tertentu di UI Google Ads. Memetakan hal ini dapat membantu Anda mencocokkan data API dengan apa yang Anda lihat di antarmuka. Untuk daftar pemetaan yang lebih besar, lihat Laporan di UI.
Berikut adalah beberapa laporan berbasis kriteria umum dan lokasi UI umumnya:
- Kampanye > Audiens, kata kunci, dan konten > Kata kunci penelusuran: Menampilkan
data yang setara dengan
keyword_view. - Kampanye > Audiens, kata kunci, dan konten > Audiens > Demografi:
Menampilkan data yang setara dengan
age_range_viewdangender_view. - Kampanye > Lokasi: Menampilkan data yang setara dengan
location_view.