תוויות

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

באופן דומה, אפשר להסיר תווית מחשבון באמצעות השיטה 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();

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

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

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

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 כדי לסנן לפי שמות של משאבי תוויות.