נכסים

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

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

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

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

נכסי טקסט

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

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

נכסי תמונות

נכסי תמונות מועלים בפורמט בקידוד base-64. אי אפשר להעלות תמונות ישירות לסקריפטים של 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.