Performance reports

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