Laporan di UI

Panduan ini memetakan konsep dan konvensi 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 pemetaan untuk Google Ads Query Language (GAQL).

UI	GAQL
Kolom	Semua resource, kolom segmen, atau metrik dalam klausa SELECT kueri GAQL.
Rentang Tanggal	Rentang tanggal dipetakan ke pemfilteran klausa WHERE di segments.date.
Filter	Satu atau beberapa kondisi dalam klausa WHERE.
Kolom segmen	Terapkan segmentasi dengan menyertakan kolom segmen dalam kueri GAQL Anda.
Penomoran halaman	Penomoran halaman membagi kumpulan hasil kueri menjadi beberapa halaman.

Kolom

Kolom di UI setara dengan Kolom resource, Kolom segmen, dan Metrik di GAQL.

Pemfilteran

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 dalam klausa WHERE kueri GAQL.

Filter

Filter di UI setara dengan satu atau beberapa kondisi dalam klausa WHERE GAQL.

Segmentasi

Untuk statistik yang lebih mendetail, Anda dapat memisahkan data menurut segmen. Misalnya, Anda mungkin tertarik untuk melihat jumlah tayangan iklan khusus untuk Jaringan Penelusuran Google secara terpisah dari Jaringan Display Google. Dalam hal ini, Anda akan menyegmentasikan laporan menurut jaringan. Lihat Segmentasi tentang cara menyertakan kolom segmen dalam klausa SELECT.

Penomoran halaman

Anda dapat menjelajahi laporan 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.

Pembagian halaman hasil tersedia saat mengambil laporan dengan GoogleAdsService.Search hingga next_page_token. Untuk mengambil seluruh kumpulan hasil tanpa penomoran halaman, gunakan GoogleAdsService.SearchStream.

Mengurutkan 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 langsung mendukung berbagai format dalam output-nya, sehingga Anda harus melakukan beberapa pasca-pemrosesan. Lihat contoh kode yang menunjukkan cara menerapkan pemformatan CSV di klien.

Menjadwalkan dan mengirim laporan melalui email

Penjadwalan dan pengiriman email laporan tersedia di UI, tetapi tidak didukung di API.

Laporan Standar

Anda dapat membuat daftar laporan standar di UI Google Ads.

Berikut adalah daftar laporan dasar yang telah ditentukan sebelumnya 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

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"