מבנה השאילתה

אפשר לשלוח שאילתות לגבי שדות של מדדים ופלחים אל 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