Podział na segmenty

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 programoffer_id:

SELECT
  segments.program,
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN '2020-11-01' AND '2020-11-30'

Uruchom

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_idprogram, 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_codeReportRow 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.