Reklam Türleri

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 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ı 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.

Bir reklamın türüne özgü alanlara (ör. duyarlı arama ağı reklamının başlıkları) erişmek için asType() yöntemini kullanarak AdViewSpace oluşturun. Bu, türe özgü yöntemleri ortaya çıkaran 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 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ı standart seçicileri kullanarak başlık metnine göre filtreleyemezsiniz ancak 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 istatistiklerin yanı sıra reklam alanlarını sorgulamak için de 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 büyük ölçekte filtrelemek için ad_group_ad_asset_view kaynağını kullanın. Bu görünümde her başlık ve açıklama ayrı bir satır olarak ele alınır. Bu sayede, öğenin metnine göre filtreleme yapabilirsiniz.

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 Raporlar Kılavuzu'na bakın.