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