- HTTP-запрос
- Параметры пути
- Тело запроса
- Тело ответа
- Области авторизации
- Строка отчета
- ПродуктПроизводительностьView
- МаркетингМетодЕнум
- NonProductPerformanceView
- Просмотр продукта
- Агрегатедрепортингконтекстстатус
- ПредметПроблема
- ItemIssueType
- ПунктПроблемаСерьезность
- ПроблемаSeverityPerReportingContext
- AggregatedIssueSeverity
- ПредметПроблемаРешение
- КликПотенциал
- ЦенаКонкурентоспособностьПродуктПросмотр
- PriceInsightsProductView
- Эффективность
- БестселлерыПродуктКластерПросмотр
- ОтчетГранулярностьEnum
- Статус инвентаря
- ОтносительныйДеманденум
- ОтносительныйDemandChangeTypeEnum
- БестселлерыБрендПросмотреть
- КонкурентныйВидимостьПросмотр конкурента
- Трафиксаурцеенум
- КонкурентныйVisibilityTopMerchantView
- КонкурентныйВидимостьБенчмаркПросмотр
- Попробуйте!
Получает отчет, определенный поисковым запросом. Ответ может содержать меньше строк, чем указано в pageSize
. Положитесь на nextPageToken
, чтобы определить, нужно ли запрашивать еще строки.
HTTP-запрос
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры | |
---|---|
parent | Необходимый. Идентификатор аккаунта, с которого осуществляется звонок. Должен быть отдельным аккаунтом или субаккаунтом MCA. Формат: аккаунты/{аккаунт} |
Тело запроса
Тело запроса содержит данные следующей структуры:
JSON-представление |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
Поля | |
---|---|
query | Необходимый. Запрос, определяющий извлекаемый отчет. Подробную информацию о том, как составить запрос, см. в руководстве по языку запросов. Полный список доступных таблиц и полей см. в разделе Доступные поля. |
pageSize | Необязательный. Количество |
pageToken | Необязательный. Токен страницы, которую нужно получить. Если не указано, возвращается первая страница результатов. Чтобы запросить следующую страницу результатов, следует использовать значение, полученное из |
Тело ответа
Ответное сообщение для метода ReportService.Search
.
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"results": [
{
object ( |
Поля | |
---|---|
results[] | Строки, соответствующие поисковому запросу. |
nextPageToken | Токен, который можно отправить как |
Области авторизации
Требуется следующая область действия OAuth:
-
https://www.googleapis.com/auth/content
Дополнительную информацию см. в обзоре OAuth 2.0 .
Строка отчета
Строка результата, полученная из поискового запроса.
В ответе заполняется только сообщение, соответствующее запрашиваемой таблице. В заполненном сообщении заполняются только поля, явно запрошенные в запросе.
JSON-представление |
---|
{ "productPerformanceView": { object ( |
Поля | |
---|---|
productPerformanceView | Поля, доступные для запроса в таблице |
nonProductPerformanceView | Поля, доступные для запроса в таблице |
productView | Поля, доступные для запроса в таблице |
priceCompetitivenessProductView | Поля, доступные для запроса в таблице |
priceInsightsProductView | Поля, доступные для запроса в таблице |
bestSellersProductClusterView | Поля, доступные для запроса в таблице |
bestSellersBrandView | Поля, доступные для запроса в таблице |
competitiveVisibilityCompetitorView | Поля, доступные для запроса в таблице |
competitiveVisibilityTopMerchantView | Поля, доступные для запроса в таблице |
competitiveVisibilityBenchmarkView | Поля, доступные для запроса в таблице |
ПродуктПроизводительностьView
Поля, доступные для запроса в таблице productPerformanceView
.
Данные об эффективности продукта для вашего аккаунта, включая показатели эффективности (например, clicks
) и параметры, в соответствии с которыми сегментируются показатели эффективности (например, offerId
). Значения параметров продукта, такие как offerId
, отражают состояние продукта на момент показа.
Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "date": { object ( |
Поля | |
---|---|
date | Дата в часовом поясе продавца, к которой применяются показатели. Сегмент. Условие |
week | Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент. |
conversionValue | Ценность конверсий, связанных с продуктом, указанная на дату конверсии. Метрика. Доступно только для |
marketingMethod | Маркетинговый метод, к которому применяются показатели. Сегмент. |
customerCountryCode | Код страны, где находится заказчик на момент мероприятия. Представлено в формате ISO 3166. Сегмент. Если страну клиента определить невозможно, возвращается специальный код «ZZ». |
offerId | Идентификатор товара, предоставленный продавцом. Сегмент. |
title | Название продукта. Сегмент. |
brand | Бренд продукта. Сегмент. |
categoryL1 | Категория продукта (1-й уровень) в таксономии продуктов Google. Сегмент. |
categoryL2 | Категория продукта (2-й уровень) в таксономии продуктов Google. Сегмент. |
categoryL3 | Категория продукта (3-й уровень) в таксономии продуктов Google. Сегмент. |
categoryL4 | Категория продукта (4-й уровень) в таксономии продуктов Google. Сегмент. |
categoryL5 | Категория продукта (5-й уровень) в таксономии продуктов Google. Сегмент. |
productTypeL1 | Тип продукта (1-й уровень) в собственной таксономии товаров продавца. Сегмент. |
productTypeL2 | Тип продукта (2-й уровень) в собственной таксономии товаров продавца. Сегмент. |
productTypeL3 | Тип продукта (3-й уровень) в собственной таксономии товаров продавца. Сегмент. |
productTypeL4 | Тип продукта (4-й уровень) в собственной таксономии товаров продавца. Сегмент. |
productTypeL5 | Тип продукта (5-й уровень) в собственной таксономии товаров продавца. Сегмент. |
customLabel0 | Пользовательская метка 0 для индивидуальной группировки продуктов. Сегмент. |
customLabel1 | Пользовательская этикетка 1 для индивидуальной группировки продуктов. Сегмент. |
customLabel2 | Специальная этикетка 2 для индивидуальной группировки продуктов. Сегмент. |
customLabel3 | Специальная этикетка 3 для индивидуальной группировки продуктов. Сегмент. |
customLabel4 | Пользовательская этикетка 4 для индивидуальной группировки продуктов. Сегмент. |
clicks | Количество кликов. Метрика. |
impressions | Количество показов товаров продавца. Метрика. |
clickThroughRate | Рейтинг кликов – количество кликов, полученных товарами продавца (кликов), деленное на количество показов товаров (показов). Метрика. |
conversions | Количество конверсий, связанных с продуктом, зарегистрированное на дату конверсии. В зависимости от модели атрибуции конверсия может распределяться по нескольким кликам, при этом каждому клику присваивается своя ценность. Эта метрика представляет собой сумму всех таких кредитов. Метрика. Доступно только для |
conversionRate | Количество конверсий, разделенное на количество кликов, зарегистрированное на дату показа. Метрика. Доступно только для |
МаркетингМетодЕнум
Ценности метода маркетинга.
Перечисления | |
---|---|
MARKETING_METHOD_ENUM_UNSPECIFIED | Не указан. |
ORGANIC | Органический маркетинг. |
ADS | Рекламный маркетинг. |
NonProductPerformanceView
Поля, доступные для запроса в таблице nonProductPerformanceView
.
Данные об эффективности изображений и ссылок интернет-магазинов, ведущих на страницы, не связанные с товарами. Сюда входят показатели эффективности (например, clicks
) и параметры, по которым сегментируются показатели эффективности (например, date
).
Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "date": { object ( |
Поля | |
---|---|
date | Дата в часовом поясе продавца, к которой применяются показатели. Сегмент. Условие |
week | Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент. |
clicks | Количество кликов по изображениям и ссылкам интернет-магазина, ведущим на страницы, не связанные с товарами. Метрика. |
impressions | Сколько раз были показаны изображения и ссылки интернет-магазина, ведущие на ваши страницы, не связанные с товарами. Метрика. |
clickThroughRate | Кликабельность — количество кликов ( |
Просмотр продукта
Поля, доступные для запроса в таблице productView
.
Товары в текущем наличии. Продукты в этой таблице такие же, как в суб-API «Продукты», но не все атрибуты продуктов из суб-API «Продукты» доступны для запроса в этой таблице. В отличие от суб-API «Продукты», эта таблица позволяет фильтровать возвращаемый список продуктов по атрибутам продукта. Чтобы получить один продукт по id
или перечислить все продукты, следует использовать субAPI продуктов.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "price": { object ( |
Поля | |
---|---|
price | Цена продукта. Отсутствует, если информация о цене товара отсутствует. |
gtin[] | Список глобальных номеров торговых позиций (GTIN) продукта. |
creationTime | Время, когда продавец создал товар в секундах. |
expirationDate | Срок годности продукта указан при вставке. |
itemIssues[] | Список проблем с продуктом. Это поле нельзя использовать для сортировки результатов. Для фильтрации результатов можно использовать только выбранные атрибуты этого поля (например, |
clickPotential | Предполагаемый потенциал производительности по сравнению с наиболее эффективными продуктами продавца. |
id | REST ID продукта в форме Требуется в предложении |
channel | Канал продукта. Может быть |
languageCode | Код языка продукта в формате BCP 47. |
feedLabel | Кормовая этикетка продукта. |
offerId | Идентификатор товара, предоставленный продавцом. |
title | Название продукта. |
brand | Бренд продукта. |
categoryL1 | Категория продукта (1-й уровень) в таксономии продуктов Google . |
categoryL2 | Категория продукта (2-й уровень) в таксономии продуктов Google . |
categoryL3 | Категория продукта (3-й уровень) в таксономии продуктов Google . |
categoryL4 | Категория продукта (4-й уровень) в таксономии продуктов Google . |
categoryL5 | Категория продукта (5-й уровень) в таксономии продуктов Google . |
productTypeL1 | Тип продукта (1-й уровень) в собственной таксономии товаров продавца. |
productTypeL2 | Тип продукта (2-й уровень) в собственной таксономии товаров продавца. |
productTypeL3 | Тип товара (3-й уровень) в собственной таксономии товаров продавца. |
productTypeL4 | Тип продукта (4-й уровень) в собственной таксономии товаров продавца. |
productTypeL5 | Тип продукта (5-й уровень) в собственной таксономии товаров продавца. |
condition | Состояние товара. |
availability | Доступность продукта. |
shippingLabel | Нормализованная транспортная этикетка , указанная в источнике данных. |
itemGroupId | Идентификатор группы товаров, предоставленный продавцом для группировки вариантов. |
thumbnailLink | Ссылка на обработанное изображение продукта, размещенное в инфраструктуре Google. |
aggregatedReportingContextStatus | Агрегированный статус. |
clickPotentialRank | Рейтинг продукта на основе его потенциала кликов. Продукт с |
Агрегатедрепортингконтекстстатус
Статус продукта, агрегированный для всех контекстов отчетности.
Вот пример того, как вычисляется агрегированный статус:
Бесплатные объявления | Товарные объявления | Статус |
---|---|---|
Одобренный | Одобренный | ИМЕЮЩИЙ ПРАВО |
Одобренный | В ожидании | ИМЕЮЩИЙ ПРАВО |
Одобренный | Отклонено | ELIGIBLE_LIMITED |
В ожидании | В ожидании | В ОЖИДАНИИ |
Отклонено | Отклонено | NOT_ELIGIBLE_OR_DISAPPROVED |
Перечисления | |
---|---|
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED | Не указан. |
NOT_ELIGIBLE_OR_DISAPPROVED | Продукт не соответствует критериям или отклонен для всех контекстов отчетности. |
PENDING | Статус продукта ожидает во всех контекстах отчетности. |
ELIGIBLE_LIMITED | Продукт подходит для некоторых (но не всех) контекстов отчетности. |
ELIGIBLE | Продукт подходит для всех контекстов отчетности. |
ПредметПроблема
Проблема с товаром, связанная с товаром.
JSON-представление |
---|
{ "type": { object ( |
Поля | |
---|---|
type | Тип проблемы с товаром. |
severity | Серьезность проблемы с элементом. |
resolution | Решение проблемы с товаром. |
ItemIssueType
Тип проблемы.
JSON-представление |
---|
{ "code": string, "canonicalAttribute": string } |
Поля | |
---|---|
code | Код ошибки проблемы, эквивалентный |
canonicalAttribute | Каноническое имя атрибута для проблем, связанных с атрибутом. |
ПунктПроблемаСерьезность
Как проблема влияет на подачу продукта.
JSON-представление |
---|
{ "severityPerReportingContext": [ { object ( |
Поля | |
---|---|
severityPerReportingContext[] | Серьезность проблемы в зависимости от контекста отчетности. |
aggregatedSeverity | Совокупная серьезность проблемы для всех контекстов отчетности, на которые она влияет. Это поле можно использовать для фильтрации результатов. |
ПроблемаSeverityPerReportingContext
Серьезность проблемы в зависимости от контекста отчетности.
JSON-представление |
---|
{
"disapprovedCountries": [
string
],
"demotedCountries": [
string
],
"reportingContext": enum ( |
Поля | |
---|---|
disapprovedCountries[] | Список отклоненных стран в контексте отчетности, представленный в формате ISO 3166. |
demotedCountries[] | Список пониженных стран в контексте отчетности, представленный в формате ISO 3166. |
reportingContext | Контекст отчета, к которому относится проблема. |
AggregatedIssueSeverity
Серьезность проблемы агрегирована для всех контекстов отчетности.
Перечисления | |
---|---|
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED | Не указан. |
DISAPPROVED | Проблема отклоняет продукт как минимум в одном контексте отчетности. |
DEMOTED | Проблема снижает рейтинг продукта во всех контекстах отчетности, на которые она влияет. |
PENDING | Разрешение проблемы: PENDING_PROCESSING . |
ПредметПроблемаРешение
Как решить проблему.
Перечисления | |
---|---|
ITEM_ISSUE_RESOLUTION_UNSPECIFIED | Не указан. |
MERCHANT_ACTION | Продавец должен устранить проблему. |
PENDING_PROCESSING | Проблема будет решена автоматически (например, сканированием изображения) или посредством проверки Google. Никаких действий со стороны продавца теперь не требуется. Решение может привести к другой проблеме (например, в случае сбоя сканирования). |
КликПотенциал
Потенциал кликов продукта оценивает его потенциал эффективности по сравнению с наиболее эффективными продуктами продавца. Потенциал кликов продукта помогает продавцам расставить приоритеты, какие продукты нужно исправить, и понять, насколько продукты работают в соответствии со своим потенциалом.
Перечисления | |
---|---|
CLICK_POTENTIAL_UNSPECIFIED | Влияние неизвестных прогнозируемых кликов. |
LOW | Потенциал получения меньшего количества кликов по сравнению с наиболее эффективными продуктами продавца. |
MEDIUM | Потенциал получения умеренного количества кликов по сравнению с наиболее эффективными продуктами продавца. |
HIGH | Потенциал для получения такого же количества кликов, как и у самых эффективных продуктов продавца. |
ЦенаКонкурентоспособностьПродуктПросмотр
Поля, доступные для запроса в таблице priceCompetitivenessProductView
.
Отчет о ценовой конкурентоспособности .
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "price": { object ( |
Поля | |
---|---|
price | Текущая цена товара. |
benchmarkPrice | Последняя доступная эталонная цена для каталога продуктов в эталонной стране. |
reportCountryCode | Страна ценового ориентира. Представлено в формате ISO 3166. Требуется в предложении |
id | REST ID продукта в форме Требуется в предложении |
offerId | Идентификатор товара, предоставленный продавцом. |
title | Название продукта. |
brand | Бренд продукта. |
categoryL1 | Категория продукта (1-й уровень) в таксономии продуктов Google . |
categoryL2 | Категория продукта (2-й уровень) в таксономии продуктов Google . |
categoryL3 | Категория продукта (3-й уровень) в таксономии продуктов Google . |
categoryL4 | Категория продукта (4-й уровень) в таксономии продуктов Google . |
categoryL5 | Категория продукта (5-й уровень) в таксономии продуктов Google . |
productTypeL1 | Тип продукта (1-й уровень) в собственной таксономии товаров продавца. |
productTypeL2 | Тип продукта (2-й уровень) в собственной таксономии товаров продавца. |
productTypeL3 | Тип товара (3-й уровень) в собственной таксономии товаров продавца. |
productTypeL4 | Тип продукта (4-й уровень) в собственной таксономии товаров продавца. |
productTypeL5 | Тип продукта (5-й уровень) в собственной таксономии товаров продавца. |
PriceInsightsProductView
Поля, доступные для запроса в таблице priceInsightsProductView
.
Отчет о ценах .
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "price": { object ( |
Поля | |
---|---|
price | Текущая цена товара. |
suggestedPrice | Последняя рекомендованная цена на продукт. |
effectiveness | Прогнозируемая эффективность применения ценового предложения, распределенная по сегментам. |
id | REST ID продукта в форме Требуется в предложении |
offerId | Идентификатор товара, предоставленный продавцом. |
title | Название продукта. |
brand | Бренд продукта. |
categoryL1 | Категория продукта (1-й уровень) в таксономии продуктов Google . |
categoryL2 | Категория продукта (2-й уровень) в таксономии продуктов Google . |
categoryL3 | Категория продукта (3-й уровень) в таксономии продуктов Google . |
categoryL4 | Категория продукта (4-й уровень) в таксономии продуктов Google . |
categoryL5 | Категория продукта (5-й уровень) в таксономии продуктов Google . |
productTypeL1 | Тип продукта (1-й уровень) в собственной таксономии товаров продавца. |
productTypeL2 | Тип продукта (2-й уровень) в собственной таксономии товаров продавца. |
productTypeL3 | Тип товара (3-й уровень) в собственной таксономии товаров продавца. |
productTypeL4 | Тип продукта (4-й уровень) в собственной таксономии товаров продавца. |
productTypeL5 | Тип продукта (5-й уровень) в собственной таксономии товаров продавца. |
predictedImpressionsChangeFraction | Прогнозируемое изменение количества показов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества показов на 5%. |
predictedClicksChangeFraction | Прогнозируемое изменение количества кликов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества кликов на 5%. |
predictedConversionsChangeFraction | Прогнозируемое изменение количества конверсий в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение конверсий на 5 %. |
Эффективность
Ведро прогнозируемой эффективности.
Эффективность показывает, какие продукты больше всего выиграют от изменения цен. Этот рейтинг учитывает прогнозируемое повышение производительности за счет корректировки цены продажи и разницы между вашей текущей ценой и рекомендованной ценой. Прогнозируется, что ценовые предложения с HIGH
эффективностью приведут к максимальному увеличению производительности.
Перечисления | |
---|---|
EFFECTIVENESS_UNSPECIFIED | Эффективность неизвестна. |
LOW | Эффективность низкая. |
MEDIUM | Эффективность средняя. |
HIGH | Эффективность высокая. |
БестселлерыПродуктКластерПросмотр
Поля, доступные для запроса в таблице bestSellersProductClusterView
.
Отчеты о бестселлерах с топ-группами продуктов. Кластер продуктов — это группировка различных предложений и вариантов, представляющих один и тот же продукт, например Google Pixel 7.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "reportDate": { object ( |
Поля | |
---|---|
reportDate | Дата отчета. Значение этого поля может быть только одним из следующих:
Требуется в предложении |
variantGtins[] | GTIN примерных вариантов кластера продуктов. |
reportGranularity | Детализация отчета. Рейтинг может быть составлен в течение недели или месяца. Требуется в предложении |
reportCountryCode | Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166. Требуется в предложении |
reportCategoryId | Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google . Требуется в предложении |
title | Название кластера продуктов. |
brand | Бренд продуктового кластера. |
categoryL1 | Категория продукта (1-й уровень) кластера продуктов, представленная в таксономии продуктов Google . |
categoryL2 | Категория продукта (2-й уровень) кластера продуктов, представленная в таксономии продуктов Google . |
categoryL3 | Категория продукта (3-й уровень) кластера продуктов, представленная в таксономии продуктов Google . |
categoryL4 | Категория продукта (4-й уровень) кластера продуктов, представленная в таксономии продуктов Google . |
categoryL5 | Категория продукта (5-й уровень) кластера продуктов, представленная в таксономии продуктов Google . |
inventoryStatus | Является ли кластер продуктов В этом поле не учитывается фильтр страны отчета о бестселлерах. |
brandInventoryStatus | Если в вашем источнике данных о продуктах хотя бы в одной из стран есть хотя бы один продукт бренда, который в настоящее время В этом поле не учитывается фильтр страны отчета о бестселлерах. |
rank | Популярность кластера продуктов в рекламе и на обычных поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц. |
previousRank | Рейтинг популярности за предыдущую неделю или месяц. |
relativeDemand | Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране. |
previousRelativeDemand | Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране на предыдущей неделе или месяце. |
relativeDemandChange | Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным. |
ОтчетГранулярностьEnum
Сообщите значения детализации.
Перечисления | |
---|---|
REPORT_GRANULARITY_ENUM_UNSPECIFIED | Не указан. |
WEEKLY | Отчет рассчитывается за недельный период. |
MONTHLY | Отчет рассчитывается за месячный период. |
Статус инвентаря
Статус группы продуктов или бренда в вашем инвентаре.
Перечисления | |
---|---|
INVENTORY_STATUS_UNSPECIFIED | Не указан. |
IN_STOCK | У вас есть на складе продукт для этой группы продуктов или бренда. |
OUT_OF_STOCK | У вас есть продукт для этой группы продуктов или бренда в наличии, но в настоящее время его нет в наличии. |
NOT_IN_INVENTORY | У вас нет продукта для этого кластера продуктов или бренда в наличии. |
ОтносительныйДеманденум
Относительные значения спроса.
Перечисления | |
---|---|
RELATIVE_DEMAND_ENUM_UNSPECIFIED | Не указан. |
VERY_LOW | Спрос составляет 0–5% от спроса продуктового кластера или бренда с самым высоким рейтингом. |
LOW | Спрос составляет 6-10% от спроса продуктового кластера или бренда с самым высоким рейтингом. |
MEDIUM | Спрос составляет 11-20% от спроса продуктового кластера или бренда с самым высоким рейтингом. |
HIGH | Спрос составляет 21–50% от спроса продуктового кластера или бренда с самым высоким рейтингом. |
VERY_HIGH | Спрос составляет 51-100% спроса товарного кластера или бренда с самым высоким рейтингом. |
ОтносительныйDemandChangeTypeEnum
Значения типа изменения относительного спроса.
Перечисления | |
---|---|
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED | Не указан. |
SINKER | Относительный спрос ниже, чем в предыдущий период времени. |
FLAT | Относительный спрос равен предыдущему периоду времени. |
RISER | Относительный спрос выше, чем в предыдущий период времени. |
БестселлерыБрендПросмотреть
Поля, доступные для запроса в таблице bestSellersBrandView
.
Отчеты о бестселлерах ведущих брендов.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "reportDate": { object ( |
Поля | |
---|---|
reportDate | Дата отчета. Значение этого поля может быть только одним из следующих:
Требуется в предложении |
reportGranularity | Детализация отчета. Рейтинг может быть составлен в течение недели или месяца. Требуется в предложении |
reportCountryCode | Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166. Требуется в предложении |
reportCategoryId | Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google . Требуется в предложении |
brand | Название бренда. |
rank | Популярность бренда в рекламе и на органических поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц. |
previousRank | Рейтинг популярности за предыдущую неделю или месяц. |
relativeDemand | Предполагаемый спрос по отношению к бренду с самым высоким рейтингом популярности в той же категории и стране. |
previousRelativeDemand | Предполагаемый спрос по бренду, имевшему самый высокий рейтинг популярности в той же категории и стране на предыдущей неделе или месяце. |
relativeDemandChange | Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным. |
КонкурентныйВидимостьПросмотр конкурента
Поля, доступные для запроса в таблице competitiveVisibilityCompetitorView
.
Отчет о конкурентной видимости с предприятиями с аналогичной видимостью.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "date": { object ( |
Поля | |
---|---|
date | Дата этой строки. В предложении |
domain | Домен вашего конкурента или ваш домен, если isYourDomain имеет значение true. Требуется в предложении |
isYourDomain | True, если эта строка содержит данные для вашего домена. Невозможно отфильтровать в предложении «WHERE». |
reportCountryCode | Страна, где появились впечатления. Требуется в предложении |
reportCategoryId | Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении |
trafficSource | Источник трафика показов. Требуется в предложении |
rank | Позиция домена в рейтинге аналогичных компаний по выбранным ключам ( Невозможно отфильтровать в предложении «WHERE». |
adsOrganicRatio | Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам. Невозможно отфильтровать в предложении «WHERE». |
pageOverlapRate | Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице. Невозможно отфильтровать в предложении «WHERE». |
higherPositionRate | Более высокий рейтинг позиций показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение. Невозможно отфильтровать в предложении «WHERE». |
relativeVisibility | Относительная видимость показывает, как часто показываются предложения ваших конкурентов по сравнению с вашими предложениями. Другими словами, это количество отображаемых показов у розничного продавца-конкурента, разделенное на количество отображаемых вами показов в течение выбранного диапазона времени для выбранной категории продуктов и страны. Невозможно отфильтровать в предложении «WHERE». |
Трафиксаурцеенум
Значения источника трафика.
Перечисления | |
---|---|
TRAFFIC_SOURCE_ENUM_UNSPECIFIED | Не указан. |
ORGANIC | Органический трафик. |
ADS | Трафик с рекламы. |
ALL | Органический и рекламный трафик. |
КонкурентныйVisibilityTopMerchantView
Поля, доступные для запроса в таблице competitiveVisibilityTopMerchantView
.
Отчет о конкурентной видимости с бизнесом с максимальной заметностью.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "date": { object ( |
Поля | |
---|---|
date | Дата этой строки. Невозможно выбрать в предложении |
domain | Домен вашего конкурента или ваш домен, если isYourDomain имеет значение true. Требуется в предложении |
isYourDomain | True, если эта строка содержит данные для вашего домена. Невозможно отфильтровать в предложении «WHERE». |
reportCountryCode | Страна, где появились впечатления. Требуется в предложении |
reportCategoryId | Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении |
trafficSource | Источник трафика показов. Требуется в предложении |
rank | Позиция домена в топе рейтинга продавцов по выбранным ключам ( Невозможно отфильтровать в предложении «WHERE». |
adsOrganicRatio | Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам. Невозможно отфильтровать в предложении «WHERE». |
pageOverlapRate | Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице. Невозможно отфильтровать в предложении «WHERE». |
higherPositionRate | Более высокий рейтинг позиций показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение. Невозможно отфильтровать в предложении «WHERE». |
КонкурентныйВидимостьБенчмаркПросмотр
Поля, доступные для запроса в таблице competitiveVisibilityBenchmarkView
.
Отчет о конкурентной видимости с эталоном категории.
Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.
JSON-представление |
---|
{ "date": { object ( |
Поля | |
---|---|
date | Дата этой строки. Требуется в предложении |
reportCountryCode | Страна, где появились впечатления. Требуется в предложении |
reportCategoryId | Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google . Требуется в предложении |
trafficSource | Источник трафика показов. Требуется в предложении |
yourDomainVisibilityTrend | Изменение видимости в зависимости от показов вашего домена относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами). Невозможно отфильтровать в предложении «WHERE». |
categoryBenchmarkVisibilityTrend | Изменение видимости на основе показов относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами) для объединенной группы продавцов с самой высокой видимостью, приближенной к рынку. Невозможно отфильтровать в предложении «WHERE». |