Diese Seite wurde von der Cloud Translation API übersetzt.

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 nach Messwerten (z. B. clicks und impressions) fragen, die zurückgegeben werden sollen. Sie müssen einen Filter für den Zeitraum hinzufügen, um den Berichtsdienst nach Leistungsdaten 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. Für Platzhalter (z. B. SELECT *) wird ein Fehler zurückgegeben.

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

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

Segmente

Sie können Segmentfelder für die Segmentierung in Leistungsberichten verwenden. Wenn Sie beispielsweise nach marketing_method suchen, wird ein Bericht mit einer Zeile für jede Marketingmethode und den Messwerten zurückgegeben, die Sie in der SELECT-Klausel für diese Marketingmethode 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 nach den einzelnen Segmenten in der SELECT-Klausel gruppiert.

Hier ist eine Beispielabfrage, 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 erzielt hat. Der Händler hatte am 3. Dezember 2023 keine Klicks. Für dieses Datum wird daher 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 eine Beispielabfrage, mit der die Klicks für alle Produkte in Ihrem Konto innerhalb eines 30-tägigen Zeitraums zurückgegeben werden, 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-Abfragesprache unterstützt die Segmentierung von Messwerten nach zwei Gruppen von Attributen, die Sie zur Organisation Ihres Inventars definieren können:

Kategorieebenen: Kategorien aus der Produkttaxonomie von Google Google kann die Kategorie Ihrem Produkt automatisch zuweisen, wenn keine angegeben wurde, oder die angegebene Kategorie weiter verfeinern.
Produkttypebenen: Produkttypen, die Sie auf Grundlage Ihrer Kategorisierung zuweisen. Im Gegensatz zu den Kategorieebenen gibt es keine vordefinierte Reihe unterstützter Werte.

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

Angenommen, Sie haben ein Produkt mit den folgenden Produkttypebenen:

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`

Währungs- und Preismesswerte

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 Folgendes zurück:

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

Wenn Sie in einer Abfrage sowohl preisbezogene als auch nicht preisbezogene Messwerte anfordern, werden preisbezogene Messwerte in separaten Ergebniszeilen von nicht preisbezogenen Messwerten zurückgegeben, 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.