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.

içerik üretimi

Komut dosyaları, AdGroup örneklerinde newAd() yöntemini kullanarak reklam oluşturabilir. Bu, AdBuilderSpace geliştiriciler oluşturan desteklenen reklam türleri.

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, Ad; örneğin, kimliğini ve onay durumunu kontrol edin. 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, iteratördeki 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 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ü şunlar da olabilir: Genel istatistiklere ek olarak, türe özel reklam alanlarını sorgulamak için kullanılır: ad_group_ad.expanded_text_ad.headline_part1. 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;
  ...
}

Aşağıdakiler için raporlar rehberine bakın: komut dosyalarında raporlama hakkında daha fazla bilgi edinin.