Pelaporan

Laporan memberikan informasi tentang berbagai sumber daya yang berbeda 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 ditetapkan.

Laporan vs. penelusuran

Ada dua mekanisme utama untuk pelaporan. Keduanya menerima jenis kueri yang sama, dan perbedaan utamanya terletak pada cara keduanya 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 rata 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 hasilnya langsung ke spreadsheet menggunakan metode exportToSheet(). Ini bukan format native yang hasilnya ditampilkan oleh Google Ads API, sehingga dalam beberapa kasus, beberapa kolom mungkin tidak tersedia dalam format ini. Jika demikian, sebaiknya gunakan search.

AdsApp.search()

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. Cara ini umumnya lebih berguna jika Anda berencana memproses data secara terprogram, dan beberapa kolom mungkin hanya tersedia dalam format search jika tidak dapat dikonversi menjadi representasi datar.

Catatan: Saat menggunakan AdsApp.search, kolom yang ditampilkan akan berada di lowerCamelCase meskipun kolom tersebut ditentukan di underscore_case di kueri. Misalnya, jika kolom Anda dalam kueri adalah campaign.start_date, maka untuk mengambil hasil dari baris, gunakan 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 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 Adsapp.search lengkap untuk semua setelan yang memungkinkan.