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.