Podział na segmenty

Podział, który jest dostępny w raportach niestandardowych w Merchant Center, można zaimplementować w interfejsie API do raportowania, dodając do zapytania odpowiednie pole. Na przykład zapytanie dotyczące segments.program spowoduje wyświetlenie raportu z wierszem dla każdego programu (reklamy produktowe, bezpłatne informacje o produkcie itp.) zawierający dane (wyświetlenia, kliknięcia itp.) dotyczące tego programu zgodnie z klauzulą 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 jednym zapytaniu.

To przykładowe zapytanie pobiera kliknięcia wszystkich produktów na Twoim koncie w okresie 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 API Explorer. Gdy klikniesz Wykonaj, zaktualizuj obiekt zastępczy identyfikatora sprzedawcy w adres URL żądania, podając swój własny identyfikator. Możesz je zmodyfikować. Aby umożliwić działanie eksploratora interfejsów API, pełne zapytanie musi pozostać w 1 wierszu.

Wyniki wysyłania tego zapytania do reports.search to wiersz określający kliknięcia dla każdej kombinacji atrybutów 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"
      }
    }
  ]
}

Uwaga: pamiętaj, że liczba wierszy może znacznie się zwiększyć w przypadku każdego dodatkowego pola segmentu w zapytaniu dotyczącym raportu.

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ć swój asortyment:

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

Kategorie z mapy kategorii Google. Jeśli nie podasz żadnej wartości, Google może automatycznie przypisać kategorię do Twojego produktu lub ją zawęzić.

Poziomy typu produktu (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. W specyfikacji produktów każdy poziom jest oddzielony znakiem >, ale każdy poziom hierarchii wybiera się oddzielnie w raportach.

Rozważmy na przykład produkt o tych poziomach typu:

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

Raporty zwracają każdy poziom w osobnym polu w następujący sposób:

Podział	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.order_item_sales_micros. Jest to ważne dla prawidłowej interpretacji tych danych, dlatego zwracana wartość ReportRow będzie automatycznie zawierać parametr segments.currency_code, gdy wybierzesz jeden z poniższych wskaźników dotyczących cen.

• metrics.aov_micros
• metrics.ordered_item_sales_micros
• metrics.returns_micros
• metrics.shipped_item_sales_micros

Uwaga: możesz wyraźnie umieścić w zapytaniu segments.currency_code, aby zwiększyć przejrzystość i spójność klauzuli SELECT z każdą z nich (ReportRow).

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

dane na poziomie produktu

Dane obliczane na podstawie elementó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 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. Nie uda się jednak wybrać danych na poziomie zamówienia w połączeniu z dowolnym z tych segmentów wymiarów produktów:

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