Za pomocą interfejsu Merchant Reports API możesz wyświetlać dane o skuteczności, filtrować produkty według konkretnych atrybutów oraz ulepszać ceny.
Pomiar wyników
Za pomocą interfejsu Merchant Reports API product_performance_view
możesz pobierać dane o skuteczności dotyczące swojego konta.
Wymagania
Aby pobrać ten raport, musisz mieć rolę Skuteczność i statystyki.
Aby przypisać rolę Skuteczność i statystyki istniejącym użytkownikom, utwórz prośbę o zmianę i przypisz użytkownikowi uprawnienie dostępu PERFORMANCE_REPORTING
. Poniższe żądanie pokazuje, jak utworzyć prośbę o zmianę kodu źródłowego 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 następujące elementy:
- {ACCOUNT_ID}: unikalny identyfikator konta Merchant Center.
- {EMAIL_ID}: adres e-mail użytkownika, któremu chcesz przypisać rolę.
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 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": "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 dotyczące skuteczności, której 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 do interfejsu price_insights_product_view
.
Oto przykład, jak wyświetlić sugerowane ceny promocyjne Twoich 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": "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 zapytaniach znajdziesz w artykule Pola w tabeli priceInsightsProductView
.