Pelaporan

Laporan memberikan informasi tentang 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 perbedaan utamanya terletak pada cara menampilkan hasilnya.

Untuk kedua kasus tersebut, 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 data hasil penelusuran Anda yang datar dan mirip kamus. 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 native 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.

AdsApp.search()

Tindakan ini akan menampilkan daftar objek GoogleAdsRow, yang memiliki berbagai kolom, yang masing-masing 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 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 selengkapnya 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 Adsapp.search lengkap untuk mengetahui semua setelan yang mungkin.