Сегментация

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

Как и в случае с пользовательскими отчетами в Merchant Center, с помощью Reporting 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 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 , etc.)

Категории из товарной таксономии 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 поддерживает две категории метрик для заказов Buy on 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

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

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