אפשר לשלוח שאילתות לגבי שדות של מדדים ופלחים אל reports.search
. כדי ליצור שאילתה בשפת השאילתה ב-Merchant Center, צריך קודם לכתוב את השאילתה
באמצעות הדקדוק של השפה.
השאילתה מורכבת מכמה תנאים:
SELECT
FROM
WHERE
ORDER BY
LIMIT
הסעיפים הם שמות שדות, שמות טבלאות, אופרטורים, תנאים ו orderings (הזמנות) כדי לעזור לכם לבחור את הנתונים הרצויים. לאחר השילוב לשרשור שאילתה, אפשר לשלוח בקשה באמצעות Google Content API for Shopping. בואו נראה איך כל אחד ניתן להשתמש בתנאי הזה.
סעיפים
בחירה
הסעיף SELECT
מציין קבוצת שדות לאחזור בבקשה. SELECT
הפונקציה מקבלת רשימה מופרדת בפסיקים של שדות ומדדים של פלחים, ומחזירה את הערכים
בתשובה. התנאי SELECT
הוא חובה בשאילתה.
לפניכם שאילתה לדוגמה הבוחרת מדדי קליקים מטבלה נתונה:
SELECT
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
אפשר גם להריץ שאילתות על סוגי שדות שונים בבקשה אחת:
SELECT
segments.date,
segments.program,
metrics.impressions,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
שדות פילוח
segments.date
segments.program
מדדים
metrics.impressions
metrics.clicks
אי אפשר להשתמש בחלק מהשדות בקטע SELECT
בגלל הסיבות הבאות
הגבלה:
- שליחת שאילתה לשדות פילוח ללא שדה מדד אחד לפחות.
ניתן למצוא מידע שקשור לתנאי שלמעלה במסמכי העזר שלנו.
FROM
הסעיף FROM
מציין את הטבלה שממנה מאחזרים נתונים בבקשה.
שבסעיף FROM
מוגדר באילו שדות אפשר להשתמש כל
של השאילתה הנתונה. אפשר לציין רק טבלה אחת בעמודה
סעיף FROM
. בשלב הזה, יש תמיכה רק בטבלה MerchantPerformanceView.
התנאי FROM
הוא חובה בשאילתה ל-method search
שירות reports
.
WHERE
הסעיף WHERE
מציין את התנאים שיחולו במהלך סינון נתונים עבור
בקשה. כשמשתמשים בתנאי WHERE
, אפשר לציין תנאי אחד או יותר
באמצעות AND
כדי להפריד ביניהם. כל אחד מהתנאים צריך להיות לפי הדפוס
field_name Operator value
ניתן להשתמש בכל שדה של פלחים בקובץ WHERE
אבל צריך לציין את שדות המדדים בקטע SELECT
שנעשה בו שימוש בסעיף WHERE
. התנאי WHERE
הוא חובה בשאילתה,
מאחר שצריך לציין תמיד את טווח התאריכים שבו רוצים
הוחזרו נתוני ביצועים.
הדוגמה הבאה היא של שימוש בפונקציה WHERE
כדי להחזיר מדדים מתקופה נתונה
תקופה:
SELECT
segments.offer_id,
metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
אפשר לשלב כמה תנאים כדי לסנן את הנתונים. הדוגמה הזו תחזיר מספר הקליקים לכל מוצר בתוכנית SHOPPING_ADS, שבו הקליקים > 100 בתקופה הנתונה של 30 הימים.
SELECT
segments.offer_id,
segments.program,
metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
AND segments.program = SHOPPING_ADS
AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;
בשאילתה הבאה תוכלו לראות שהחשבון segments.date
נבחר.
לא משנה אם תבחר באפשרות segments.date
, טווח תאריכים סופי
תמיד צריך לספק את התנאי WHERE
כדי לאחזר נתוני ביצועים.
SELECT
segments.date,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
במהלך סינון, חשוב לשמור על התלות באותיות רישיות של האופרטור או בראשי תיבות.
לרשימה מלאה של האופרטורים, אפשר לעיין דקדוק שפה.
ORDER BY
הסעיף ORDER BY
מציין את הסדר שבו התוצאות יופיעו
הוחזרו. הפעולה הזו מאפשרת לסדר את הנתונים בסדר עולה או יורד
על סמך שם של שדה. כל הזמנה מצוינת כ-field_name
ואחריה
ASC
או DESC
. אם לא ציינת ASC
וגם לא DESC
, ברירת המחדל של הסדר
אל ASC
. אפשר להשתמש רק בשדות שצוינו בתנאי SELECT
סעיף ORDER BY
. התנאי ORDER BY
הוא אופציונלי בשאילתה.
השאילתה הבאה מסדרת את השורות שהוחזרו לפי מספר הקליקים מהגבוה ל- הנמוך ביותר:
SELECT
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC
אפשר לציין כמה שדות בתנאי ORDER BY
באמצעות מקש מופרד בפסיקים
חדשה. הסדר יתבצע באותו רצף שצוין בשאילתה.
לדוגמה, בשאילתה הזו התוצאות ימוינו בסדר עולה לפי
offer_id
, לאחר מכן בסדר יורד לפי מספר החשיפות, ולאחר מכן לפי
סדר יורד לפי מספר הקליקים:
SELECT
segments.offer_id,
metrics.impressions,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
segments.offer_id,
metrics.impressions DESC,
metrics.clicks DESC
LIMIT
הסעיף LIMIT
מאפשר לציין את מספר התוצאות שיוחזרו.
האפשרות הזו שימושית אם אתם מתעניינים רק בסיכום.
לדוגמה, אפשר להשתמש בפונקציה LIMIT
כדי להגביל את המספר הכולל של התוצאות
השאילתה הבאה:
SELECT
segments.program,
segments.offer_id,
metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50