Performance reports

Merchant API כולל דוחות ביצועים, לדוגמה ProductPerformanceView בדף הזה מוסבר את המבנה של דוחות ביצועים.

מדדים

אפשר לשלוח שאילתה על מדדים (לדוגמה, clicks ו-impressions) שרוצים להחזיר. צריך להוסיף מסנן בטווח התאריכים כדי להריץ שאילתות על הדוחות שירות לנתוני ביצועים.

הנה שאילתה לדוגמה שמחזירה שורה אחת עם המספר הכולל של הקליקים בטווח התאריכים שצוין:

SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'

עליך לציין את הנתונים שברצונך להחזיר. תווים כלליים לחיפוש (לדוגמה, SELECT *) מחזירים שגיאה.

בדוגמה הבאה התגובה מראה שהמוכר צבר 4,440 סה"כ קליקים, בכל המוצרים, בכל שיטות השיווק, בין 1 בדצמבר, 2020 ו-21 בדצמבר 2020.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

פלחים

אפשר להשתמש ב-MCQL כדי לשלוח שאילתות על שדות פלחים. השדות של הפלחים יכולים להיות מאפייני מוצר (לדוגמה, offerId, brand ו-category) או אירוע (לדוגמה date ו-marketingMethod).

שדות של פלחים פועלים באופן דומה ל-GROUP BY ב-SQL. השדות של הפלחים מפצלים את שנבחרו, מקובצים לפי כל פלח בסעיף SELECT.

הנה שאילתה לדוגמה שמחזירה קליקים לכל יום, בסדר יורד לפי clicks, במסגרת התנאי שנוסף בטווח תאריכים מסוים. רק שורות שמכילות לפחות אחד מהמדדים המבוקשים אינו אפס.

SELECT
  date,
  clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC

התגובה לדוגמה הבאה מראה שהמוכר קיבל 1,546 קליקים כל המוצרים, בכל שיטות השיווק, ב-1 בדצמבר 2020 וב-829 קליקים בכל המוצרים, בכל שיטות השיווק, ב-2 בדצמבר 2020. למוכר לא היו קליקים ב-3 בדצמבר 2020, ולכן לא הוחזרו קליקים בתאריך הזה.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2020,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}