מדיה במודעה

סוגי מודעות מסוימים, כמו 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();
}

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

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