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

שפת השאילתות של 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) או לפי שדות משנה של enum.
• אי אפשר לסנן לפי מאפייני MESSAGE מורכבים של שדות חוזרים. אפשר לסנן רק לפי סקלר פרימיטיבי (int64,‏ string,‏ bool), enum או שדות משנה פרימיטיביים של wrapper.