Reklam Türleri

Google Ads, metin, resim ve mobil reklamlar gibi çeşitli reklam türlerini destekler. Bu kılavuzda, Google Ads komut dosyaları kullanılarak reklam oluşturma, alma ve raporlama hakkında bilgiler verilmektedir. 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ı, 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, tüm reklamlar duraklatılabilir, etkinleştirilebilir veya kaldırılabilir.

Genişletilmiş metin reklamın açıklaması gibi reklam türüne özel alanlara erişmek için asType() yöntemini kullanarak AdViewSpace oluşturun. Bu, Ad'in türe özel yöntemleri 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, yineleyiciden gelen 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 hataya neden olur. Bu nedenle türe özgü alanları yalnızca bir reklamın türü bilindiğinde görüntülemek önemlidir.

Aşağıdaki snippet, Ad.isType() yöntemi kullanılarak bir reklamın doğru türde olup olmadığını nasıl belirleyeceğinizi gösterir:

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üre özel reklam alanlarını sorgulamak için de kullanılabilir. Aşağıdaki snippet, başlık 1'de "İndirimli Satışlar" ifadesini içeren tüm genişletilmiş metin reklamlar için istatistiklerin nasıl alınacağını gösterir:

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.