Mit der Merchant Reports API können Sie Leistungsdaten ansehen, Ihre Produkte nach bestimmten Attributen filtern und Ihre Preise optimieren.
Leistung messen
Mit der Merchant Reports API lassen sich Leistungsmesswerte für Ihr Konto abrufen.
product_performance_view
Voraussetzungen
Sie benötigen die Rolle Leistung und Statistiken, um diesen Bericht abzurufen.
Wenn Sie einem Konto die Rolle „Leistung und Statistiken“ zuweisen möchten, patchen Sie die Ressource User für das Konto mit dem Zugriffsrecht PERFORMANCE_REPORTING. Ersetzen Sie dazu die gesamte Ressource User durch accounts.v1beta.accounts.users.patch.
Rufen Sie accounts.v1beta.accounts.users.get auf, um die vollständige User-Ressource abzurufen, und geben Sie dann alle Felder in Ihrer accounts.v1beta.accounts.users.patch-Anfrage an, um Datenverluste zu vermeiden.
Beispielabfrage
Mit der folgenden Abfrage werden die Werte für impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto in einem bestimmten 30-tägigen Zeitraum abgerufen. Geben Sie dazu die folgende Merchant Center-Abfragesprache-Anweisung an die Methode accounts.reports.search weiter:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Weitere Informationen zu Leistungsberichten finden Sie im Leitfaden Leistungsberichte.
Produkte filtern
Mit der Merchant Reports API können Sie mithilfe des Parameters product_view eine gefilterte Ansicht Ihrer Produktdaten einschließlich Produktstatus aufrufen. Sie können product_view beispielsweise abfragen, um Produkte mit Problemen aufzulisten oder eine Liste Ihrer neuen Produkte abzurufen und die Auslieferung zu überprüfen.
Das Feld id muss in der SELECT-Klausel Ihrer Abfrage enthalten sein. Der Wert von id muss mit der REST-ID des Produkts übereinstimmen.
Sie können nach allen verfügbaren Feldern filtern, mit Ausnahme von item_issues. Sie können die Antwort nach allen verfügbaren Feldern sortieren, mit Ausnahme der folgenden:
gtinitem_issues
Hier ein Beispiel, in dem Ihre Produkte mit dem Status NOT_ELIGIBLE_OR_DISAPPROVED zurückgegeben werden. Geben Sie dazu die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search weiter:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Hier ist eine Beispielantwort auf die vorherige Abfrage:
{
"results": [
{
"productView": {
"id": "online~en~US~id0"
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "NOT_ELIGIBLE_OR_DISAPPROVED",
"itemIssues": [
{
"type": {
"code": "invalid_string_value",
"canonicalAttribute": "n:product_code"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DISAPPROVED"
},
"resolution": "MERCHANT_ACTION"
},
{
"type": {
"code": "apparel_missing_brand",
"canonicalAttribute": "n:brand"
},
"severity": {
"severityPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
}
],
"aggregatedSeverity": "DEMOTED"
},
"resolution": "MERCHANT_ACTION"
}
]
}
}
]
}
Weitere Informationen zu den für Abfragen verfügbaren Feldern finden Sie unter Felder in der Tabelle productView.
Preise optimieren
In der Ansicht „Preisstatistiken“ sehen Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen für die Leistung, die Sie erwarten können, wenn Sie die Preise Ihrer Produkte aktualisieren. Mit dem Bericht „Preisstatistiken“ können Sie Preise Ihrer Produkte effektiver gestalten.
Weitere Informationen finden Sie unter Produktpreise mit dem Bericht zu Preisstatistiken verbessern.
Führen Sie die Abfrage price_insights_product_view durch, um Vorschläge für Sonderangebotspreise für Ihre Produkte zu erhalten.
Hier finden Sie ein Beispiel für vorgeschlagene Sonderangebotspreise für Ihre Produkte. Übergeben Sie zum Senden der Anfrage die folgende Merchant Center-Abfragesprache-Anweisung an die Methode accounts.reports.search:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversion_change_fraction
FROM price_insights_product_view
Hier ist eine Beispielantwort auf die vorherige Abfrage:
{
"results": [
{
"priceInsightsProductView": {
"id": "online~en~US~12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"price" {
"amountMicros": "124990000",
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "135680000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"price" {
"amountMicros": "119990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "125440000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"priceInsightsProductView": {
"id": "online~en~US~12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"price" {
"amountMicros": "84990000"
"currencyCode": "USD"
},
"suggestedPrice" {
"amountMicros": "82000000",
"currencyCode": "USD"
},
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}
Weitere Informationen zu den für Abfragen verfügbaren Feldern finden Sie unter Felder in der Tabelle priceInsightsProductView.