Сегментация

Сегментацию, доступную в пользовательских отчётах Merchant Center, можно реализовать в API отчётности, добавив соответствующее поле в запрос. Например, запрос segments.program создаёт отчёт со строкой для каждой программы (реклама товаров, бесплатные листинги товаров и т. д.), включающей метрики (показы, клики и т. д.) для этой программы, указанные в предложении 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'

Бегать

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

Результатом отправки этого запроса в 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.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

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

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