Performance reports

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

מדדים

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

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

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

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

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

{
  "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"
      }
    }
  ]
}