Pelaporan

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"] dan row["metrics.impressions"] secara langsung. Dengan menggunakan format ini, Anda dapat mengekspor hasil langsung ke spreadsheet menggunakan metode exportToSheet(). 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 menggunakan search 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 mengakses row.campaign.id dan row.metrics.impressions untuk mengambil data. Hal ini umumnya lebih berguna jika Anda berencana memproses data secara terprogram, dan beberapa kolom mungkin hanya tersedia dalam format search jika tidak dapat dikonversi ke representasi datar.

Catatan: Saat menggunakan AdsApp.search, kolom yang ditampilkan akan berada di lowerCamelCase meskipun ditentukan di underscore_case dalam kueri. Misalnya, jika kolom Anda dalam kueri adalah campaign.start_date, maka untuk mengambil hasil dari baris, Anda akan menggunakan campaign.startDate.

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.