Mit der Merchant Reports API können Sie Leistungsdaten abrufen, Ihre Produkte nach bestimmten Attributen filtern und Ihre Preise verbessern.
Leistungsmessung
Mit der Merchant Reports API ProductPerformanceView
können Sie Leistungsmesswerte für Ihr Konto abrufen.
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, verwenden Sie die Methode accounts.update
der Content API for Shopping, um das Feld reportsManager
auf true
zu setzen.
accounts.update
ersetzt die gesamte Ressource Account
. Verwenden Sie accounts.get
, um die vollständige Account
-Ressource abzurufen. Geben Sie dann alle Felder in Ihrer accounts.update
-Anfrage an, damit keine Informationen verloren gehen.
Beispielabfrage
Mit der folgenden Abfrage werden impressions
, clicks
und clickThroughRate
für alle Produkte in Ihrem Konto innerhalb eines bestimmten Zeitraums von 30 Tagen abgerufen. Übergeben Sie dazu die folgende Anweisung für die Merchant Center Query Language-Anweisung an die Methode accounts.reports.search
:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Sie können die Messwerte in der Abfrage auch segmentieren, um detailliertere Leistungsberichte zu erhalten.
Produkte filtern
Sie können die ProductView
der Merchant Reports API verwenden, um eine gefilterte Ansicht Ihrer Produktdaten einschließlich Produktstatus aufzurufen. Sie können beispielsweise ProductView
abfragen, um Produkte aufzulisten, bei denen Probleme auftreten, oder um eine Liste Ihrer neuen Produkte abzurufen und die Bereitstellung zu überprüfen.
Sie müssen das Feld id
in die SELECT
-Klausel Ihrer Abfrage aufnehmen. Die id
hat denselben Wert wie die REST-ID des Produkts.
Sie können basierend auf allen verfügbaren Feldern außer itemIssues
filtern. Sie können die Antwort anhand aller verfügbaren Felder mit Ausnahme des folgenden sortieren:
gtin
itemIssues
In diesem Beispiel werden Ihre Produkte mit dem Status NOT_ELIGIBLE_OR_DISAPPROVED
zurückgegeben. Übergeben Sie dazu die folgende Merchant Center Query Language-Anweisung an die Methode accounts.reports.search
:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Hier ist eine Beispielantwort aus der vorherigen 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 bestimmten Feldern und zum Verhalten finden Sie in der Referenz zu ProductView
.
Preise verbessern
In der Ansicht mit Preisstatistiken finden Sie vorgeschlagene Sonderangebotspreise für Ihre Produkte sowie Vorhersagen zur Leistung, 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 PriceInsightsProductView
ab, um die vorgeschlagenen Sonderangebotspreise für Ihre Produkte abzurufen.
Hier ist ein Beispiel, das Sie verwenden können, um vorgeschlagene Sonderangebotspreise für Ihre Produkte abzurufen. Übergeben Sie dazu die folgende Anweisung für Merchant Center Query Language (Sprache der Merchant Center-Abfrage) an die Methode accounts.reports.search
:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
Hier ist eine Beispielantwort aus der vorherigen 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"
}
}
]
}