Reklam Türleri

Google Ads; metin, resim ve mobil reklamlar gibi çeşitli reklam türlerini destekler. Bu kılavuzda, Google Ads komut dosyalarını kullanarak reklamların nasıl oluşturulacağı, alınacağı ve raporlanacağı açıklanmaktadır. Google Ads tarafından desteklenen tüm reklam türlerine genel bakış için API kılavuzuna bakın.

yönetme bölümünü inceleyin.

içerik üretimi

Komut dosyaları, AdGroup örneklerinde newAd() yöntemini kullanarak reklam oluşturabilir. Bu komut, desteklenen reklam türleri için geliştiriciler oluşturan bir AdBuilderSpace döndürür.

Aşağıdaki snippet'te, genişletilmiş metin reklamın nasıl oluşturulacağı gösterilmektedir:

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 (ör. reklamın kimliği ve onay durumu) Ad üzerinden hemen kullanılabilir. Ayrıca, herhangi bir reklam duraklatılabilir, etkinleştirilebilir veya kaldırılabilir.

Bir reklamın türüne özgü alanlara (ör. genişletilmiş metin reklamın açıklaması) erişmek için AdViewSpace oluşturmak üzere asType() yöntemini kullanın. Bu, Ad türünün türüne özgü yöntemlerini gösteren 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, yineleyicideki her reklamın genişletilmiş metin reklam olmasını sağladığına dikkat edin. Yanlış türde bir reklamı görüntülemeye çalışmak, komut dosyanızın yürütülmesini durduran bir hatayla sonuçlanır. Bu nedenle, türe özgü alanları yalnızca reklamın türü bilindiğinde görüntülemek önemlidir.

Aşağıdaki snippet'te, Ad.isType() yöntemi kullanılarak bir reklamın doğru türde olup olmadığının nasıl belirleneceği 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ü, ad_group_ad.expanded_text_ad.headline_part1 gibi normal istatistiklerin yanı sıra türüne özel reklam alanlarını sorgulamak için de kullanılabilir. Aşağıdaki snippet'te, 1. başlıkta "İ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 raporlar kılavuzuna bakın.