Za pomocą interfejsu Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według konkretnych atrybutów i poprawiać ceny.
Mierz wyniki
Możesz użyć interfejsu Merchant Reports API
ProductPerformanceView
,
aby pobierać dane o skuteczności dla konta.
Wymagania
Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.
Aby przypisać do konta rolę Skuteczność i statystyki, użyj metody accounts.update
interfejsu Content API for Shopping i ustaw w polu reportsManager
wartość true
.
accounts.update
zastępuje cały zasób Account
. Użyj accounts.get
, aby uzyskać pełny zasób Account
, a następnie wypełnij wszystkie pola w żądaniu accounts.update
, aby nie utracić informacji.
Przykładowe zapytanie
To zapytanie pobiera wartości impressions
, clicks
i clickThroughRate
dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż do metody accounts.reports.search
tę instrukcję Język zapytania w Merchant Center:
SELECT impressions, clicks, clickThroughRate
FROM ProductPerformanceView
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Możesz też podzielić na segmenty dane w zapytaniu, aby uzyskać bardziej szczegółowe raporty skuteczności.
Filtruj usługi
Za pomocą interfejsu ProductView
interfejsu Merchant Reports API możesz wyświetlać filtrowany widok danych produktów, w tym ich stanów. Możesz np. wysłać zapytanie ProductView
, aby wyświetlić listę produktów, których dotyczą problemy, lub uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.
W klauzuli SELECT
zapytania musisz umieścić pole id
. id
ma tę samą wartość co identyfikator REST produktu.
Możesz filtrować na podstawie wszystkich dostępnych pól oprócz itemIssues
. Możesz posortować odpowiedź na podstawie wszystkich dostępnych pól oprócz tych:
gtin
itemIssues
Oto przykład, który zwraca produkty ze stanem NOT_ELIGIBLE_OR_DISAPPROVED
. Aby wysłać żądanie, przekaż do metody accounts.reports.search
tę instrukcję języka zapytań Merchant Center:
SELECT
id,
offerId,
feedLabel,
title,
aggregatedReportingContextStatus
itemIssues
FROM ProductView
WHERE aggregatedReportingContextStatus = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Oto przykładowa odpowiedź z poprzedniego zapytania:
{
"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"
}
]
}
}
]
}
Więcej informacji o konkretnych polach i zachowaniu znajdziesz w dokumentacji ProductView
.
Popraw ceny
W widoku statystyk dotyczących cen możesz wyświetlać sugerowane ceny promocyjne produktów i prognozy skuteczności, jakiej możesz się spodziewać, jeśli zaktualizujesz ceny swoich produktów. Raport ze statystykami dotyczącymi cen umożliwia skuteczniejsze wycenianie produktów.
Więcej informacji znajdziesz w artykule Poprawianie cen produktów za pomocą raportu na temat statystyk dotyczących cen.
Wyślij zapytanie PriceInsightsProductView
, aby wyświetlić sugerowane ceny promocyjne produktów.
Oto przykład, którego możesz użyć, aby wyświetlić sugerowane ceny promocyjne dla swoich produktów. Aby wysłać żądanie, przekaż do metody accounts.reports.search
tę instrukcję Język zapytania w Merchant Center:
SELECT
id,
title,
brand,
price,
suggested_price,
predictedImpressionsChangeFraction,
predictedClicksChangeFraction,
predictedConversionChangeFraction
FROM PriceInsightsProductView
Oto przykładowa odpowiedź z poprzedniego zapytania:
{
"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"
}
}
]
}