נכסים

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

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

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

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

const file = UrlFetchApp.fetch(imageUrl);

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