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_l2itp.) - 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_l2itp.) - 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_microsmetrics.ordered_item_sales_microsmetrics.returns_microsmetrics.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_shipmetrics.item_fill_ratemetrics.ordered_itemsmetrics.ordered_item_sales_microsmetrics.rejected_itemsmetrics.returned_itemsmetrics.return_ratemetrics.returns_microsmetrics.shipped_itemsmetrics.shipped_item_sales_microsmetrics.unshipped_items
- dane na poziomie zamówienia,
Dane obliczane na podstawie poszczególnych zamówień.
metrics.aosmetrics.aov_microsmetrics.days_to_shipmetrics.ordersmetrics.shipped_ordersmetrics.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.brandsegments.category_l1,segments.category_l2,segments.category_l3,segments.category_l4,segments.category_l5segments.custom_label1,segments.custom_label2,segments.custom_label3,segments.custom_label4,segments.custom_label5segments.offer_idsegments.product_type_l1,segments.product_type_l2,segments.product_type_l3,segments.product_type_l4,segments.product_type_l5segments.title
Więcej informacji
Pełną listę segmentów znajdziesz w dokumentacji.