Media Iklan

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

Mengupload beberapa gambar

Gambar dapat diupload menggunakan ImageBuilder yang mengambil data nama dan gambar. Data tersebut 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 MediaBundleBuilder , yang mengambil nama dan data file. Seperti halnya 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

Setiap jenis media dapat dikueri dalam skrip Google Ads menggunakan MediaSelector Gunakan withCondition() predikat untuk memfilter media berdasarkan nama, jenis, atau kolom lainnya. Misalnya, cuplikan berikut menemukan semua gambar dalam sebuah 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 kode contoh pembuatan iklan yang didukung dengan media yang dilampirkan.