Die Merchant API v1beta wird am 28. Februar 2026 eingestellt. Eine Anleitung zur Umstellung auf die aktuelle stabile Version finden Sie unter Von v1beta zu v1 migrieren.

Performance reports

Die Merchant API bietet Leistungsberichte, z. B. product_performance_view. 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 Leistungsdaten aus dem Reports-Dienst abzufragen.

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 (z. B. SELECT *) geben einen Fehler zurück.

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

{
  "results": [
    {
      "productPerformanceView": {
        "clicks": "4,440"
      }
    }
  ]
}

Segmente

Sie können Segmentfelder für die Segmentierung in Leistungsberichten verwenden. Wenn Sie beispielsweise eine Abfrage für marketing_method ausführen, 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 (z. B. offer_id, brand und category) oder Ereignisattribute (z. B. date und marketing_method) sein.

Segmentfelder funktionieren ähnlich wie ein GROUP BY in SQL. Mit Segmentfeldern werden die ausgewählten Messwerte aufgeschlüsselt und nach jedem Segment in der SELECT-Klausel gruppiert.

Hier ist ein Beispiel für eine Abfrage, 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 1.546 Klicks für alle Produkte und alle Marketingmethoden und am 2. Dezember 2023 829 Klicks für alle Produkte und alle Marketingmethoden hatte. Der Händler hatte am 3. Dezember 2023 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 ein Beispiel für eine Abfrage, 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

Mit der Merchant Center Query Language können Sie Messwerte nach zwei Gruppen von Attributen segmentieren, die Sie zum Organisieren Ihres Inventars definieren können:

Kategorieebenen: Kategorien aus der Produkt-Taxonomie von Google. Google weist Ihrem Produkt möglicherweise automatisch eine Kategorie zu, wenn keine angegeben wurde, oder verfeinert die angegebene Kategorie.
Produkttypebenen: Produkttypen, die Sie auf Grundlage Ihrer Kategorisierung zuweisen. Im Gegensatz zu den Kategorieebenen gibt es keine vordefinierten unterstützten Werte.

Sowohl das Attribut „Kategorie“ als auch das Attribut „Produkttyp“ sind in einer Hierarchie mit mehreren Ebenen organisiert. In der Produktspezifikation wird jede Ebene durch das Zeichen > getrennt. In Berichten wählen Sie jedoch jede Ebene der Hierarchie separat aus.

Betrachten Sie beispielsweise ein Produkt mit den folgenden Produktart-Ebenen:

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

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

Segment	Wert
`product_type_l1`	`Home & Garden`
`product_type_l2`	`Kitchen & Dining`
`product_type_l3`	`Kitchen Appliances`
`product_type_l4`	`Refrigerators`

Messwerte für Währung und Preis

Preismesswerte wie conversion_value werden mit dem Typ Price 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. Zum Beispiel die folgende Abfrage:

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

gibt die folgenden Ergebnisse zurück:

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

Wenn Sie sowohl Preis- als auch nicht preisbezogene Messwerte in einer Abfrage anfordern, werden Preis-Messwerte in separaten Ergebniszeilen von nicht preisbezogenen Messwerten zurückgegeben. Es gibt eine Ergebniszeile pro Währungscode. Zum Beispiel die folgende Abfrage:

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

gibt die folgende Antwort zurück:

{
  "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 productPerformanceView-Tabelle.