Сегментация, доступная в пользовательских отчетах 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
Узнать больше
Полный список сегментов можно найти в документации .