Panduan ini memetakan konsep dan konvensi penamaan untuk laporan di UI Google Ads ke laporan yang dapat Anda buat menggunakan Bahasa Kueri Google Ads (GAQL) dan Google Ads API.
Istilah UI umum
Tabel berikut merangkum beberapa istilah umum yang digunakan dalam UI dan pemetaan ke Bahasa Kueri Google Ads (GAQL).
| UI | GAQL |
|---|---|
| Kolom | Semua resource, kolom segmen, atau metrik di klausa SELECT kueri GAQL. |
| Rentang Tanggal | Rentang tanggal dipetakan ke WHERE
yang sama pada segments.date. |
| Filter | Satu atau beberapa kondisi dalam klausa WHERE. |
| Kolom segmen | Menerapkan segmentasi dengan menyertakan kolom segmen dalam kueri GAQL Anda. |
| Penomoran halaman | Paging membagi kumpulan hasil dari kueri menjadi beberapa halaman. |
Kolom
Kolom di UI setara dengan Resource kolom, Segmen kolom, dan Metrik dalam GAQL.
Pemfilteran
Rentang tanggal
UI Google Ads memiliki tabel yang menampilkan statistik akun, dan menu drop-down untuk mengontrol rentang tanggal statistik tersebut.
Anda memiliki kontrol yang sama di GAQL dengan memfilter
segments.date di klausa WHERE pada GAQL
kueri.
Filter
Filter di UI setara dengan satu atau beberapa kondisi pada kolom WHERE GAQL.
Segmentasi
Untuk statistik yang lebih detail, Anda dapat memisahkan data menurut segmen. Misalnya, Anda mungkin tertarik untuk melihat jumlah tayangan yang spesifik untuk Jaringan Penelusuran Google terpisah dari Jaringan Display Google. Dalam kasus ini, Anda akan menyegmentasikan laporan menurut jaringan. Lihat Segmentasi tentang cara menyertakan kolom segmen dalam klausa SELECT.
Penomoran halaman
Anda menjelajahi laporan di UI menggunakan kontrol yang tersedia di di bagian bawah setiap tabel data yang dapat digunakan untuk berpindah halaman dan memilih jumlah hasil yang ditampilkan dari kumpulan ukuran yang ditentukan.
Hasil Paging melalui tersedia saat mengambil laporan dengan
GoogleAdsService.Search sampai
next_page_token. Untuk mengambil seluruh kumpulan hasil
tanpa penomoran halaman, gunakan
GoogleAdsService.SearchStream
Hasil pesanan
Di UI, Anda dapat mengurutkan hasil dengan memilih kolom.
Di GAQL, Anda dapat menggunakan fungsi ORDER BY klausa dan LIMIT klausa untuk mengurutkan hasil kueri Anda.
Download format
Di UI, laporan dapat didownload dalam berbagai format, seperti CSV, TSV, atau XML.
API ini tidak secara langsung mendukung format yang berbeda dalam outputnya, jadi Anda akan perlu melakukan beberapa proses pasca-pemrosesan. Lihat contoh kode yang menunjukkan cara menerapkan pemformatan CSV dalam klien.
Menjadwalkan dan mengirim laporan melalui email
Penjadwalan dan pengiriman laporan melalui email tersedia di UI, tetapi tidak didukung di API.
Laporan Standar
Anda dapat membuat daftar laporan standar di UI Google Ads.
Berikut ini daftar laporan standar dasar dan Aset GAQL yang cocok {i>Name<i}.
| 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 |
Sebagai contoh dari tabel di atas, 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 perlu menambahkan filter, biasanya
menggunakan kolom status, untuk mengecualikan baris yang dihapus, misalnya:
SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"