Reklam Medyası

ImageAd ve ResponsiveDisplayAd gibi bazı reklam türleri resimler ve diğer medya öğelerini içerir. Bu kılavuzda, Google Ads komut dosyalarını kullanarak medyayı nasıl yükleyip sorgulayacağınız açıklanmaktadır.

Görüntü yükleme

Resimler, ad ve resim verileri 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ş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 blob'u 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 paketlerini yükleme

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

Aşağıdaki snippet'te, harici bir URL'den medya paketi yükleme işlemi 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 sorgulama

Her türden medya, Google Ads komut dosyalarında MediaSelector kullanılarak sorgulanabilir. Medyayı ada, türe veya diğer alanlara göre filtrelemek için withCondition(condition)<0x0x0A>yüklemini 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 reklamlar oluşturma

Ekli medya içeren desteklenen reklamlar oluşturmayla ilgili bazı kod örnekleri için reklamlar makalemize göz atın.