Mit der Merchant Reports API können Sie Leistungsdaten ansehen, Produkte nach bestimmten Attributen filtern und Ihre Preise optimieren.
Leistung messen
Mit der Merchant Reports API product_performance_view können Sie Leistungsmesswerte für Ihr Konto abrufen.
Voraussetzungen
Zum Abrufen dieses Berichts benötigen Sie die Rolle „Leistung und Statistiken“.
Wenn Sie einem vorhandenen Nutzer die Rolle „Leistung und Statistiken“ zuweisen möchten, erstellen Sie eine Patch-Anfrage und weisen Sie dem Nutzer die Zugriffsberechtigung PERFORMANCE_REPORTING zu. Die folgende Anfrage zeigt, wie Sie eine Patch-Anfrage zum Zuweisen des Zugriffsrechts PERFORMANCE_REPORTING erstellen können:
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}
{
"accessRights": [
"PERFORMANCE_REPORTING"
]
}
Ersetzen Sie Folgendes:
- {ACCOUNT_ID}: Die eindeutige Kennung des Merchant Center-Kontos.
- {EMAIL_ID}: Die E-Mail-Adresse des Nutzers, dem Sie die Rolle zuweisen möchten.
Beispielabfrage
Mit der folgenden Abfrage werden die impressions, clicks und click_through_rate für alle Produkte in Ihrem Konto während eines bestimmten 30-tägigen Zeitraums abgerufen. Übergeben Sie für die Anfrage die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:
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 product_view der Merchant Reports API können Sie eine gefilterte Ansicht Ihrer Produktdaten, einschließlich Produktstatus, anzeigen lassen. Sie können beispielsweise product_view abfragen, um Produkte mit Problemen aufzulisten oder eine Liste Ihrer neuen Produkte abzurufen und die Auslieferung zu prüfen.
Sie müssen das Feld id in die SELECT-Klausel Ihrer Abfrage aufnehmen. Der id hat denselben Wert wie die REST-ID des Produkts.
Sie können nach allen verfügbaren Feldern filtern, mit Ausnahme der folgenden:
status_per_reporting_contextitem_issues
Sie können die Antwort nach allen verfügbaren Feldern sortieren, mit Ausnahme der folgenden:
gtinstatus_per_reporting_contextitem_issues
Im Feld aggregated_reporting_context_status können Sie die allgemeine Eignung eines Produkts prüfen. In diesem Feld werden die Status aller Berichtskontexte eines Produkts zusammengefasst.
Hier ist ein Beispiel, bei dem Ihre Produkte mit dem zusammengefassten Status ELIGIBLE_LIMITED zurückgegeben werden. Das bedeutet, dass sie in mindestens einem, aber nicht in allen Zielberichtskontexten präsentiert werden können. Sie können den detaillierten Produktstatus pro Berichtskontext und Produktprobleme anfordern, um weitere Nachforschungen anzustellen. Übergeben Sie für die Anfrage die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
status_per_reporting_context,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'
Hier ist eine Beispielantwort für die vorherige Abfrage:
{
"results": [
{
"productView": {
"id": "en~US~id0",
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
"statusPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"approvedCountries": [
"US"
]
}
]
"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"
}
]
}
}
]
}
Sie können einen Filter für reporting_context in der WHERE-Klausel verwenden, um Produktdetails für einen bestimmten Berichtskontext aufzurufen. Wenn Sie nach reporting_context filtern, wird aggregated_reporting_context_status nur auf Grundlage des ausgewählten Berichtskontexts berechnet. status_per_reporting_context und item_issues geben nur Details für diesen Kontext zurück.
Weitere Informationen zu den für Abfragen verfügbaren Feldern finden Sie unter Felder in der Tabelle product_view.
Preise optimieren
In der Ansicht „Preisinformationen“ finden Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Prognosen 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.
Fragen Sie price_insights_product_view ab, um vorgeschlagene Sonderangebotspreise für Ihre Produkte aufzurufen.
Hier ist ein Beispiel, mit dem Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte aufrufen können. Übergeben Sie für die Anfrage die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversions_change_fraction
FROM price_insights_product_view
Hier ist eine Beispielantwort für die vorherige Abfrage:
{
"results": [
{
"priceInsightsProductView": {
"id": "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": "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": "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.