מיון התוצאות
אפשר לציין את סדר השורות בתגובה באמצעות התנאי 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 וכו')