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