Performance reports

Die Merchant API bietet Leistungsberichte wie product_performance_view. Auf dieser Seite wird die Struktur von Leistungsberichten erläutert.

Messwerte

Sie können Messwerte wie clicks und impressions abfragen, die zurückgegeben werden sollen. Sie müssen einen Filter für den Zeitraum hinzufügen, um den Berichte-Dienst nach Leistungsdaten zu fragen.

Hier ist eine Beispielabfrage, die eine einzelne Zeile mit der Gesamtzahl der Klicks im angegebenen Zeitraum zurückgibt:

SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'

Sie müssen die Daten angeben, die zurückgegeben werden sollen. Platzhalter wie SELECT * geben einen Fehler zurück.

Die folgende Beispielantwort zeigt, dass der Händler zwischen dem 1. und 21. Dezember 2023 insgesamt 4.440 Klicks für alle Produkte und alle Marketingmethoden erzielt hat.

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4440"
      }
    }
  ]
}

Segmente

Sie können Segment felder für die Segmentierung in Leistungs berichten verwenden. Wenn Sie beispielsweise nach marketing_method fragen, wird ein Bericht mit einer Zeile für jede Marketingmethode und den Messwerten zurückgegeben, die Sie für diese Marketingmethode in der SELECT-Klausel angeben.

Segmentfelder können Produktattribute wie offer_id, brand und category oder Ereignisattribute wie date und marketing_method sein.

Segmentfelder funktionieren ähnlich wie GROUP BY in SQL. Segmentfelder teilen die ausgewählten Messwerte auf und gruppieren sie nach den einzelnen Segmenten in der SELECT-Klausel.

Hier ist eine Beispielabfrage, die die Klicks pro Tag in absteigender Reihenfolge nach clicks innerhalb der hinzugefügten Bedingung eines Zeitraums zurückgibt. Es werden nur Zeilen zurückgegeben, in denen mindestens ein angeforderter Messwert ungleich null ist.

SELECT
  date,
  clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC

Die folgende Beispielantwort zeigt, dass der Händler am 1. Dezember 2023 insgesamt 1.546 Klicks für alle Produkte und alle Marketingmethoden erzielt hat und am 2. Dezember 2023 829 Klicks. Am 3. Dezember 2023 gab es keine Klicks, daher wird für dieses Datum nichts zurückgegeben.

{
  "results": [
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 1
        },
        "clicks": "1546"
      }
    },
    {
      "productPerformanceView": {
        "date": {
          "year": 2023,
          "month": 12,
          "day": 2
        },
        "clicks": "829"
      }
    }
  ]
}

Wie bei benutzerdefinierten Berichten im Merchant Center können Sie mit der Merchant Reports API mehrere Segmente in derselben Abfrage angeben.

Hier ist eine Beispielabfrage, die die Klicks für alle Produkte in Ihrem Konto in einem Zeitraum von 30 Tagen zurückgibt, segmentiert nach marketing_method und offer_id:

SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'

Die Antwort auf diese Abfrage enthält eine Zeile für jede Kombination aus offer_id und marketing_method mit der Anzahl der Klicks für diese Kombination:

{
  "results": [
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12345",
        "clicks": "38"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12346",
        "clicks": "125"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12346",
        "clicks": "23"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ADS",
        "offerId": "12347",
        "clicks": "8"
      }
    },
    {
      "productPerformanceView": {
        "marketingMethod": "ORGANIC",
        "offerId": "12347",
        "clicks": "3"
      }
    }
  ]
}

Kategorie und Produkttyp

Die Merchant Center Query Language unterstützt die Segmentierung von Messwerten nach zwei Gruppen von Attributen, die Sie definieren können, um Ihr Inventar zu organisieren:

Kategorieebenen

Kategorien aus der Produkt- Taxonomie von Google. Google kann Ihrem Produkt automatisch eine Kategorie zuweisen, wenn keine angegeben wurde, oder die angegebene Kategorie weiter verfeinern.

Produkttypebenen

Produkttypen, die Sie auf Grundlage Ihrer Kategorisierung zuweisen. Anders als bei den Kategorieebenen gibt es keine vordefinierte Menge unterstützter Werte.

Sowohl die Kategorie- als auch die Produkttypattribute sind in einer Hierarchie mit mehreren Ebenen organisiert. In der Produkt spezifikation werden die einzelnen Ebenen durch das Zeichen > getrennt, in Berichten wählen Sie jedoch jede Ebene der Hierarchie separat aus.

Betrachten Sie beispielsweise ein Produkt mit den folgenden Produkttypebenen:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

In Berichten wird jede Ebene in einem eigenen Feld zurückgegeben:

Währungs- und Preismesswerte

Preismesswerte wie conversion_value werden mit dem Price Typ dargestellt. Wenn der Messwert in mehreren Währungen verfügbar ist, wird der Wert für jede Währung in einer separaten Zeile zurückgegeben. Beispielabfrage:

SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'

Daraufhin werden die folgenden Ergebnisse ausgegeben:

{
  "results": [
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Wenn Sie in einer Abfrage sowohl Preis- als auch Nicht-Preismesswerte anfordern, werden Preismesswerte in separaten Ergebniszeilen von Nicht-Preismesswerten zurückgegeben, eine Ergebniszeile pro Währungscode. Beispielabfrage:

SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'

Die folgende Antwort wird zurückgegeben:

{
  "results": [
    {
      "productPerformanceView": {
        "conversions": "27",
        "conversionValue": {
          "amountMicros": "0",
          "currencyCode": ""
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "150000000",
          "currencyCode": "USD"
        }
      }
    },
    {
      "productPerformanceView": {
        "conversions": "0",
        "conversionValue": {
          "amountMicros": "70000000",
          "currencyCode": "CAD"
        }
      }
    }
  ]
}

Alle ausgewählten Felder werden in der Antwort zurückgegeben, auch wenn ihr Wert noch der Standardwert oder null ist.

Weitere Informationen zu den für die Abfrage verfügbaren Feldern finden Sie unter Felder in der Tabelle productPerformanceView.