Google Ads, metin, resim ve mobil reklam gibi çeşitli reklam türlerini destekler. Bu kılavuzda, Google Ads komut dosyalarını kullanarak reklam oluşturma, alma ve reklamlarla ilgili rapor oluşturma konuları ele alınmaktadır. Google Ads tarafından desteklenen tüm reklam türlerine genel bir bakış için API kılavuzuna bakın.
içerik üretimi
Komut dosyaları, newAd()
yöntemini kullanarak AdGroup
örneklerinde reklam oluşturabilir. Bu, desteklenen reklam türleri için oluşturucular oluşturan bir AdBuilderSpace
döndürür.
Aşağıdaki snippet'te, genişletilmiş metin reklamın nasıl oluşturulacağı gösterilmektedir:
javascript
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();
İnceleme
Tüm reklam türleriyle ilişkili bazı bilgiler, Ad
üzerinden anında kullanılabilir. Örneğin, reklamın kimliği ve onay durumu. Ayrıca, herhangi bir reklam duraklatılabilir, etkinleştirilebilir veya kaldırılabilir.
Genişletilmiş metin reklamın açıklaması gibi bir reklamın türüne özgü alanlara erişmek için AdViewSpace
oluşturmak üzere asType()
yöntemini kullanın.
Bu, Ad
'ın türlere özel yöntemleri kullanıma sunan genişletilmiş bir sürümüne erişim sağlar.
Aşağıdaki snippet, her genişletilmiş metin reklamın açıklamasını alır:
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();
}
Type = EXPANDED_TEXT_AD
koşulunun, yineleyiciden gelen her reklamın genişletilmiş metin reklam olmasını sağladığını unutmayın. Yanlış türde bir reklamı görüntülemeye çalışmak, komut dosyanızın yürütülmesini durduran bir hataya neden olur. Bu nedenle, türle ilgili alanları yalnızca reklamın türü bilindiğinde görüntülemek önemlidir.
Aşağıdaki snippet'te, Ad.isType()
yöntemini kullanarak bir reklamın doğru türde olup olmadığını nasıl belirleyeceğiniz gösterilmektedir:
if (ad.isType().expandedTextAd()) {
let expandedTextAd = ad.asType().expandedTextAd();
let headlinePart1 = expandedTextAd.getHeadlinePart1();
let headlinePart2 = expandedTextAd.getHeadlinePart2();
}
Raporlama
ad_group_ad
görünümü, normal istatistiklerin yanı sıra ad_group_ad.expanded_text_ad.headline_part1
gibi türe özgü reklam alanlarını sorgulamak için de kullanılabilir.
Aşağıdaki snippet'te, başlık 1'de "İndirimli Satışlar" ifadesini içeren tüm genişletilmiş metin reklamların istatistiklerinin nasıl alınacağı gösterilmektedir:
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;
...
}
Komut dosyalarında raporlama hakkında daha fazla bilgi için Rapor kılavuzuna bakın.