הבוררים עוזרים למתכנת ליצור את השאילתה שמאחזרת את הישויות הרצויות ב-Google Ads. באמצעות הבוררים אפשר לצמצם את רשימת הישות שאוחזרו ולסדר אותה. לרוב הבוררים יש את השיטות הבאות:
withCondition()- הוספת תנאי לבורר. אם משתמשים בכמה תנאים, הם מחוברים באמצעות AND. במילים אחרות, הבורר יחזיר רק ישויות שעומדות בכל התנאים שצוינו.
withIds()- הוספת אוסף של מזהי כתנאי. תנאי שמבוסס על מזהה יתווסף לכל שאר התנאים באמצעות הפונקציה AND.
forDateRange()- נדרש כשתנאי או סעיף הזמנה מפנים לשדה Stats, כמו שיעור קליקים או חשיפות. אם מבקשים את כל הקמפיינים עם יותר מ-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");
לאחר בניית הסלקטור, אפשר לקבל ממנו איטרטור על ידי קריאה ל-selector.get().
כדאי לקרוא את המאמר שיטות מומלצות כדי לקבל טיפים וטריקים לשימוש יעיל בבורר.