Segmentację dostępną w raportach niestandardowych Merchant Center można wdrożyć w Reporting API, dodając odpowiednie pole do zapytania. Na przykład zapytanie segments.program
spowoduje wygenerowanie raportu z wierszem dla każdego programu (reklamy produktowe, bezpłatne informacje o produktach itp.), który zawiera dane (wyświetlenia, kliknięcia itp.) dotyczące tego programu określone w klauzuli SELECT
.
Podobnie jak w przypadku raportów niestandardowych w Merchant Center, w tym samym zapytaniu możesz określić wiele segmentów za pomocą interfejsu Reporting API.
To przykładowe zapytanie pobiera kliknięcia wszystkich produktów na Twoim koncie w ciągu 30 dni, podzielone według program
i offer_id
:
SELECT
segments.program,
segments.offer_id,
metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'
Kliknij Uruchom, aby wypróbować przykład w API Explorer. Po kliknięciu Uruchom zaktualizuj w adresie URL żądania symbol zastępczy identyfikatora sprzedawcy, wpisując swój identyfikator sprzedawcy. Możesz zmodyfikować zapytanie. Aby można było użyć narzędzia API Explorer, całe zapytanie musi znajdować się w jednym wierszu.
Wynikiem wysłania tego zapytania do reports.search
jest wiersz określający kliknięcia dla każdej kombinacji offer_id
i program
, jak w tym przykładowym ciągu JSON:
{
"results": [
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12345"
},
"metrics": {
"clicks": "38"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12346"
},
"metrics": {
"clicks": "125"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12346"
},
"metrics": {
"clicks": "23"
}
},
{
"segments": {
"program": "SHOPPING_ADS",
"offerId": "12347"
},
"metrics": {
"clicks": "8"
}
},
{
"segments": {
"program": "FREE_PRODUCT_LISTING",
"offerId": "12347"
},
"metrics": {
"clicks": "3"
}
}
]
}
Kategoria i typ produktu
Język zapytań Merchant Center obsługuje segmentowanie danych według 2 grup atrybutów, które możesz zdefiniować, aby uporządkować asortyment:
- Poziomy kategorii (
segments.category_l1
,segments.category_l2
itp.) - Kategorie z mapy kategorii Google. Jeśli nie podasz kategorii, Google może przypisać ją automatycznie do Twojego produktu lub doprecyzować podaną kategorię.
- Poziomy typu produktu (
segments.product_type_l1
,segments.product_type_l2
itp.) - Typy produktów, które przypisujesz na podstawie własnego podziału na kategorie. W przeciwieństwie do poziomów kategorii nie ma wstępnie zdefiniowanego zestawu obsługiwanych wartości.
Zarówno atrybut kategoria, jak i typ produktu są uporządkowane w hierarchii z wieloma poziomami. Specyfikacja produktu oddziela poszczególne poziomy znakiem >
, ale w raportach każdy poziom hierarchii wybierasz osobno.
Załóżmy, że masz produkt z tymi poziomami typu produktu:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Raporty będą zwracać każdy poziom w osobnym polu w ten sposób:
Segment | Wartość |
---|---|
segments.product_type_l1 |
Home & Garden |
segments.product_type_l2 |
Kitchen & Dining |
segments.product_type_l3 |
Kitchen Appliances |
segments.product_type_l4 |
Refrigerators |
Dane o walucie i cenie
Pole segments.currency_code
w ReportRow
wskazuje walutę, w której zwracane są dane o cenach, np. metrics.conversion_value_micros
.
Jest to ważne dla prawidłowej interpretacji tych danych, dlatego zwrócony ReportRow
będzie automatycznie zawierać segments.currency_code
, gdy wybierzesz jeden z tych rodzajów danych o cenie.
metrics.conversion_value_micros
metrics.aov_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Dane Kup przez Google
Język zapytań Merchant Center obsługuje 2 kategorie danych dotyczących zamówień Kup przez Google: dane na poziomie produktu i dane na poziomie zamówienia.
- dane na poziomie produktu,
Dane obliczane na podstawie produktów w zamówieniach i powiązane z wymiarami produktów w każdym zamówieniu.
metrics.item_days_to_ship
metrics.item_fill_rate
metrics.ordered_items
metrics.ordered_item_sales_micros
metrics.rejected_items
metrics.returned_items
metrics.return_rate
metrics.returns_micros
metrics.shipped_items
metrics.shipped_item_sales_micros
metrics.unshipped_items
- dane na poziomie zamówienia,
Dane obliczane na podstawie poszczególnych zamówień.
metrics.aos
metrics.aov_micros
metrics.days_to_ship
metrics.orders
metrics.shipped_orders
metrics.unshipped_orders
Dane na poziomie zamówienia nie są powiązane z wymiarami produktów w poszczególnych zamówieniach.
Dane na poziomie produktu możesz wybrać w połączeniu z dowolnym dostępnym segmentem. Jeśli jednak wybierzesz dane na poziomie zamówienia w połączeniu z dowolnym z tych segmentów wymiarów produktu, operacja się nie powiedzie:
segments.brand
segments.category_l1
,segments.category_l2
,segments.category_l3
,segments.category_l4
,segments.category_l5
segments.custom_label1
,segments.custom_label2
,segments.custom_label3
,segments.custom_label4
,segments.custom_label5
segments.offer_id
segments.product_type_l1
,segments.product_type_l2
,segments.product_type_l3
,segments.product_type_l4
,segments.product_type_l5
segments.title
Więcej informacji
Pełną listę segmentów znajdziesz w dokumentacji.