Die Merchant API bietet Leistungsberichte, z. B. ProductPerformanceView
.
Auf dieser Seite wird die Struktur von Leistungsberichten erläutert.
Messwerte
Sie können Messwerte abfragen (z. B. clicks
und impressions
), die zurückgegeben werden sollen. Sie müssen einen Filter für den Zeitraum hinzufügen, um Leistungsdaten vom Berichtsdienst abzufragen.
Hier sehen Sie eine Beispielabfrage, die eine einzelne Zeile mit der Gesamtzahl der Klicks im angegebenen Zeitraum zurückgibt:
SELECT clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-21'
Sie müssen die Daten angeben, die zurückgegeben werden sollen. Platzhalter (z. B. SELECT
*
) geben einen Fehler zurück.
Die folgende Beispielantwort zeigt, dass der Händler zwischen dem 1. Dezember 2020 und dem 21. Dezember 2020 insgesamt 4.440 Klicks für alle Produkte und alle Marketingmethoden erzielt hat.
{
"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 Ereignisattribute (z. B. date
und marketingMethod
) sein.
Segmentfelder verhalten sich ähnlich wie GROUP BY
in SQL. Segmentfelder teilen die ausgewählten Messwerte auf und gruppieren nach jedem Segment in der SELECT
-Klausel.
Mit dieser Beispielabfrage werden Klicks pro Tag in absteigender Reihenfolge nach clicks
innerhalb der hinzugefügten Bedingung eines Zeitraums zurückgegeben. Es werden nur Zeilen zurückgegeben, in denen mindestens ein angeforderter Messwert ungleich null ist.
SELECT
date,
clicks
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-03'
ORDER BY clicks DESC
Die folgende Beispielantwort zeigt, dass der Händler am 1. Dezember 2020 1.546 Klicks für alle Produkte über alle Marketingmethoden hinweg und 829 Klicks für alle Produkte und alle Marketingmethoden am 2. Dezember 2020 erzielt hat. Da der Händler am 3. Dezember 2020 keine Klicks hatte, werden für dieses Datum nichts zurückgegeben.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2020,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}