Laporan memberikan informasi tentang semua berbagai resource di akun Anda. Anda dapat mengambil informasi tentang kampanye, grup iklan, dan statistiknya, histori perubahan untuk akun Anda, dan lainnya. Infrastruktur pelaporan didukung oleh Google Ads API dan menggunakan GAQL untuk menentukan kolom, metrik, dan kondisi yang ingin Anda tetapkan.
Laporan vs. penelusuran
Ada dua mekanisme utama untuk pelaporan. Keduanya menerima jenis kueri yang sama, dan terutama berbeda dalam cara menampilkan hasilnya.
Untuk kedua kasus, kita akan menggunakan kueri berikut:
SELECT
campaign.id,
campaign.status,
metrics.clicks,
metrics.impressions,
customer.id
FROM campaign
WHERE
metrics.impressions > 0
AdsApp.report()
- Tindakan ini akan menampilkan representasi datar seperti kamus dari hasil penelusuran Anda. Anda dapat mengakses kolom seolah-olah menggunakan kamus, seperti
row["campaign.id"]
danrow["metrics.impressions"]
secara langsung. Dengan menggunakan format ini, Anda dapat mengekspor hasil langsung ke spreadsheet menggunakan metodeexportToSheet()
. Ini bukan format asli yang digunakan untuk menampilkan hasil oleh Google Ads API, sehingga dalam beberapa kasus, beberapa kolom mungkin tidak tersedia dalam format ini. Jika demikian, Anda harus menggunakansearch
sebagai gantinya. AdsApp.search()
- Tindakan ini akan menampilkan daftar objek
GoogleAdsRow
, yang memiliki berbagai kolom, dan setiap kolom dapat memiliki sub-kolom. Jadi, Anda akan mengaksesrow.campaign.id
danrow.metrics.impressions
untuk mengambil data. Hal ini umumnya lebih berguna jika Anda berencana memproses data secara terprogram, dan beberapa kolom mungkin hanya tersedia dalam formatsearch
jika tidak dapat dikonversi ke representasi datar.
Contoh Laporan
let report = AdsApp.report(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
let rows = report.rows();
while (rows.hasNext()) {
let row = rows.next();
let query = row["search_term_view.search_term"];
let impressions = row["metrics.impressions"];
}
Lihat dokumentasi
AdsApp.report
untuk mengetahui detail lengkap tentang penggunaan tampilan ini.
Contoh Penelusuran
let search = AdsApp.search(
"SELECT " +
" ad_group.id, search_term_view.search_term, metrics.ctr, metrics.cost_micros, metrics.impressions " +
"FROM search_term_view " +
"WHERE metrics.impressions < 10 AND segments.date DURING LAST_30_DAYS");
while (search.hasNext()) {
let row = search.next();
let query = row.searchTermView.searchTerm;
let impressions = row.metrics.impressions;
}
Lihat dokumentasi lengkap
Adsapp.search
untuk semua kemungkinan setelan.