הסלקטורים עוזרים למתכנת ליצור את השאילתה שמאחזרת את הישויות הרצויות ב-Google Ads. באמצעות הבוררים, אפשר לצמצם את רשימת הישויות שאוחזרו ולסדר אותה. לרוב הסלקטורים יש את השיטות הבאות:
withCondition()- הוספת תנאי לבורר. אם משתמשים בכמה תנאים, המערכת מחילה אותם ביחד עם הפונקציה (AND) יחד. במילים אחרות, הבורר יחזיר רק ישויות שעומדות בכל התנאים שצוינו.
withIds()- מוסיפה אוסף של מזהים כתנאי. אם מגדירים תנאי שמבוסס על מזהה, הפונקציה AND חלה עליו יחד עם כל התנאים האחרים.
forDateRange()- נדרש כאשר תנאי או תנאי הזמנה מפנים לשדה נתונים סטטיסטיים, כמו שיעור קליקים או חשיפות. אם מבקשים את כל הקמפיינים עם יותר מ-100 חשיפות, הסקריפטים של Google Ads צריכים לדעת את טווח התאריכים שצריך לבדוק.
orderBy()- ההגדרה קובעת את הסדר של הישויות שהוחזרו.
withLimit()- מגבילה את מספר הישויות שמוחזרות לערך שצוין. הוא שימושי במיוחד בשילוב עם
orderBy()כדי לאחזר דברים כמו "10 מילות מפתח עם הכי הרבה חשיפות אתמול". כברירת מחדל, כל הבוררים יגדירו את המגבלה ל-50,000. אפשר לציין אותה באופן ידני כדי להגדיל אותה.
אפשר לקרוא לשיטות האלה בכל סדר. יוצא הדופן אחד הוא orderBy(), שבו סדר הקריאות באמת חשוב: קריאות מרובות לשיטה הזו מציינות מספר סעיפי הזמנה ויחולו לפי הסדר. כדאי לעיין בקטע הקוד הבא:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
התוצאות מסודרות לפי קליקים בסדר יורד. תוצאות עם ערכים שווים של קליקים יסודרו לפי שיעור קליקים (Ctr) בסדר עולה.
ניתן לשרשר קריאות לשיטות של בורר יחד. הקוד הבא
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().
טיפים וטריקים לשימוש יעיל בבוררים מופיעים בדף השיטות המומלצות.