Laporan di UI Google Ads

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 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 Anda.
Penomoran halaman Penomoran memecah kumpulan hasil 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 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, pisahkan data menurut segmen. Misalnya, Anda ingin melihat jumlah tayangan iklan khusus untuk Jaringan Penelusuran Google secara terpisah dari Jaringan Display Google. Dalam hal ini, segmentasikan laporan Anda menurut jaringan. Lihat Segmentasi tentang cara menyertakan kolom segmen dalam klausa SELECT.

Penomoran halaman

Jelajahi 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 serangkaian ukuran yang ditentukan.

Penomoran halaman hasil tersedia saat mengambil laporan dengan GoogleAdsService.Search hingga next_page_token. Untuk mengambil seluruh set 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 Anda.

Format download

Di UI, laporan dapat didownload dalam berbagai format, seperti CSV, TSV, atau XML.

API tidak secara langsung mendukung berbagai format dalam outputnya, jadi Anda harus melakukan beberapa pemrosesan pasca. 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 dasar standar 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 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 bahwa 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. Contoh:

SELECT campaign.name
FROM campaign
WHERE campaign.status != "REMOVED"