Reklam Medyası

ImageAd ve ResponsiveDisplayAd gibi bazı reklam türleri resim ve diğer medya öğelerini içerir. Bu kılavuzda, Google Ads komut dosyaları kullanarak medya yükleme ve sorgulama işlemleri açıklanmaktadır.

Görüntü yükleme

Resimler, ad ve resim verilerini alan ImageBuilder sınıfı kullanılarak yüklenebilir. Veriler, Drive veya URL getirme gibi hizmetler tarafından oluşturulabilen bir Blob veri değişim nesnesi olarak sağlanır.

Aşağıdaki snippet'te harici bir URL'den nasıl görsel yükleyeceğiniz 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 blob'u Google Drive'dan da 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ükleniyor

Medya paketleri, HTML5 öğeleri içeren ZIP arşivleridir ve HTML5 reklamlar oluşturmak için kullanılabilir. Ad ve dosya verilerini alan MediaBundleBuilder sınıfıyla medya paketlerini yükleyin. Resimlerde olduğu gibi veriler bir Blob veri değişim nesnesi olarak sağlanır.

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, MediaSelector kullanılarak Google Ads komut dosyalarında sorgulanabilir. Medyayı ada, türe veya diğer alanlara göre filtrelemek için withCondition() koşulunu kullanın. Ö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 reklam oluşturma

Medya eklenmiş desteklenen reklamlar oluşturmaya ilişkin bazı kod örnekleri için reklam makalemize bakın.