Mit der Merchant Reports API können Sie die Leistung Ihrer Kampagnen Daten, filtern Sie Ihre Produkte nach spezifizieren und Ihre Preise verbessern.
Leistung messen
Sie können die Merchant Reports API verwenden,
ProductPerformanceView
um die Leistung zu ermitteln,
Messwerte für Ihr Konto.
Voraussetzungen
Auf der Seite Leistung und Statistiken Rolle, um diesen Bericht abzurufen.
Um einem Konto die Rolle „Leistung und Statistiken“ zuzuweisen, patchen Sie das
User
Ressource für das Konto mit der
PERFORMANCE_REPORTING
Zugriffsrechte haben.
accounts.v1beta.accounts.users.patch
ersetzt die gesamte Ressource User
. Rufen Sie accounts.v1beta.accounts.users.get
auf, um den Verlust von Informationen zu vermeiden
um die vollständige User
-Ressource abzurufen, und füllen Sie dann alle Felder in Ihrem
accounts.v1beta.accounts.users.patch
-Anfrage.
Beispielabfrage
Die folgende Abfrage ruft die impressions
, clicks
und
clickThroughRate
für alle Produkte in Ihrem Konto innerhalb eines bestimmten Zeitraums von 30 Tagen
Punkt. Um die Anfrage zu stellen, übergeben Sie die folgende Merchant Center-Abfrage
Language-Anweisung an den
accounts.reports.search
:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Sie können die Messwerte auch segmentieren, um detailliertere Leistungsberichte zu erhalten.
Produkte filtern
Sie können die Merchant Reports API
ProductView
um eine gefilterte Ansicht Ihrer Produktdaten aufzurufen, einschließlich der Produktstatus. Für
Sie können beispielsweise ProductView
abfragen, um eine Liste mit Produkten zu erstellen, bei denen Probleme vorliegen, oder
eine Liste Ihrer neuen Produkte abrufen und die Auslieferung überprüfen.
Sie müssen das Feld id
in die SELECT
-Klausel Ihrer Abfrage einfügen. Das id
hat denselben Wert wie die REST des Produkts
ID fest.
Sie können nach allen verfügbaren
Felder,
außer itemIssues
. Sie können die Antwort basierend auf allen verfügbaren Feldern sortieren
außer den folgenden:
gtin
itemIssues
Hier sehen Sie ein Beispiel, bei dem Ihre Produkte mit dem Status
NOT_ELIGIBLE_OR_DISAPPROVED
Um die Anfrage zu stellen, übergeben Sie den folgenden Merchant Center-
„Center Query Language“,
die
accounts.reports.search
:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Hier ist ein Antwortbeispiel für 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 finden Sie in der
ProductView
finden Sie weitere Informationen zu bestimmten Feldern und Verhaltensweisen.
Preise verbessern
In der Ansicht „Preisinformationen“ sehen Sie Vorschläge für Sonderangebotspreise für Ihre Produkten und Prognosen für die Leistung, die Sie erwarten können, wenn Sie Ihrer Produkte Preise. Mit dem Bericht „Preisstatistiken“ können Sie Preise Ihrer Produkte effektiver gestalten.
Siehe Produktpreise mit Preisinformationen verbessern finden Sie weitere Informationen.
Abfrage
PriceInsightsProductView
um Vorschläge für Sonderangebotspreise für Ihre Produkte zu sehen.
Hier ist ein Beispiel, mit dem Sie die vorgeschlagenen Sonderangebotspreise für Ihre Produkte aufrufen können. Bis
senden Sie die folgende Merchant Center-Abfrage
Language-Anweisung an den
accounts.reports.search
:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
Hier ist ein Antwortbeispiel für 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"
}
}
]
}