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 reklam oluşturma, alma ve raporlama işlemleri 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 işlev, desteklenen reklam türleri için oluşturucular oluşturan bir AdBuilderSpace döndürür.

Aşağıdaki snippet'te duyarlı arama ağı reklamının nasıl oluşturulacağı gösterilmektedir:

let adOperation = adGroup.newAd().responsiveSearchAdBuilder()
    .withHeadlines(["Headline 1", "Headline 2", "Headline 3"])
    .withDescriptions(["Description 1", "Description 2"])
    .withFinalUrl("http://www.example.com")
    .withPath1("path1")
    .withPath2("path2")
    .build();

İnceleme

Tüm reklam türleriyle ilişkili bazı bilgilere (ör. reklam kimliği ve onay durumu) Ad üzerinden hemen erişilebilir. Ayrıca, herhangi bir reklamı duraklatabilir, etkinleştirebilir veya kaldırabilirsiniz.

Duyarlı arama ağı reklamının başlıkları gibi bir reklam türüne özgü alanlara erişmek için asType() yöntemini kullanarak bir AdViewSpace oluşturun. Bu, türe özgü yöntemleri gösteren Ad'nin genişletilmiş bir sürümüne erişim sağlar.

Aşağıdaki snippet, her duyarlı arama ağı reklamının başlıklarını alır:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
}

Type = RESPONSIVE_SEARCH_AD koşulunun, yineleyiciden gelen her reklamın duyarlı arama ağı 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üre özgü alanları yalnızca bir 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ın nasıl belirleneceği gösterilmektedir:

if (ad.isType().responsiveSearchAd()) {
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  let descriptions = responsiveSearchAd.getDescriptions();
}

Reklamları başlık metnine göre filtrelemek için standart seçicileri kullanamazsınız ancak reklamları aldıktan sonra JavaScript'te filtreleyebilirsiniz:

const iterator = AdsApp.ads().withCondition("Type = RESPONSIVE_SEARCH_AD").get();
while (iterator.hasNext()) {
  let ad = iterator.next();
  let responsiveSearchAd = ad.asType().responsiveSearchAd();
  let headlines = responsiveSearchAd.getHeadlines();
  // Filter for ads containing a specific headline.
  if (headlines.some(h => h.getText().includes("Special Offer"))) {
    console.log(`Found ad with ID ${ad.getId()}`);
  }
}

Raporlama

ad_group_ad görünümü, normal istatistiklere ek olarak reklam alanlarını sorgulamak için kullanılabilir. Örneğin, ad_group_ad.ad.type kullanarak reklam türüne göre filtreleme yapabilirsiniz. Aşağıdaki snippet'te, tüm duyarlı arama ağı reklamlarının istatistiklerinin nasıl alınacağı gösterilmektedir:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad_group.id, " +
          "ad_group_ad.ad.id, " +
          "metrics.clicks, " +
          "metrics.impressions, " +
          "metrics.cost " +
  "FROM ad_group_ad " +
  "WHERE ad_group_ad.ad.type = 'RESPONSIVE_SEARCH_AD' " +
    "AND segments.date DURING LAST_7_DAYS");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let clicks = row.metrics.clicks;
  ...
}

Öğe içeriğine göre filtreleme

Duyarlı arama ağı reklamlarını başlıklarının veya açıklamalarının içeriğine göre geniş ölçekte filtrelemek için ad_group_ad_asset_view kaynağını kullanın. Bu görünüm, her başlığı ve açıklamayı ayrı bir satır olarak ele alır ve öğenin metnine göre filtreleme yapmanıza olanak tanır.

Aşağıdaki snippet, belirli bir başlığı içeren tüm duyarlı arama ağı reklamlarının istatistiklerini alır:

const results = AdsApp.search(
  "SELECT ad_group_ad.ad.id, " +
          "asset.text_asset.text, " +
          "metrics.clicks, " +
          "metrics.impressions " +
  "FROM ad_group_ad_asset_view " +
  "WHERE asset.text_asset.text LIKE '%Special Offer%' " +
    "AND ad_group_ad_asset_view.field_type = 'HEADLINE'");

while (results.hasNext()) {
  let row = results.next();
  let adId = row.adGroupAd.ad.id;
  let text = row.asset.textAsset.text;
  let clicks = row.metrics.clicks;
  console.log(`Ad ID ${adId} with headline "${text}" had ${clicks} clicks.`);
}

Komut dosyalarında raporlama hakkında daha fazla bilgi için Rapor kılavuzu'na bakın.