Za pomocą interfejsu 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ą interfejsu Merchant Reports API product_performance_view możesz pobierać wskaźniki skuteczności dla 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 poprawki i przypisz użytkownikowi prawo dostępu PERFORMANCE_REPORTING. Poniższe żądanie pokazuje, jak utworzyć żądanie poprawki, aby przypisać prawo 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 dotyczące wszystkich produktów na Twoim koncie w określonym 30-dniowym okresie. Aby wysłać żądanie, przekaż do metody accounts.reports.search to zapytanie 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 po raportach skuteczności.
Filtruj usługi
Możesz użyć metody product_view interfejsu Merchant Reports API, aby 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.
Musisz uwzględnić pole id w klauzuli SELECT zapytania. id ma taką samą wartość jak identyfikator REST produktu.
Możesz filtrować na podstawie wszystkich dostępnych pól z wyjątkiem tych:
status_per_reporting_contextitem_issues
Odpowiedź możesz posortować według wszystkich dostępnych pól z wyjątkiem tych:
gtinstatus_per_reporting_contextitem_issues
Możesz sprawdzić pole aggregated_reporting_context_status, aby dowiedzieć się, czy produkt kwalifikuje się do wyświetlania. To pole zawiera zbiorcze informacje o stanach we wszystkich kontekstach raportowania produktu.
Oto przykład, który zwraca produkty ze stanem zbiorczym ELIGIBLE_LIMITED, co oznacza, że kwalifikują się one do wyświetlania w co najmniej jednym, ale nie we wszystkich kontekstach raportowania, na które są kierowane. Możesz poprosić o szczegółowy stan produktu według kontekstu raportowania i informacje o produkcie, aby przeprowadzić dalsze analizy. Aby wysłać żądanie, przekaż do metody accounts.reports.search tę instrukcję Merchant Center Query Language:
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"
}
]
}
}
]
}
Możesz użyć filtra reporting_context w klauzuli WHERE, aby wyświetlić szczegóły produktu w konkretnym kontekście raportowania. Gdy filtrujesz według wymiaru reporting_context, wartość aggregated_reporting_context_status jest obliczana tylko na podstawie wybranego kontekstu raportowania, a wymiary status_per_reporting_context i item_issues zwracają szczegóły tylko dla tego kontekstu.
Więcej informacji o polach dostępnych w zapytaniu znajdziesz w artykule Pola w tabeli product_view.
Ulepszanie cen
W widoku statystyk dotyczących cen możesz zobaczyć sugerowane ceny promocyjne produktów i prognozy dotyczące skuteczności, jakiej 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.
Zapytanie
price_insights_product_view
, aby wyświetlić sugerowane ceny promocyjne produktów.
Oto przykładowy prompt, którego możesz użyć, aby wyświetlić sugerowane ceny sprzedaży swoich produktów. Aby wysłać żądanie, przekaż do metody accounts.reports.search tę instrukcję języka zapytań Merchant Center:
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.