תוויות

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

תרחישים לדוגמה

בחשבונות Google Ads אפשר להשתמש בתוויות כדי לשייך נתונים שרירותיים לישויות ב-Google Ads. בחשבונות ניהול אפשר להשתמש בתוויות כדי לקבץ חשבונות צאצא דומים. תוויות עוזרות לכמה תרחישים לדוגמה:

• עיבוד רשימה של חשבונות
  • אם אתם מייצגים סוכנות, תוכלו להחיל את התווית plumber_accounts על כל החשבונות של שרברבים, ולאחר מכן סקריפט יכול לדחוף מילות מפתח שקשורות לשרברבים (למשל, 'תיקון מקלחות בשעת חירום') לכל הקמפיינים בחשבונות האלה.
• עיבוד רשימת ישויות
  • אם הגדרתם קבוצה של מילות מפתח שאתם רוצים להפעיל רק בסופי שבוע, תוכלו להחיל עליהן את התווית weekend_keywords. לאחר מכן סקריפט יוכל להפעיל את כל מילות המפתח עם weekend_keywords ביום שישי בערב, ולהשהות אותן ביום שני בבוקר.
• עיבוד ישויות בהרצות מרובות
  • אם יש מספר גדול של ישויות שאי אפשר לעבד בפחות מ-30 דקות, תוכלו ליצור תווית processed בסקריפט ולהחיל אותה על ישויות שכבר עובדו. מתזמנים את ההפעלה של הסקריפט מדי שעה, ואז מעבדים רק ישויות שלא משויכת להן התווית processed.
• שינויים בשני שלבים
  • במקום שהסקריפט יבצע שינוי בהצעת המחיר במספר גדול של מילות מפתח, תוכל להוסיף למילות המפתח תווית עם המילה increase_bid_by_10%, להתחבר לממשק המשתמש של Google Ads, לסנן את מילות המפתח התואמות לתווית, לבדוק אותן, ואם התוצאה היא שביעות רצון, לשנות את הצעות המחיר שלהן באמצעות עריכות בכמות גדולה.
• בידינג גמיש
  • סקריפט יכול להשתמש בתוויות כדי לשמור היסטוריה של השינויים בהצעות המחיר. במקרה שבו סקריפט מגדיל את הצעת המחיר למילות מפתח ב-20%, הוא יכול לסמן את החשבון בתווית increased_20%. למחרת, כשהסקריפט ירוץ בכל התווית ותבין שהוא כבר הגדיל את הצעת המחיר בעבר, ייתכן שהסקריפט יגדיל את הצעת המחיר ב-10% בלבד.
• מעקב אחרי ציון האיכות
  • סקריפט יכול לסמן מילות מפתח חשובות עם ציוני האיכות שלהן, ולאחר מכן לבדוק ולדווח מדי פעם על מילות מפתח שציון האיכות שלהן כבר לא תואם לתווית.

תוויות ברמת החשבון

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

const labelName = 'High spending accounts';
AdsManagerApp.createAccountLabel(labelName);

אפשר להחיל את התווית על החשבונות שבחרתם באמצעות השיטה applyLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.applyLabel(labelName);
}

באופן דומה, אפשר להסיר תווית מחשבון באמצעות method removeLabel:

const accountIds = ['123-456-7890', '345-6789-2100'];
const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts().withIds(accountIds).get();
for (const account of accounts) {
  account.removeLabel(labelName);
}

השימוש הנפוץ ביותר בתוויות חשבון הוא עיבוד קבוצה של חשבונות שחולקים את אותה תווית חשבון:

const labelName = 'High spending accounts';

const accounts = AdsManagerApp.accounts()
    .withCondition(`LabelNames CONTAINS "${labelName}"`)
    .get();

הערה: LabelNames היא שיטה נוחה ומחייבת קריאה נוספת ל-API מאחורי הקלעים כדי לחפש את שם המשאב של התווית. אם כבר יש לכם אובייקט תווית, צריך להשתמש במסנן של customer_client.applied_labels CONTAINS ALL (${label.getResourceName()}). פרטים נוספים על שמות המשאבים מופיעים בקטע בנושא דיווח בהמשך.

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

תוויות בתוך חשבון

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

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.applyLabel('High performing campaign');

באופן דומה, ניתן להסיר תווית באמצעות השיטה removeLabel:

const campaign = AdsApp.campaigns()
    .withCondition('campaign.name = "My first campaign"').get().next();
campaign.removeLabel('High performing campaign');

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

const label = AdsApp.labels()
    .withCondition('label.name = "Christmas promotions"')
    .get().next();
var campaignIterator = label.campaigns().get();
for (const campaign of campaignIterator) {
  campaign.pause();
}

דיווח

כשמריצים דוחות ביצועים בחשבונות Google Ads, אפשר להשתמש בשמות המשאבים של התוויות כדי לסנן לפי ישויות. שמות משאבים הם קונספט ב-Google Ads API, ולפעמים משתמשים בהם כשמריצים דוחות עם GAQL. השם של משאב התווית הוא תמיד בפורמט:

customers/[customer id]/labels/[label id]

אפשר לאחזר שם משאב של תווית באמצעות ה-method getResourceName.

קטע הקוד הבא מראה כיצד להריץ דוח קמפיינים לכל הקמפיינים עם התווית 'קידומי מכירות לחגים':

const label = AdsApp.labels()
    .withCondition("label.name = 'Christmas promotions'")
    .get().next();
const query = `SELECT campaign.name, metrics.clicks, metrics.impressions, metrics.cost ` +
    `FROM campaign WHERE campaign.labels CONTAINS ANY ` +
    `["${label.getResourceName()}"] AND segments.date DURING THIS_MONTH`;
const result = AdsApp.search(query);

חשוב לזכור שאפשר להשתמש רק באופרטורים CONTAINS_ALL, CONTAINS_ANY ו-CONTAINS_NONE כדי לסנן לפי שמות המשאבים של התוויות.