נכסים

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

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

נכסי טקסט ונכסי תמונות הם סוגי הנכסים העיקריים שנדרשים, ולכן במדריך הזה נסביר איך להעלות כל אחד מהם. אפשר להחיל את העקרונות האלה גם על סוגים אחרים של נכסים. לא משנה איזה סוג נכס אתם יוצרים, אתם יכולים להשתמש ב-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.