בוררים

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

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

withCondition()

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

withIds()

הוספת אוסף של מזהי כתנאי. תנאי שמבוסס על מזהה יתווסף לכל שאר התנאים באמצעות הפונקציה AND.

forDateRange()

נדרש כשתנאי או תנאי סדר מפנים לשדה Stats, כמו Ctr או Impressions. אם מבקשים את כל הקמפיינים עם יותר מ-100 חשיפות, סקריפטים של Google Ads יצטרכו לדעת את טווח התאריכים לבדיקה.

orderBy()

הגדרת הסדר של הישויות שמוחזרות.

withLimit()

מגבילה את מספר הישויות שמוחזרות לערך שצוין. היא שימושית במיוחד בשילוב עם orderBy() כדי לאחזר נתונים כמו '10 מילות המפתח עם הכי הרבה חשיפות אתמול'. כברירת מחדל, כל הבוררים יגדירו את המגבלה ל-50,000. כדי להגדיל את המגבלה, צריך לציין אותה באופן ידני.

אפשר להפעיל את השיטות האלה בסדר כלשהו. חריג אחד הוא orderBy(), שבו סדר הקריאות אכן חשוב: מספר קריאות ל-method הזה יציינו מספר תנאי סדר, והם יחולו לפי הסדר. נבחן את קטע הקוד הבא:

selector = selector.forDateRange("LAST_14_DAYS")
    .orderBy("metrics.clicks DESC")
    .orderBy("metrics.ctr ASC");

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

אפשר לשרשר יחד קריאות לשיטות של סלקטורים. הקוד הבא

var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");

אפשר לכתוב מחדש בצורה קומפקטית יותר:

var campaignSelector = AdsApp.campaigns()
  .withCondition("metrics.clicks > 10")
  .withCondition("metrics.impressions > 1000")
  .orderBy("metrics.impressions DESC")
  .forDateRange("YESTERDAY");

אחרי שיוצרים את הבורר, אפשר לקבל ממנו Iterator על ידי קריאה ל-selector.get().

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