Laporan di UI Google Ads

UI Google Ads menyediakan kemampuan pelaporan. Untuk membuat laporan, login ke akun Google Ads, klik Kampanye di menu navigasi sebelah kiri, lalu klik Insight dan laporan. Untuk membuat laporan dari awal, klik Editor laporan.

Panduan ini memetakan konsep pelaporan dan konvensi penamaan umum di UI Google Ads ke laporan yang dapat Anda buat menggunakan Bahasa Kueri Google Ads (GAQL) dan Google Ads API. Anda juga dapat mengikuti petunjuk di UI untuk membuat laporan yang paling sesuai dengan kebutuhan Anda.

Alat dan referensi

Untuk contoh yang lebih mendetail dan bantuan otomatis dalam memetakan layar UI ke API, lihat referensi berikut:

• Query Cookbook: Kumpulan kueri GAQL yang mereplikasi data yang ditemukan di banyak layar UI Google Ads umum.
• Ekstensi Pelaporan Google Ads API: Ekstensi Chrome yang membantu Anda mengidentifikasi nama kolom dan resource API langsung di dalam UI Google Ads.

Istilah UI umum

Tabel berikut merangkum beberapa istilah umum yang digunakan di UI dan pemetaannya ke Bahasa Kueri Google Ads (GAQL).

UI	GAQL
Kolom	Resource, kolom segmen, atau metrik apa pun 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	Paging memecah kumpulan hasil kueri menjadi beberapa halaman.

Kolom

Kolom di UI setara dengan penggunaan klausa SELECT untuk Kolom resource, Kolom segmen, atau Metrik di GAQL.

Untuk informasi selengkapnya, lihat Tentang kolom di tabel statistik.

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.

Untuk informasi selengkapnya, lihat Memfilter tampilan data performa.

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. Jika demikian, segmentasikan laporan Anda menurut jaringan. Lihat Segmentasi untuk mempelajari 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 kumpulan ukuran yang ditentukan.

Untuk menelusuri hasil saat mengambil laporan, gunakan GoogleAdsService.Search dengan next_page_token. Untuk mengambil seluruh set hasil tanpa penomoran halaman, gunakan GoogleAdsService.SearchStream.

Hasil pesanan

Di UI, Anda dapat mengurutkan hasil dengan memilih kolom.

Di GAQL, Anda dapat menggunakan klausa ORDER BY dan klausa LIMIT untuk mengurutkan dan membatasi hasil kueri.

Format download

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

API tidak langsung memformat output ke dalam file seperti CSV, sehingga aplikasi klien Anda harus memformat respons. Lihat contoh kode Laporan kampanye ke CSV untuk mempelajari 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.

Memetakan tampilan UI ke resource API

Berikut adalah daftar tampilan UI umum dan Nama Resource GAQL yang cocok.

Tampilan UI	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 (Template visibilitas kompetitif)^*	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 tampil > Lihat detail	detail_placement_view
Audiens > Demografi > Usia	age_range_view
Audiens > Demografi > Gender	gender_view
Lokasi	location_view
Konten > Topik	topic_view
Locations > Geographic report	geographic_view

^* Untuk membuat laporan Berbayar dan organik, Anda harus menautkan akun Google Search Console ke akun Google Ads di tingkat pelanggan.

Sebagai contoh dari tabel sebelumnya, Anda dapat menggunakan kueri GAQL berikut untuk membuat laporan Akun gabungan selama 7 hari terakhir (tambahkan segments.date ke klausa SELECT jika Anda ingin metrik dikelompokkan menurut hari):

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, tambahkan filter menggunakan kolom status untuk mengecualikan baris yang dihapus (atau secara eksplisit menyertakan entity ENABLED dan PAUSED). Contoh:

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