Performance reports

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