Jenis Iklan

Google Ads mendukung berbagai jenis iklan, seperti iklan teks, gambar, dan seluler. Panduan ini membahas cara membuat, mengambil, dan melaporkan iklan menggunakan skrip Google Ads. Untuk ringkasan tentang semua jenis iklan yang didukung oleh Google Ads, lihat panduan API.

yang Dipicu oleh Tren

Skrip dapat membuat iklan menggunakan metode newAd() pada instance AdGroup. Tindakan ini akan menampilkan AdBuilderSpace yang membuat builder untuk jenis iklan yang didukung.

Cuplikan berikut menunjukkan cara membuat iklan teks diperpanjang:

let adOperation = adGroup.newAd().expandedTextAdBuilder()
    .withHeadlinePart1("First headline part")
    .withHeadlinePart2("Second headline part")
    .withDescription("Ad description")
    .withFinalUrl("http://www.example.com")
    .withPath1("path1") // optional
    .withPath2("path2") // optional
    .build();

Inspeksi

Beberapa informasi yang terkait dengan semua jenis iklan akan langsung tersedia dari Ad, seperti ID iklan dan status persetujuan. Selain itu, iklan dapat dijeda, diaktifkan, atau dihapus.

Untuk mengakses kolom khusus jenis iklan, seperti deskripsi iklan teks diperpanjang, gunakan metode asType() untuk membuat AdViewSpace. Hal ini memberikan akses ke versi Ad yang diperluas yang mengekspos metode khusus jenis.

Cuplikan berikut mendapatkan deskripsi mengenai setiap iklan teks diperpanjang:

const iterator = AdsApp.ads().withCondition("Type = EXPANDED_TEXT_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let expandedTextAd = ad.asType().expandedTextAd();
  let description = expandedTextAd.getDescription();
}

Perhatikan bahwa kondisi Type = EXPANDED_TEXT_AD memastikan setiap iklan dari iterator adalah iklan teks diperpanjang. Mencoba melihat iklan dengan jenis yang salah akan mengakibatkan error yang menghentikan eksekusi skrip. Oleh karena itu, penting untuk melihat kolom khusus jenis hanya jika jenis iklan diketahui.

Cuplikan berikut menunjukkan cara menentukan apakah iklan memiliki jenis yang benar menggunakan metode Ad.isType():

if (ad.isType().expandedTextAd()) {
  let expandedTextAd = ad.asType().expandedTextAd();
  let headlinePart1 = expandedTextAd.getHeadlinePart1();
  let headlinePart2 = expandedTextAd.getHeadlinePart2();
}

Pelaporan

Tampilan ad_group_ad juga dapat digunakan untuk membuat kueri kolom iklan khusus jenis selain statistik reguler, seperti ad_group_ad.expanded_text_ad.headline_part1. Cuplikan berikut menunjukkan cara mengambil statistik untuk semua iklan teks diperpanjang yang berisi "Diskon Diskon" di judul 1:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
         "ad_group_ad.id, " +
         "ad_group_ad.expanded_text_ad.headline_part1, " +
         "ad_group_ad.expanded_text_ad.headline_part2, " +
         "metrics.clicks, " +
         "metrics.impressions, " +
         "metrics.cost" +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.expanded_text_ad.headline_part1 = 'Discount Sales' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let headlinePart1 = row.adGroupAd.expandedTextAd.headlinePart1;
  let headlinePart2 = row.adGroupAd.expandedTextAd.headlinePart2;
  ...
}

Lihat panduan laporan untuk mengetahui informasi selengkapnya tentang pelaporan dalam skrip.