נכסים

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

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

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