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 kriteria yang perlu diambil.
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 beberapa 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 Attribute Resources di halaman referensinya. Misalnya, untuk keyword_view, Anda dapat menemukan resource-nya 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.