מדיה במודעה

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

העלאת תמונות

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

קטע הקוד הבא מראה איך להעלות תמונה מכתובת 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();
}

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

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