Die Merchant API bietet Leistungsberichte,
ProductPerformanceView
Auf dieser Seite wird die Struktur von Leistungsberichten erläutert.
Messwerte
Sie können Messwerte (z. B. clicks
und impressions
) abfragen,
die zurückgegeben werden sollen. Sie müssen einen Filter für den Zeitraum hinzufügen, um die Berichte abzufragen
für Leistungsdaten.
Hier sehen Sie eine Beispielabfrage, die eine einzelne Zeile mit der Gesamtzahl der Klicks zurückgibt innerhalb des angegebenen Zeitraums:
SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'
Sie müssen angeben, welche Daten zurückgegeben werden sollen. Bei Platzhaltern wie SELECT
*
wird ein Fehler zurückgegeben.
Das folgende Beispiel für eine Antwort zeigt,dass der Händler insgesamt 4.440 Klicks, für alle Produkte und Marketingmethoden, zwischen dem 1. Dezember und 21. Dezember 2020.
{
"results": [
{
"productPerformanceView": {
"clicks": "4,440"
}
}
]
}
Segmente
Mit der MCQL können Sie Segmentfelder abfragen. Segmentfelder können
Produktattribute (z. B. offerId
, brand
und category
) oder Ereignis
(z. B. date
und marketingMethod
).
Segmentfelder verhalten sich ähnlich wie GROUP BY
in SQL. Segmentfelder unterteilen die
ausgewählten Messwerten, gruppiert nach jedem Segment in der SELECT
-Klausel.
Hier sehen Sie eine Beispielabfrage, die Klicks pro Tag in absteigender Reihenfolge nach
clicks
innerhalb der hinzugefügten Bedingung eines Zeitraums. Nur Zeilen mit mindestens
eines angeforderten Messwerts
nicht null sind, werden zurückgegeben.
SELECT
date,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC
Das folgende Antwortbeispiel zeigt,dass der Händler 1.546 Klicks auf alle Produkte, sämtliche Marketingmethoden, am 1. Dezember 2020 und 829 Klicks für alle Produkte und sämtliche Marketingmethoden am 2. Dezember 2020 Da der Händler am 3. Dezember 2020 keine Klicks erzielt hat, wird nichts zurückgegeben für an diesem Datum.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}