Reklam Medyası

ImageAd ve ResponsiveDisplayAd gibi bazı reklam türleri resimler ve diğer medya öğeleri içerir. 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, 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 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. Ad ve dosya verileri alan MediaBundleBuilder sınıfını kullanarak medya paketleri yükleyin. Görsellerde 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 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 sorgulama

Her tür medya, Google Ads komut dosyalarında MediaSelector kullanılarak 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 reklamlar oluşturma

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