Reklam Medyası

Bazı reklam türleri, ör. ImageAd ve ResponsiveDisplayAd, Resim ve diğer medya öğelerini içerebilir. Bu kılavuzda, Google Ads komut dosyalarını kullanarak medyayı nasıl yükleyeceğiniz ve sorgulayacağınız açıklanmaktadır.

Görüntü yükleme

Resimler ImageBuilder sınıfını kullanır. Veriler, Drive veya URL getirme gibi hizmetler tarafından oluşturulabilen bir Blob veri değişimi nesnesi olarak sağlanır.

Aşağıdaki snippet'te harici bir URL'den nasıl resim yükleneceği gösterilmektedir:

let imageUrl = "http://www.example.com/example.png";
let imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Alternatif olarak, resim blobu Google Drive'dan yüklenebilir:

let imageFileId = "IMAGE_FILE_ID";
let imageBlob = DriveApp.getFileById(imageFileId).getBlob();
let mediaOperation = AdsApp.adMedia().newImageBuilder()
    .withName("IMAGE_NAME")
    .withData(imageBlob)
    .build();

Medya paketleri yükleme

Medya paketleri, HTML5 reklamlar oluşturmak için kullanılabilen HTML5 öğeleri içeren ZIP arşivleridir. Şu dosyayı içeren medya paketlerini yükleyin: MediaBundleBuilder sınıfını kullanır. Resimlerde olduğu gibi, veriler Blob veri değişim nesnesi.

Aşağıdaki snippet'te, harici bir URL'den medya paketinin nasıl yükleneceği gösterilmektedir:

let mediaBundleUrl = "http://www.example.com/example.zip";
let mediaBundleBlob = UrlFetchApp.fetch(mediaBundleUrl).getBlob();
let mediaOperation = AdsApp.adMedia().newMediaBundleBuilder()
    .withName("bundle name")
    .withData(mediaBundleBlob)
    .build();

Medya sorgulanıyor

Her tür medya, Google Ads komut dosyalarında MediaSelector kullanılarak sorgulanabilir. Şunu kullanın: withCondition() temel alarak medyayı ada, türe veya diğer alanlara göre filtreleyin. Örneğin, aşağıdaki snippet bir hesaptaki tüm resimleri bulur:

let mediaIterator = AdsApp.adMedia().media()
    .withCondition("Type = IMAGE")
    .get();
while (mediaIterator.hasNext()) {
  let image = mediaIterator.next();
}

Medya içeren reklamlar oluşturma

Ekli medyayla desteklenen reklamlar oluşturmayla ilgili bazı kod örnekleri için reklamlar makalemizi inceleyin.