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.