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