Podział na segmenty

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'

Uruchom

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.