Pelaporan

Laporan memberikan informasi tentang berbagai sumber daya di akun Anda. Anda dapat mengambil informasi tentang kampanye, grup iklan, dan statistiknya, serta untuk akun Anda, dan banyak lagi. Infrastruktur pelaporan didukung oleh Google Ads API dan menggunakan GAQL untuk menentukan {i>field<i}, metrik, dan kondisi apa yang ingin Anda tetapkan.

Laporan vs. penelusuran

Ada dua mekanisme utama untuk pelaporan. Keduanya menerima jenis yang berbeda, terutama dalam cara mereka 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 penelusuran Anda yang datar seperti kamus hasil pengujian tersebut. Anda dapat mengakses kolom seolah-olah menggunakan kamus, seperti row["campaign.id"] dan row["metrics.impressions"] secara langsung. Dengan menggunakan format teks, Anda dapat mengekspor hasilnya langsung ke {i>spreadsheet<i} menggunakan Metode exportToSheet(). Hasil ini bukan format native ditampilkan oleh Google Ads API, sehingga dalam beberapa kasus beberapa kolom mungkin tidak tersedia dalam format ini. Jika demikian, sebaiknya gunakan search.

AdsApp.search()

Tindakan ini akan menampilkan daftar objek GoogleAdsRow, yang memiliki berbagai kolom, yang masing-masing mungkin memiliki sub-isian. Jadi, Anda akan mengakses row.campaign.id dan row.metrics.impressions untuk mengambil data. Ini umumnya lebih berguna jika Anda berencana untuk memproses data secara terprogram, dan beberapa {i>field<i} mungkin hanya tersedia dalam format search jika tidak dapat dikonversi menjadi datar merepresentasinya.

Catatan: Saat menggunakan AdsApp.search, kolom yang ditampilkan akan berada dalam lowerCamelCase meskipun ditetapkan dalam underscore_case dalam kueri. Misalnya, jika kolom Anda dalam kueri adalah campaign.start_date, 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 AdsApp.report untuk detail selengkapnya tentang cara menggunakan 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 selengkapnya Adsapp.search dokumentasi untuk semua pengaturan yang memungkinkan.