Сегментация

Сегментацию, доступную в специальных отчетах Merchant Center, можно реализовать в Reporting 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 Explorer . После того, как вы нажмете «Выполнить» , обновите заполнитель идентификатора продавца, указав свой собственный идентификатор продавца в 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.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.order_item_sales_micros . Поскольку это важно для правильной интерпретации этих показателей, возвращаемый ReportRow будет автоматически включать segments.currency_code всякий раз, когда вы выбираете один из ценовых показателей ниже.

  • 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

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

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