מדיה במודעה

סוגים מסוימים של מודעות, כמו ImageAd ו-ResponsiveDisplayAd, מכילים תמונות ורכיבי מדיה אחרים. במדריך הזה מוסבר איך להעלות מדיה ולשאול שאלות לגביה באמצעות סקריפטים של Google Ads.

העלאת תמונות

אפשר להעלות תמונות באמצעות המחלקה ImageBuilder, שמקבלת שם ונתוני תמונה. הנתונים מסופקים כאובייקט להחלפת נתונים Blob שאפשר ליצור באמצעות שירותים כמו Drive או URL fetch.

קטע הקוד הבא מראה איך להעלות תמונה מכתובת URL חיצונית:

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

לחלופין, אפשר לטעון את ה-blob של התמונה מ-Google Drive:

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

העלאה של חבילות מדיה

חבילות מדיה הן ארכיוני ZIP שמכילים נכסי HTML5, שאפשר להשתמש בהם כדי ליצור מודעות HTML5. מעלים חבילות מדיה באמצעות המחלקה MediaBundleBuilder, שמקבלת שם ונתוני קובץ. בדומה לתמונות, הנתונים מסופקים כאובייקט להחלפת נתונים מסוג Blob.

קטע הקוד הבא מראה איך להעלות חבילת מדיה מכתובת URL חיצונית:

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

שליחת שאילתות לגבי מדיה

אפשר לשלוח שאילתות לגבי מדיה מכל הסוגים בסקריפטים של Google Ads באמצעות MediaSelector. אפשר להשתמש בפרדיקט withCondition() כדי לסנן מדיה לפי שם, סוג או שדות אחרים. לדוגמה, הקטע הבא מוצא את כל התמונות בחשבון:

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

יצירת מודעות עם מדיה

במאמר בנושא מודעות יש כמה דוגמאות לקוד ליצירת מודעות נתמכות עם קובצי מדיה מצורפים.