Сегментация

Сегментация, доступная в пользовательских отчетах Merchant Center, может быть реализована в API отчетов путем добавления соответствующего поля в запрос. Например, запрос segments.program приводит к отчету со строкой для каждой программы (Shopping Ads, Free product listings и т. д.), которая включает метрики (показы, клики и т. д.) для этой программы, как указано в предложении SELECT .

Как и в случае с пользовательскими отчетами в Merchant Center, с помощью API отчетов можно указать несколько сегментов в одном запросе.

Следующий пример запроса извлекает клики по всем продуктам в вашей учетной записи за 30-дневный период, сегментированные по program и offer_id :

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

Бегать

Нажмите Run , чтобы попробовать пример в API Explorer . После нажатия Run обновите заполнитель идентификатора продавца на свой собственный идентификатор продавца в URL-адресе запроса. Вы можете изменить запрос. Полный запрос должен оставаться на одной строке для работы с API Explorer .

Результатом отправки этого запроса в reports.search является строка, указывающая клики для каждой комбинации offer_id и program , как в этом примере строки 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"
      }
    }
  ]
}

Категория и тип продукта

Язык запросов Merchant Center поддерживает сегментацию показателей по двум группам атрибутов, которые вы можете определить для организации своего инвентаря:

Уровни категорий ( segments.category_l1 , segments.category_l2 и т.д.)
Категории из таксономии продуктов Google . Google может автоматически назначить категорию вашему продукту, если она не была указана, или дополнительно уточнить указанную категорию.
Уровни типа продукта ( segments.product_type_l1 , segments.product_type_l2 и т. д.)
Типы продуктов, которые вы назначаете на основе вашей категоризации . В отличие от уровней категорий, нет предопределенного набора поддерживаемых значений.

Атрибуты категории и типа продукта организованы в иерархию с несколькими уровнями. Спецификация продукта разделяет каждый уровень символом > , но вы выбираете каждый уровень иерархии отдельно в отчетах.

Например, рассмотрим продукт со следующими уровнями типа продукта:

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

Отчеты будут возвращать каждый уровень в отдельном поле следующим образом:

Сегмент Ценить
segments.product_type_l1 Home & Garden
segments.product_type_l2 Kitchen & Dining
segments.product_type_l3 Kitchen Appliances
segments.product_type_l4 Refrigerators

Валютные и ценовые метрики

Поле segments.currency_code ReportRow указывает валюту, в которой возвращаются метрики цены, такие как metrics.conversion_value_micros . Поскольку это важно для правильной интерпретации этих метрик, возвращаемый ReportRow будет автоматически включать segments.currency_code всякий раз, когда вы выбираете одну из метрик цены ниже.

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

Метрики «Купить в Google»

Язык запросов Merchant Center поддерживает две категории показателей для заказов «Купить через Google»: показатели на уровне товара и показатели на уровне заказа.

метрики на уровне элемента

Показатели, рассчитанные на основе позиций в заказах и связанные с размерами позиций в каждом заказе.

  • 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
метрики на уровне заказа

Показатели рассчитываются для каждого заказа.

  • metrics.aos
  • metrics.aov_micros
  • metrics.days_to_ship
  • metrics.orders
  • metrics.shipped_orders
  • metrics.unshipped_orders

Показатели на уровне заказа не связаны с размерами товаров в каждом заказе.

Вы можете выбрать метрики уровня элемента в сочетании с любым доступным сегментом. Однако выбор метрик уровня заказа в сочетании с любым из следующих сегментов измерения продукта не сработает:

  • 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

Узнать больше

Полный список сегментов можно найти в документации .