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 mengetahui ringkasan semua jenis iklan yang didukung oleh Google Ads, lihat panduan API.

Catatan: Iklan Display responsif kini mendukung beberapa aset teks, gambar, dan video dalam iklan yang sama. Iklan Display responsif lama tidak mendukung fitur baru ini. Iklan baru dan lama akan terus ditayangkan seperti biasa, tetapi API untuk mengambil dan memanipulasi iklan Display responsif telah berubah. Lihat Menangani Iklan Display Responsif Lama.

Alat

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

Cuplikan berikut menunjukkan cara membuat iklan penelusuran responsif:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

Inspeksi

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

Untuk mengakses kolom yang khusus untuk jenis iklan, seperti judul iklan penelusuran responsif, gunakan metode asType() untuk membuat AdViewSpace. Tindakan ini memberikan akses ke versi yang diperluas dari Ad yang mengekspos metode khusus jenis.

Cuplikan berikut mendapatkan judul setiap iklan penelusuran responsif:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

Perhatikan bahwa kondisi Type = RESPONSIVE_SEARCH_AD memastikan setiap iklan dari iterator adalah iklan penelusuran responsif. Mencoba melihat iklan dengan jenis yang salah akan menghasilkan error yang menghentikan eksekusi skrip Anda. 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 Ad.isType() metode:

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

Meskipun Anda tidak dapat memfilter iklan berdasarkan teks judul menggunakan pemilih standar, Anda dapat memfilternya di JavaScript setelah mengambilnya:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

Pelaporan

Tampilan ad_group_ad dapat digunakan untuk membuat kueri kolom iklan selain statistik reguler. Misalnya, Anda dapat memfilter menurut jenis iklan menggunakan ad_group_ad.ad.type. Cuplikan berikut menunjukkan cara mengambil statistik untuk semua iklan penelusuran responsif:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

Memfilter menurut konten aset

Untuk memfilter iklan penelusuran responsif menurut konten judul atau deskripsinya dalam skala besar, gunakan ad_group_ad_asset_view resource. Tampilan ini memperlakukan setiap judul dan deskripsi sebagai baris terpisah, sehingga Anda dapat memfilter teks aset.

Cuplikan berikut mengambil statistik untuk semua iklan penelusuran responsif yang berisi judul tertentu:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

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