Za pomocą Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według określonych atrybutów i ulepszać ceny.
Pomiar wyników
Za pomocą Merchant Reports API
product_performance_viewmożesz pobierać
dane o skuteczności
swojego konta.
Wymagania
Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.
Aby przypisać rolę Skuteczność i statystyki do istniejącego użytkownika, utwórz żądanie
PATCH i
przypisz użytkownikowi prawo dostępu PERFORMANCE_REPORTING. Poniższe żądanie pokazuje, jak utworzyć żądanie PATCH w celu przypisania prawa dostępu PERFORMANCE_REPORTING:
PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{EMAIL_ID}
{
"accessRights": [
"PERFORMANCE_REPORTING"
]
}
Zastąp te elementy:
- {ACCOUNT_ID}: unikalny identyfikator konta Merchant Center.
- {EMAIL_ID}: adres e-mail użytkownika, któremu chcesz przypisać rolę.
Przykładowe zapytanie
To zapytanie pobiera dane impressions, clicks i click_through_rate dla wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż to stwierdzenie w języku zapytań Merchant Center do
accounts.reports.search
metody:
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 po raportach skuteczności.
Filtruj usługi
Za pomocą Merchant Reports API's
product_view
możesz wyświetlić przefiltrowany widok danych produktów, w tym ich stanów. Możesz na przykład wysłać zapytanie do product_view, aby wyświetlić listę produktów, które mają problemy, lub uzyskać listę nowych produktów i sprawdzić, czy są wyświetlane.
W klauzuli SELECT zapytania musisz uwzględnić pole id. Pole id
ma taką samą wartość jak identyfikator REST
produktu.
Możesz filtrować według wszystkich dostępnych pól, z wyjątkiem tych:
status_per_reporting_contextitem_issues
Możesz sortować odpowiedź według wszystkich dostępnych pól z wyjątkiem tych:
gtinstatus_per_reporting_contextitem_issues
Aby sprawdzić ogólną kwalifikowalność produktu, możesz sprawdzić pole aggregated_reporting_context_status. To pole agreguje stany we wszystkich kontekstach raportowania produktu.
Oto przykład, który zwraca Twoje produkty ze zagregowanym stanem ELIGIBLE_LIMITED, co oznacza, że kwalifikują się one do wyświetlania w co najmniej 1, ale nie we wszystkich docelowych kontekstach raportowania. Możesz poprosić o szczegółowy stan produktu w kontekście raportowania i informacje o produkcie, aby dokładniej zbadać problem. Aby wysłać
żądanie, przekaż to następujące stwierdzenie w języku zapytań Merchant Center
do metody
accounts.reports.search:
SELECT
id,
offer_id,
feed_label,
title,
aggregated_reporting_context_status,
status_per_reporting_context,
item_issues
FROM product_view
WHERE aggregated_reporting_context_status = 'ELIGIBLE_LIMITED'
Oto przykładowa odpowiedź na poprzednie zapytanie:
{
"results": [
{
"productView": {
"id": "en~US~id0",
"offerId": "id0",
"feedLabel": "US",
"aggregatedReportingContextStatus": "ELIGIBLE_LIMITED",
"statusPerReportingContext": [
{
"reportingContext": "SHOPPING_ADS",
"disapprovedCountries": [
"US"
]
},
{
"reportingContext": "FREE_LISTINGS",
"approvedCountries": [
"US"
]
}
]
"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"
}
]
}
}
]
}
Aby wyświetlić szczegóły produktu w określonym kontekście raportowania, możesz użyć filtra reporting_context w klauzuli WHERE. Gdy filtrujesz według
reporting_context, aggregated_reporting_context_status jest obliczany tylko na podstawie wybranego kontekstu raportowania, a status_per_reporting_context i
item_issues zwracają tylko szczegóły dotyczące tego kontekstu.
Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule
Pola w tabeliproduct_view table.
Ulepszanie cen
W widoku statystyk dotyczących cen możesz zobaczyć sugerowane ceny promocyjne produktów i prognozy skuteczności, 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 Ulepszanie wyceniania produktów za pomocą raportu na temat statystyk dotyczących cen.
Aby wyświetlić sugerowane ceny promocyjne produktów, wyślij zapytanie do
price_insights_product_view.
Oto przykład, którego możesz użyć, aby wyświetlić sugerowane ceny promocyjne produktów. Aby
wysłać żądanie, przekaż to stwierdzenie w języku zapytań Merchant Center do
accounts.reports.search
metody:
SELECT
id,
title,
brand,
price,
suggested_price,
predicted_impressions_change_fraction,
predicted_clicks_change_fraction,
predicted_conversions_change_fraction
FROM price_insights_product_view
Oto przykładowa odpowiedź na poprzednie zapytanie:
{
"results": [
{
"priceInsightsProductView": {
"id": "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": "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": "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 zapytaniu znajdziesz w artykule Pola w tabeli priceInsightsProductView.