הסלקטורים עוזרים למתכנת ליצור את השאילתה שמאחזרת את מה שרוצים ישויות של Google Ads. באמצעות הבוררים אפשר לצמצם את רשימת הישות שאוחזרו ולסדר אותה. לרוב הבוררים יש את השיטות הבאות:
withCondition()- הוספת תנאי לסלקטור. אם משתמשים בכמה תנאים, כלומר, הבורר יחזיר רק ישויות לעמוד בכל התנאים שצוינו.
withIds()- הוספת אוסף של מזהים כתנאי. תנאי שמבוסס על מזהה יתווסף לכל שאר התנאים באמצעות הפונקציה AND.
forDateRange()- נדרש כשתנאי או תנאי הזמנה מפנים אל השדה Stats, כמו שיעור קליקים או חשיפות אם מבקשים את כל הקמפיינים עם יותר מ-100 חשיפות, סקריפטים של Google Ads יצטרכו לדעת את טווח התאריכים לבדיקה.
orderBy()- ההגדרה קובעת את סדר הישויות שהוחזרו.
withLimit()- מגבילה את מספר הישויות שמוחזרות לערך שצוין. זה כן
שימושי במיוחד בשילוב עם
orderBy()כדי לאחזר דברים כמו '10 מילות מפתח עם הכי הרבה חשיפות אתמול'. כברירת מחדל, כל הבוררים יגדיר את המגבלה ל-50,000. אפשר להגדיל את המגבלה על ידי ציון ידני מגבלה.
אפשר לקרוא לשיטות האלה בכל סדר שתרצו. חריג אחד הוא orderBy(), שבו
סדר הקריאות אכן חשוב: קריאות מרובות לשיטה זו יציינו
כמה סעיפי הזמנה, והם יחולו לפי הסדר. נבחן את קטע הקוד הבא:
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().
כדאי לקרוא את המאמר שיטות מומלצות כדי לקבל טיפים וטריקים לשימוש יעיל בבורר.