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
newAd()
aktif
AdGroup
instance Compute Engine. Ini akan mengembalikan
AdBuilderSpace
yang membuat bangunan 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 langsung tersedia dari
Ad
, seperti
ID dan status persetujuan iklan. Selain itu, semua iklan dapat dijeda, diaktifkan, atau
dihapus.
Untuk mengakses kolom khusus jenis iklan, seperti deskripsi iklan teks
diperluas, gunakan
metode
asType()
untuk membuat
AdViewSpace
.
Hal ini memberikan akses ke versi
Ad
yang diperluas yang mengekspos
metode khusus jenis.
Cuplikan berikut mendapatkan deskripsi untuk 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 yang diperluas. Mencoba melihat iklan dengan jenis yang salah akan menghasilkan error yang menghentikan eksekusi skrip Anda, jadi 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 mengajukan kueri kolom iklan dengan jenis tertentu selain statistik reguler,
ad_group_ad.expanded_text_ad.headline_part1
Cuplikan berikut menunjukkan cara mengambil statistik untuk semua iklan teks diperpanjang
yang berisi "Penjualan Diskon" pada 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.