Panduan ini memetakan konsep dan ketentuan penamaan untuk laporan di UI Google Ads ke laporan yang dapat Anda buat menggunakan Google Ads Query Language (GAQL) dan Google Ads API.
Istilah UI umum
Tabel berikut merangkum beberapa istilah umum yang digunakan di UI dan pemetaannya ke Google Ads Query Language (GAQL).
| UI | GAQL |
|---|---|
| Kolom | Setiap resource, kolom segmen, atau metrik dalam klausa SELECT kueri GAQL. |
| Rentang Tanggal | Rentang tanggal dipetakan ke klausa WHERE
yang memfilter segments.date. |
| Filter | Satu atau beberapa kondisi dalam klausa WHERE. |
| Kolom segmen | Terapkan segmentasi dengan menyertakan kolom segmen dalam kueri GAQL. |
| Penomoran halaman | Penomoran halaman membagi kumpulan hasil dari kueri menjadi beberapa halaman. |
Kolom
Kolom di UI setara dengan Kolom resource, Kolom segmen, dan Metrik di GAQL.
Pemfilteran
Anda dapat memfilter dan mengatur data dalam laporan.
Rentang tanggal
UI Google Ads memiliki tabel yang menampilkan statistik akun, dan menu drop-down untuk mengontrol rentang tanggal statistik ini.
Anda memiliki kontrol yang sama di GAQL dengan memfilter
segments.date di klausa WHERE kueri GAQL.
Filter
Filter di UI setara dengan satu atau beberapa kondisi dalam klausa WHERE GAQL.
Segmentasi
Untuk statistik yang lebih mendetail, pisahkan data menurut segmen. Misalnya, Anda ingin melihat jumlah tayangan khusus untuk Jaringan Penelusuran Google secara terpisah dari Jaringan Display Google. Dalam hal ini, segmentasikan laporan Anda menurut jaringan. Lihat Segmentasi untuk mengetahui cara menyertakan kolom segmen dalam klausa SELECT.
Penomoran halaman
Navigasi laporan Anda di UI menggunakan kontrol yang tersedia di bagian bawah setiap tabel data yang memungkinkan Anda beralih halaman dan memilih jumlah hasil yang akan ditampilkan dari kumpulan ukuran yang ditentukan.
Penomoran halaman hasil tersedia saat mengambil laporan dengan
GoogleAdsService.Search melalui
next_page_token. Untuk mengambil seluruh kumpulan hasil
tanpa penomoran halaman, gunakan
GoogleAdsService.SearchStream.
Urutkan hasil
Di UI, Anda dapat mengurutkan hasil dengan memilih kolom.
Di GAQL, Anda dapat menggunakan klausa ORDER BY dan klausa LIMIT untuk mengurutkan hasil kueri.
Format download
Di UI, laporan dapat didownload dalam berbagai format, seperti CSV, TSV, atau XML.
API tidak secara langsung mendukung format yang berbeda dalam outputnya, sehingga Anda harus melakukan beberapa pasca-pemrosesan. Lihat contoh kode ini yang menunjukkan cara menerapkan pemformatan CSV di klien.
Menjadwalkan dan mengirim laporan melalui email
Anda dapat menjadwalkan dan mengirim laporan melalui email dari UI, tetapi fitur ini tidak didukung di API.
Laporan standar
Anda dapat membuat daftar laporan standar di UI Google Ads.
Berikut daftar laporan standar dasar dan Nama Resource GAQL yang cocok.
| Laporan Standar Dasar | Nama Resource GAQL (Tentukan dalam klausa FROM) |
|---|---|
| Akun | customer |
| Kampanye, Detail kampanye |
campaign |
| Grup iklan, Detail grup iklan |
ad_group |
|
Iklan, URL Final |
ad_group_ad |
| Kata kunci penelusuran | keyword_view |
| Istilah penelusuran | search_term_view |
| Berbayar dan organik | paid_organic_search_term_view |
| Halaman landing | landing_page_view |
| Halaman landing yang diperluas | expanded_landing_page_view |
| Konten > Penempatan | managed_placement_view |
| Konten > Tempat iklan ditampilkan | group_placement_view |
| Konten > Tempat iklan ditampilkan > Lihat detail | detail_placement_view |
Sebagai contoh dari tabel sebelumnya, Anda dapat menggunakan GAQL berikut untuk membuat laporan Akun:
SELECT
customer.descriptive_name,
customer.id,
metrics.clicks,
metrics.impressions,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros,
metrics.absolute_top_impression_percentage,
metrics.top_impression_percentage,
metrics.average_cpm
FROM customer
WHERE segments.date DURING LAST_7_DAYS
Perbedaan umum
Saat membandingkan laporan UI dengan laporan API, salah satu perbedaan yang paling umum adalah UI secara implisit memfilter entitas yang dihapus, sedangkan API tidak.
Untuk mereplikasi tampilan UI default, Anda harus menambahkan filter, biasanya menggunakan kolom status, untuk mengecualikan baris yang dihapus. Contoh:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"