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
Za pomocą interfejsu Merchant Reports API możesz pobierać dane o skuteczności dotyczące swojego konta.product_performance_view
Wymagania
Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.
Aby przyznać kontu rolę skuteczność i statystyki, zaktualizuj za pomocą funkcji patch zasobu User
na koncie uprawnienia dostępu PERFORMANCE_REPORTING
. Aby to zrobić, zastąp cały zasób User
za pomocą zasobu accounts.v1beta.accounts.users.patch
.
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 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 product_view
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 polach dostępnych w zapytaniach znajdziesz w artykule Pola w tabeli productView
.
Ulepszanie cen
Za pomocą widoku statystyk dotyczących cen możesz sprawdzić 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 wyceniania 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"
}
}
]
}
Więcej informacji o polach dostępnych w zapytaniach znajdziesz w artykule Pola w tabeli priceInsightsProductView
.