קמפיינים למיקסום ביצועים שמשתמשים ב-AdsApp

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

אחזור של קמפיינים למיקסום הביצועים

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

const campaignName = "My Performance Max campaign";

const campaignIterator = AdsApp.performanceMaxCampaigns()
    .withCondition(`campaign.name = "${campaignName}"`)
    .get();

for (const campaign of campaignIterator) {
  ...
}

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

נכסים וקבוצות נכסים

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

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

הוספת נכס לקבוצת נכסים

קודם כל יוצרים את הנכס:

const imageUrl = "http://www.example.com/example.png";
const imageBlob = UrlFetchApp.fetch(imageUrl).getBlob();
const assetOperation = AdsApp.adAssets().newImageAssetBuilder()
   .withName("new asset name")
   .withData(imageBlob)
   .build();
const imageAsset = assetOperation.getResult();

אחרי שיוצרים את הנכס, מוסיפים אותו לקבוצת נכסים קיימת:

// First, fetch the Performance Max campaign we want to operate on.
const campaignIterator = AdsApp.performanceMaxCampaigns()
   .withCondition(`campaign.name = '${campaignName}'`)
   .get();
let campaign;
if (campaignIterator.hasNext()) {
   campaign = campaignIterator.next();
} else {
   throw `No campaign found with name ${campaignName}.`
}

// Then, get that campaign's asset groups.
const assetGroupIterator = campaign.assetGroups().get();

// The campaign must have at least one asset group, so we can just assume so here.
const assetGroup = assetGroupIterator.next();

// Add the asset from the previous step.
assetGroup.addAsset(imageAsset, 'MARKETING_IMAGE');

שימו לב שצריך לציין את סוג הנכס בשלב האחרון. רשימה מלאה של סוגי הנכסים זמינה במאמרי העזרה של Google Ads API.

כדי להשתמש בנכס קיים, קודם צריך ליצור בורר נכסים:

const assetSelector = AdsApp.adAssets().assets();

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

לבסוף, מאחזרים את האיטרטור ומבצעים איטרציה כמו עם ישויות אחרות:

const assetIterator = assetSelector.get();

for (const asset of assetIterator) {
   ...
}

נכסי טקסט

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

לדוגמה, כך יוצרים נכס כותרת:

assetGroup.addAsset('asset text here', 'HEADLINE');

הסרת נכס מקבוצת נכסים

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

כך מסירים את הנכס שנוסף בדוגמה הקודמת:

assetGroup.removeAsset(imageAsset, 'MARKETING_IMAGE');

אפשר גם לקבל רשימה של נכסים בקבוצת נכסים נתונה באמצעות הפונקציה search:

// The resource name is a unique identifier for this asset group.
const assetGroupName = assetGroup.getResourceName();
results = AdsApp.search(
   `SELECT asset.resource_name, asset_group_asset.field_type
    FROM asset_group_asset
    WHERE asset_group.resource_name = '${assetGroupName}'`
);

האפשרות הזו בוחרת את שם המשאב של הנכס כמזהה הייחודי שלו. אפשר גם לבחור שדות אחרים, כמו asset.type או asset.text_asset.text, כדי לצמצם עוד יותר את התוצאות. אפשר להשתמש בכלי ליצירת שאילתות לסוג הדוח הזה כדי ליצור שאילתה משלכם.

אחרי שמוצאים את הנכס הרצוי, מפעילים את השיטה remove בקבוצת הנכסים כדי להסיר את הנכס מקבוצת הנכסים:

// This example assumes at least one asset is returned. We'll remove the first
// asset, whatever it is. In your code, customize this to choose the right
// asset to be removed.
const row_info = results.next().asset;
assetGroup.remove(row_info.asset.resource_name, row_info.asset_group_asset.field_type);