Media Iklan

Beberapa jenis iklan, seperti ImageAd dan ResponsiveDisplayAd, berisi gambar dan elemen media lainnya. Panduan ini menjelaskan cara mengupload dan mengkueri media menggunakan skrip Google Ads.

Mengupload beberapa gambar

Gambar dapat diupload menggunakan class ImageBuilder, yang menggunakan nama dan data gambar. Data disediakan sebagai objek pertukaran data Blob yang dapat dibuat oleh layanan seperti Drive atau pengambilan URL.

Cuplikan berikut menunjukkan cara mengupload gambar dari URL eksternal:

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();

Atau, blob gambar dapat dimuat dari Google Drive:

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

Mengupload paket media

Paket media adalah arsip ZIP yang berisi aset HTML5, yang dapat digunakan untuk membuat iklan HTML5. Upload paket media dengan class MediaBundleBuilder, yang menggunakan nama dan data file. Seperti gambar, data disediakan sebagai objek pertukaran data Blob.

Cuplikan berikut menunjukkan cara mengupload paket media dari URL eksternal:

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();

Membuat kueri media

Media dari setiap jenis dapat dikueri dalam skrip Google Ads menggunakan MediaSelector. Gunakan prediket withCondition() untuk memfilter media berdasarkan nama, jenis, atau kolom lainnya. Misalnya, cuplikan berikut menemukan semua gambar di akun:

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

Membuat iklan dengan media

Lihat artikel iklan kami untuk mengetahui beberapa contoh kode cara membuat iklan yang didukung dengan media terlampir.