סידור והגבלת התוצאות

שפת השאילתות של Google Ads מאפשרת למיין את השורות שמוחזרות בתשובות לשאילתות ולהגביל את מספרן באמצעות סעיפי ORDER BY ו-LIMIT.

סדר התוצאות

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

FieldName (ASC | DESC)?

אם לא מציינים ASC או DESC אחרי שם השדה, ברירת המחדל של Google Ads API היא ASC. אם משמיטים את פסוקית ORDER BY לגמרי, סדר השורות שמוחזרות לא קבוע.

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

ORDER BY metrics.impressions DESC, campaign.name ASC

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

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

אפשר להגביל את המספר הכולל של התוצאות שמוחזרות באמצעות פסוקית LIMIT עם מספר שלם חיובי (1 ומעלה; LIMIT 0 לא תקין). אפשר לשלב את זה עם סידור התוצאות כדי ליצור דוחות של 'ה-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

סינון התוצאות

כשמשלבים מסנני WHERE עם מסנני ORDER BY ו-LIMIT, חשוב לזכור את הגבלות הסינון הבאות:

• אסור לסנן פלחים בלי לבחור אותם, למעט שדות של פלחים עם תאריכים 'בסיסיים' (segments.date, segments.week, segments.month, segments.quarter ו-segments.year).
• אי אפשר לסנן ישירות שדות מורכבים MESSAGE (חוץ מהודעות wrapper פרימיטיביות כמו Int64Value ו-StringValue). במקום זאת, צריך לסנן את שדות המשנה הסקלריים הפרימיטיביים (int64,‏ string,‏ bool) או את שדות המשנה של סוגי הנתונים המנויים.
• אי אפשר לסנן מאפיינים מורכבים MESSAGE של שדות חוזרים. אפשר לסנן רק שדות משנה סקלריים פרימיטיביים (int64,‏ string,‏ bool), שדות enum או שדות משנה פרימיטיביים מסוג wrapper.