Za pomocą interfejsu Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według określonych atrybutów oraz ulepszać ceny.
Pomiar wyników
Aby pobrać dane o skuteczności dotyczące swojego konta, możesz użyć interfejsu Merchant Reports API product_performance_view
.
Wymagania
Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.
Aby przyznać kontu rolę związaną ze skutecznością i statystykami, zastosuj poprawkę do zasobu User
na koncie z uprawnieniami dostępu PERFORMANCE_REPORTING
.
accounts.v1beta.accounts.users.patch
zastępuje cały zasób User
. Aby uniknąć utraty informacji, wywołaj funkcję accounts.v1beta.accounts.users.get
, aby uzyskać pełny zasób User
, a następnie podaj wszystkie pola w żądaniu accounts.v1beta.accounts.users.patch
.
Przykładowe zapytanie
Podane niżej zapytanie zwraca wartości impressions
, clicks
i click_through_rate
dla wszystkich usług na Twoim koncie w okresie 30 dni. Aby wysłać żądanie, prześlij do metody accounts.reports.search
to wyrażenie w języku zapytań Merchant Center:
SELECT impressions, clicks, click_through_rate
FROM product_performance_view
WHERE date BETWEEN '2020-12-01' AND '2020-12-30'
Więcej informacji o raportach skuteczności znajdziesz w przewodniku Różne raporty skuteczności.
Filtruj usługi
Możesz użyć interfejsu Merchant Reports API, aby wyświetlić filtrowany widok danych produktów, w tym stanów produktów.product_view
Możesz na przykład wysłać zapytanie product_view
, aby wyświetlić listę produktów, które mają problemy, lub aby uzyskać listę nowych produktów i sprawdzić ich wyświetlanie.
W klauzuli SELECT
zapytania musisz uwzględnić pole id
. Wartość parametru id
jest taka sama jak identyfikator REST produktu.
Możesz filtrować według wszystkich dostępnych pól, z wyjątkiem pola item_issues
. Odpowiedź możesz sortować według wszystkich dostępnych pól, z wyjątkiem tych:
gtin
item_issues
Oto przykład, który zwraca produkty o stanie NOT_ELIGIBLE_OR_DISAPPROVED
. Aby wysłać żądanie, prześlij ten element języka zapytań Merchant Center do metody accounts.reports.search
:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status
item_issues
FROM ProductView
WHERE aggregated_reporting_context_status = 'NOT_ELIGIBLE_OR_DISAPPROVED'
Oto przykładowa odpowiedź na poprzednie zapytanie:
{
"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 ich działaniu znajdziesz w dokumentacji dotyczącej product_view
.
Ulepszanie cen
Korzystając z widoku statystyk dotyczących cen, możesz zobaczyć sugerowane ceny promocyjne produktów oraz prognozy wyników, których możesz się spodziewać, jeśli zaktualizujesz ceny produktów. Raport ze statystykami dotyczącymi cen umożliwia skuteczniejsze wycenianie produktów.
Więcej informacji znajdziesz w artykule Poprawianie wyceny produktów za pomocą raportu na temat statystyk dotyczących cen.
Aby wyświetlić sugerowane ceny promocyjne swoich produktów, prześlij zapytanie:
price_insights_product_view
.
Oto przykład, jak wyświetlić sugerowane ceny promocyjne produktów. Aby wysłać żądanie, prześlij do metody accounts.reports.search
ten element języka zapytań Merchant Center:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversion_change_fraction
FROM price_insights_product_view
Oto przykładowa odpowiedź na poprzednie zapytanie:
{
"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"
}
}
]
}