Segmentację, dostępną w raportach niestandardowych Merchant Center, można wdrożyć w interfejsie API do raportowania, dodając do zapytania odpowiednie pole. Na przykład zapytanie o pole segments.program
skutkuje wygenerowaniem raportu z wierszem dla każdego programu (reklamy produktowe, bezpłatne informacje o produkcie itp.) zawierającym dane (wyświetlenia, kliknięcia itp.) dotyczące tego programu zgodnie z opisem w klauzuli SELECT
.
Podobnie jak w przypadku raportów niestandardowych w Merchant Center, za pomocą interfejsu API do raportowania możesz określić wiele segmentów w tym samym zapytaniu.
To przykładowe zapytanie pobiera kliknięcia wszystkich produktów na koncie z 30-dniowego okresu podzielone na segmenty według atrybutów 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 narzędziu API Explorer. Po kliknięciu Wykonaj zaktualizuj obiekt zastępczy identyfikatora sprzedawcy w adresie URL żądania, podając swój własny identyfikator sprzedawcy. Możesz zmodyfikować zapytanie. Pełne zapytanie musi pozostać w jednym wierszu, aby mogło działać z API Explorer.
Wyniki wysłania tego zapytania do reports.search
to 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 segmentację danych według 2 grup atrybutów, które możesz zdefiniować w celu uporządkowania asortymentu:
- Poziomy kategorii (
segments.category_l1
,segments.category_l2
itp.) - Kategorie z mapy kategorii Google. Jeśli nie podasz żadnej kategorii, Google może automatycznie przypisać ją do Twojego produktu lub dokładniej sprecyzować podaną kategorię.
- Poziomy typów produktów (
segments.product_type_l1
,segments.product_type_l2
itp.) - Typy produktów, które przypisujesz na podstawie swojej kategoryzacji. W przeciwieństwie do poziomów kategorii nie ma wstępnie zdefiniowanego zbioru obsługiwanych wartości.
Zarówno atrybuty kategorii, jak i typu produktu są uporządkowane w wielu poziomach w hierarchii. Specyfikacja produktu dzieli każdy poziom znakiem >
, ale każdy poziom hierarchii wybierasz oddzielnie w raportach.
Rozważmy na przykład produkt o następujących poziomach typów produktów:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
Każdy poziom zostanie zwrócony w osobnym polu w ten sposób:
Segmenty | 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 walutach i cenach
Pole segments.currency_code
w elemencie ReportRow
wskazuje walutę, w której są zwracane dane o cenach, takie jak metrics.conversion_value_micros
.
Jest to istotne dla prawidłowej interpretacji tych danych, dlatego zwrócona wartość ReportRow
będzie automatycznie zawierać segments.currency_code
, gdy wybierzesz jeden z poniższych rodzajów danych o cenach.
metrics.conversion_value_micros
metrics.aov_micros
metrics.ordered_item_sales_micros
metrics.returns_micros
metrics.shipped_item_sales_micros
Dane dotyczące Kup przez Google
Język zapytań Merchant Center obsługuje 2 kategorie danych w przypadku zamówień w Kup przez Google: dane na poziomie produktu i dane na poziomie zamówienia.
- danych na poziomie produktu
Dane obliczane na podstawie elementów w zamówieniu i powiązane z wymiarami produktów w poszczególnych zamówieniach.
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
- danych 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.
Możesz wybrać dane na poziomie elementu w połączeniu z dowolnymi dostępnymi segmentami. Jednak wybranie danych na poziomie zamówienia w połączeniu z dowolnymi z poniższych segmentów wymiarów produktów zakończy się niepowodzeniem:
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.