נכסים

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

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

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

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

נכסי טקסט

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

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

נכסי תמונות

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

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

const file = UrlFetchApp.fetch(imageUrl);

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