Merchant API позволяет создавать отчеты об эффективности, например product_performance_view.
На этой странице описана структура отчетов об эффективности.
Показатели
Вы можете запрашивать показатели (например, clicks и impressions), которые хотите получить. Чтобы запросить данные об эффективности в сервисе Reports, необходимо добавить фильтр по диапазону дат.
Ниже приведен пример запроса, который возвращает одну строку с общим количеством кликов за указанный диапазон дат.
SELECT clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-21'
Вы должны указать, какие данные хотите получить. Подстановочные знаки (например, SELECT
*) возвращают ошибку.
В примере ответа ниже показано, что у продавца было 4440 кликов по всем товарам и всем методам маркетинга в период с 1 по 21 декабря 2023 года.
{
"results": [
{
"productPerformanceView": {
"clicks": "4440"
}
}
]
}
Сегменты
Для сегментирования отчетов об эффективности можно использовать поля сегментов.
Например, запрос marketing_method возвращает отчет со строкой для каждого метода маркетинга и показателями, которые вы указываете для этого метода маркетинга в пункте SELECT.
Поля сегментов могут быть атрибутами товаров (например, offer_id, brand и category) или атрибутами событий (например, date и marketing_method).
Поля сегментов работают аналогично GROUP BY в SQL. Поля сегментов разделяют выбранные показатели, группируя их по каждому сегменту в предложении SELECT.
Ниже приведен пример запроса, который возвращает количество кликов за день в порядке убывания по clicks в рамках добавленного условия диапазона дат. Возвращаются только строки, в которых хотя бы один запрошенный показатель не равен нулю.
SELECT
date,
clicks
FROM product_performance_view
WHERE date BETWEEN '2023-12-01' AND '2023-12-03'
ORDER BY clicks DESC
В примере ответа ниже показано, что 1 декабря 2023 года у продавца было 1546 кликов по всем товарам во всех методах маркетинга, а 2 декабря 2023 года – 829 кликов по всем товарам во всех методах маркетинга. 3 декабря 2023 года у продавца не было кликов, поэтому за эту дату ничего не возвращается.
{
"results": [
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 1
},
"clicks": "1546"
}
},
{
"productPerformanceView": {
"date": {
"year": 2023,
"month": 12,
"day": 2
},
"clicks": "829"
}
}
]
}
Как и в случае со специальными отчетами в Merchant Center, вы можете указать несколько сегментов в одном запросе с помощью Merchant Reports API.
Ниже приведен пример запроса, который возвращает клики по всем товарам в вашем аккаунте за 30-дневный период с сегментированием по marketing_method и offer_id.
SELECT marketing_method, offer_id, clicks
FROM product_performance_view
WHERE date BETWEEN '2023-11-01' AND '2023-11-30'
Ответ на этот запрос включает строку для каждой комбинации offer_id и marketing_method с количеством кликов для этой комбинации:
{
"results": [
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12345",
"clicks": "38"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12346",
"clicks": "125"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12346",
"clicks": "23"
}
},
{
"productPerformanceView": {
"marketingMethod": "ADS",
"offerId": "12347",
"clicks": "8"
}
},
{
"productPerformanceView": {
"marketingMethod": "ORGANIC",
"offerId": "12347",
"clicks": "3"
}
}
]
}
Категория и тип товара
Язык запросов Merchant Center поддерживает сегментирование показателей по двум группам атрибутов, которые можно задать для организации ассортимента:
- Уровни категорий
- Категории из таксономии товаров Google. Если вы не укажете категорию, Google может назначить ее автоматически или уточнить указанную вами категорию.
- Уровни типов товаров
- Типы товаров, которые вы назначаете на основе своей классификации. В отличие от уровней категорий, для этого атрибута нет набора поддерживаемых значений.
Атрибуты категории и типа товара организованы в многоуровневую иерархию. В спецификации сведений о товарах уровни разделяются символом >, но в отчетах каждый уровень иерархии выбирается отдельно.
Рассмотрим пример товара со следующими уровнями типа товара:
Home & Garden > Kitchen & Dining > Kitchen Appliances > Refrigerators
В отчетах каждый уровень представлен в отдельном поле:
| Сегмент | Значение |
|---|---|
product_type_l1 |
Home & Garden |
product_type_l2 |
Kitchen & Dining |
product_type_l3 |
Kitchen Appliances |
product_type_l4 |
Refrigerators |
Показатели валюты и цены
Показатели цены, такие как conversion_value, представлены типом Price. Если показатель доступен в нескольких валютах, значение для каждой валюты возвращается в отдельной строке. Например, следующий запрос:
SELECT conversion_value
FROM product_performance_view
WHERE date = '2023-11-01'
возвращает следующие результаты:
{
"results": [
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
Если вы запрашиваете и ценовые, и неценовые показатели, то они будут возвращены в разных строках результатов. Для каждого кода валюты будет создана отдельная строка. Например, следующий запрос:
SELECT conversions, conversion_value
FROM product_performance_view
WHERE date = '2020-11-01'
возвращает следующий ответ:
{
"results": [
{
"productPerformanceView": {
"conversions": "27",
"conversionValue": {
"amountMicros": "0",
"currencyCode": ""
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "150000000",
"currencyCode": "USD"
}
}
},
{
"productPerformanceView": {
"conversions": "0",
"conversionValue": {
"amountMicros": "70000000",
"currencyCode": "CAD"
}
}
}
]
}
В ответе возвращаются все выбранные поля, даже если их значение по-прежнему является значением по умолчанию или равно нулю.
Подробную информацию о полях, доступных для запроса, можно найти в статье Поля в таблице productPerformanceView.