Podział na segmenty

Podział na segmenty, dostępny w raportach niestandardowych w Merchant Center, można wdrożyć w interfejsie API do raportowania, dodając do zapytania odpowiednie pole. Na przykład zapytanie segments.program spowoduje utworzenie raportu zawierającego wiersz dla każdego programu (reklamy produktowe, bezpłatne informacje o produkcie itp.) zawierający dane (wyświetlenia, kliknięcia itp.) dla tego programu zgodnie z klauzulą SELECT.

Podobnie jak w przypadku raportów niestandardowych w Merchant Center, możesz określić wiele segmentów w jednym zapytaniu za pomocą interfejsu API do raportowania.

To przykładowe zapytanie pobiera kliknięcia dla wszystkich produktów na Twoim koncie w ciągu 30 dni 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 Eksploratorze interfejsów API. Gdy klikniesz Wykonaj, zaktualizuj obiekt zastępczy identyfikatora sprzedawcy w adresie URL żądania na swój własny identyfikator sprzedawcy. Możesz je zmodyfikować. Aby można było pracować z Eksploratorem interfejsów API, pełne zapytanie musi pozostać w jednym wierszu.

Wynikiem wysłania tego zapytania do reports.search jest wiersz określający kliknięcia dla każdej kombinacji atrybutów offer_id i program, tak jak w tym przykładowym ciągu znaków 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ń w Merchant Center obsługuje segmentowanie danych według 2 grup atrybutów, które możesz zdefiniować, by uporządkować swój asortyment:

Poziomy kategorii (segments.category_l1, segments.category_l2 itp.)

Kategorie z mapy kategorii Google. Jeśli żadna nie zostanie podana, Google może automatycznie przypisać kategorię do Twojego produktu lub zawęzić podaną kategorię.

Poziomy typów produktów (segments.product_type_l1, segments.product_type_l2 itp.)

Typy produktów przypisywane przez Ciebie na podstawie własnej kategoryzacji. W przeciwieństwie do poziomów kategorii nie ma wstępnie zdefiniowanego zestawu obsługiwanych wartości.

Atrybuty kategorii i typu produktu są uporządkowane w hierarchii o wielu poziomach. Specyfikacja produktu oddziela każdy poziom znakiem >, ale w raportach poszczególne poziomy hierarchii należy wybierać oddzielnie.

Weźmy na przykład produkt o następujących poziomach typu:

Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators

Raporty zawierają każdy poziom w osobnym polu w następujący 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 dotyczące waluty i cen

Pole segments.currency_code elementu ReportRow wskazuje walutę, w której zwracane są dane dotyczące cen, takie jak metrics.conversion_value_micros. Jest to ważne do prawidłowej interpretacji tych danych, dlatego zwracana wartość ReportRow będzie automatycznie uwzględniać parametr segments.currency_code za każdym razem, gdy wybierzesz jeden z poniższych rodzajów danych dotyczących cen.

• 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ń w 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.

dane na poziomie produktu

Dane obliczane na podstawie produktów w zamówieniach 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

dane na poziomie zamówienia

Dane obliczane dla 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 produktu w połączeniu z dowolnym dostępnym segmentem. Jednak wybranie danych na poziomie zamówienia w połączeniu z którymkolwiek z tych segmentów wymiarów produktów nie powiedzie się:

• 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.