מדיה במודעה

סוגים מסוימים של מודעות, כמו 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(condition) כדי לסנן מדיה לפי שם, סוג או שדות אחרים. לדוגמה, הקטע הבא מוצא את כל התמונות בחשבון:

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

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

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