מיון והגבלת תוצאות

סידור התוצאות

אפשר לציין את סדר השורות בתשובה באמצעות הסעיף ORDER BY, שמורכב מרצף אחד או יותר של:

FieldName ('ASC' | 'DESC')?

אם לא מציינים את הערך ASC או DESC אחרי שם השדה, ברירת המחדל של Google Ads API היא ASC.

סעיף ORDER BY הבא ממיין דוח ברמת הקמפיין לפי חשיפות בסדר יורד ושם הקמפיין בסדר עולה:

ORDER BY metrics.impressions DESC, campaign.name ASC

אסור להזמין:

  • לפי מאפיינים של משאבים שלא נבחרו
  • לפי מדדים שלא נבחרו
  • לפי פלחים שלא נבחרו
  • בשדות מהסוגים הבאים:
    • MESSAGE
    • שדות חוזרים
    • מאפיינים של שדות חוזרים

הגבלת מספר התוצאות

אפשר להגביל את המספר הכולל של התוצאות שהוחזרו באמצעות הסעיף LIMIT. על סמך השילוב עם סדר התוצאות, תוכלו להפיק דוחות 'N המובילים', כמו דוח שמכיל את חמשת הקמפיינים עם מספר החשיפות הגבוה ביותר ב-30 הימים האחרונים:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

אסור לסנן:

  • בפלחים בלי לבחור אותם, מלבד שדות של פלחי תאריכים מסוג 'ליבה'.
    • השדות העיקריים של פילוח התאריכים הם segments.date, segments.week, segments.month, segments.quarter ו-segments.year.
  • בשדות של כל סוג הודעה, מלבד טקסט ראשוני (למשל: Int64Value, StringValue וכו')
  • במאפיינים של שדות חוזרים מכל סוג הודעה, מלבד פרטים ראשוניים (למשל: Int64Value, StringValue וכו')