מדיה במודעה

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

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

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