נכסים

לפני שיוצרים קמפיין למיקסום ביצועים, חשוב לייבא את כל הנכסים שמתכננים להשתמש בהם בקמפיין. תמיד אפשר לחזור ולהוסיף נכסים מאוחר יותר, אבל צריך קבוצת נכסים כדי להתחיל.

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

נכסי טקסט ונכסי תמונות הם סוגי הנכסים העיקריים שנדרשים, ולכן במדריך הזה נסביר איך להעלות כל אחד מהם. אפשר להחיל את העקרונות האלה גם על סוגים אחרים של נכסים. לא משנה איזה סוג נכס אתם יוצרים, אתם יכולים להשתמש ב-AssetOperation כדי ליצור אותו.

אפשר ליצור נכסים באמצעות AdsApp בלי להשתמש ב-mutate, אבל כדי לשמור על עקביות, במדריך הזה אנחנו יוצרים אותם באותה דרך כמו את שאר הפעולות. שימו לב שאפשר ומומלץ לעשות שימוש חוזר בנכסים קיימים אם יש לכם נכסים זמינים. לכן, אמנם נדרשים נכסים כדי ליצור קמפיין למיקסום הביצועים, אבל לא בהכרח נדרש ליצור אותם כחלק מתהליך יצירת הקמפיין.

נכסי טקסט

נכסי טקסט פועלים בדיוק כמו כל פעולה אחרת. אם אתם מעלים נכסים כחלק מתהליך יצירת הקמפיין, אתם צריכים להשתמש במזהה זמני. אחרת, צריך לרשום את שם המשאב שמוחזר כדי להשתמש בו בפעולה עתידית כשצריך להפנות לנכס כדי להוסיף אותו לקבוצת נכסים.

const textAsset = {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "textAsset": {
        "text": "Travel the World"
      }
    }
  }
}
operations.push(textAsset);

נכסי תמונות

נכסי תמונות מועלים בפורמט base-64 encoded. אי אפשר להעלות תמונות ישירות לסקריפטים של Google Ads, ולכן יש שתי דרכים שונות להשיג את נתוני התמונה ולקודד אותם להעלאה.

כדי לאחזר תמונה מ-Google Drive, קודם צריך את המזהה שלה, שהוא הדרך הכי טובה לזהות את התמונה באופן ייחודי. אחת הדרכים להשיג את המזהה היא להעתיק את הקישור שניתן לשתף מממשק המשתמש של Google Drive ולחלץ את המזהה. אפשר גם לאחזר סדרה של קבצים באופן פרוגרמטי ולבחור את הקבצים שרוצים להעלות. הקוד הזה מדגים איך להעלות תמונה אחת עם מזהה ידוע:

const file = DriveApp.getFileById(fileId);
const imageAsset =  {
  "assetOperation": {
    "create": {
      "resourceName": `customers/${customerId}/assets/${getNextTempId()}`,
      "name": "Marketing Logo",
      "type": "IMAGE",
      "imageAsset": {
        "data": Utilities.base64Encode(file.getBlob().getBytes())
      }
    }
  }
}
operations.push(imageAsset);

אפשר גם לאחזר תמונה שמתארחת בשרת אינטרנט באמצעות כתובת ה-URL שלה, באמצעות UrlFetchApp:

const file = UrlFetchApp.fetch(imageUrl);

אחרי כן אפשר לקרוא לפונקציה getBlob בקובץ הזה בדיוק כמו בקובץ Drive, כך שהמבנה של הפעולה זהה לשלבים של קובץ Google Drive.