בוררים

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

withCondition()

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

withIds()

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

forDateRange()

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

orderBy()

מציין את סדר הישויות שמוחזרות.

withLimit()

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

אפשר לקרוא ל-methods האלה בכל סדר. יוצא מן הכלל הוא 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");

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

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