UI Google Ads menyediakan kemampuan pelaporan. Untuk membuat laporan, login ke akun Google Ads, klik Kampanye di menu navigasi 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 Google Ads Query Language (GAQL) dan Google Ads API. Anda juga dapat mengikuti perintah di UI untuk membuat laporan yang paling sesuai dengan persyaratan Anda.
Alat dan referensi
Untuk mengetahui 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 dalam UI Google Ads.
Istilah UI umum
Tabel berikut merangkum beberapa istilah umum yang digunakan di UI dan pemetaannya ke Google Ads Query Language (GAQL).
| UI | GAQL |
|---|---|
| Kolom | Resource, kolom segmen, atau metrik apa pun dalam klausa SELECT
dari 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 halaman membagi 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 mengetahui 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 di klausa WHERE dari kueri
GAQL.
Filter
Filter di UI setara dengan satu atau beberapa kondisi dalam
klausa WHERE GAQL.
Untuk mengetahui 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. Dalam hal ini, 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 serangkaian 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.
Mengurutkan hasil
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 secara 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 ditampilkan > Lihat detail | detail_placement_view |
| Audiens > Demografi > Usia | age_range_view |
| Audiens > Demografi > Gender | gender_view |
| Lokasi | location_view |
| Konten > Topik | topic_view |
| Lokasi > Laporan geografis | 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 bahwa 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 entitas ENABLED dan PAUSED). Contoh:
SELECT campaign.name
FROM campaign
WHERE campaign.status != 'REMOVED'