Method: accounts.reports.search

Получает отчет, определенный поисковым запросом. Ответ может содержать меньше строк, чем указано в pageSize . Положитесь на nextPageToken , чтобы определить, нужно ли запрашивать еще строки.

HTTP-запрос

POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Необходимый. Идентификатор аккаунта, с которого осуществляется звонок. Должен быть отдельным аккаунтом или субаккаунтом MCA. Формат: аккаунты/{аккаунт}

Тело запроса

Тело запроса содержит данные следующей структуры:

JSON-представление
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Поля
query

string

Необходимый. Запрос, определяющий извлекаемый отчет.

Подробную информацию о том, как составить запрос, см. в руководстве по языку запросов. Полный список доступных таблиц и полей см. в разделе Доступные поля.

pageSize

integer

Необязательный. Количество ReportRows , которые нужно получить на одной странице. По умолчанию — 1000. Значения выше 5000 приводятся к 5000.

pageToken

string

Необязательный. Токен страницы, которую нужно получить. Если не указано, возвращается первая страница результатов. Чтобы запросить следующую страницу результатов, следует использовать значение, полученное из nextPageToken в предыдущем ответе.

Тело ответа

Ответное сообщение для метода ReportService.Search .

В случае успеха тело ответа содержит данные следующей структуры:

JSON-представление
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Поля
results[]

object ( ReportRow )

Строки, соответствующие поисковому запросу.

nextPageToken

string

Токен, который можно отправить как pageToken для получения следующей страницы. Если этот параметр опущен, последующие страницы отсутствуют.

Области авторизации

Требуется следующая область действия OAuth:

  • https://www.googleapis.com/auth/content

Дополнительную информацию см. в обзоре OAuth 2.0 .

Строка отчета

Строка результата, полученная из поискового запроса.

В ответе заполняется только сообщение, соответствующее запрашиваемой таблице. В заполненном сообщении заполняются только поля, явно запрошенные в запросе.

JSON-представление
{
  "productPerformanceView": {
    object (ProductPerformanceView)
  },
  "nonProductPerformanceView": {
    object (NonProductPerformanceView)
  },
  "productView": {
    object (ProductView)
  },
  "priceCompetitivenessProductView": {
    object (PriceCompetitivenessProductView)
  },
  "priceInsightsProductView": {
    object (PriceInsightsProductView)
  },
  "bestSellersProductClusterView": {
    object (BestSellersProductClusterView)
  },
  "bestSellersBrandView": {
    object (BestSellersBrandView)
  },
  "competitiveVisibilityCompetitorView": {
    object (CompetitiveVisibilityCompetitorView)
  },
  "competitiveVisibilityTopMerchantView": {
    object (CompetitiveVisibilityTopMerchantView)
  },
  "competitiveVisibilityBenchmarkView": {
    object (CompetitiveVisibilityBenchmarkView)
  }
}
Поля
productPerformanceView

object ( ProductPerformanceView )

Поля, доступные для запроса в таблице productPerformanceView .

nonProductPerformanceView

object ( NonProductPerformanceView )

Поля, доступные для запроса в таблице nonProductPerformanceView .

productView

object ( ProductView )

Поля, доступные для запроса в таблице productView .

priceCompetitivenessProductView

object ( PriceCompetitivenessProductView )

Поля, доступные для запроса в таблице priceCompetitivenessProductView .

priceInsightsProductView

object ( PriceInsightsProductView )

Поля, доступные для запроса в таблице priceInsightsProductView .

bestSellersProductClusterView

object ( BestSellersProductClusterView )

Поля, доступные для запроса в таблице bestSellersProductClusterView .

bestSellersBrandView

object ( BestSellersBrandView )

Поля, доступные для запроса в таблице bestSellersBrandView .

competitiveVisibilityCompetitorView

object ( CompetitiveVisibilityCompetitorView )

Поля, доступные для запроса в таблице competitiveVisibilityCompetitorView .

competitiveVisibilityTopMerchantView

object ( CompetitiveVisibilityTopMerchantView )

Поля, доступные для запроса в таблице competitiveVisibilityTopMerchantView .

competitiveVisibilityBenchmarkView

object ( CompetitiveVisibilityBenchmarkView )

Поля, доступные для запроса в таблице competitiveVisibilityBenchmarkView .

ПродуктПроизводительностьView

Поля, доступные для запроса в таблице productPerformanceView .

Данные об эффективности продукта для вашего аккаунта, включая показатели эффективности (например, clicks ) и параметры, в соответствии с которыми сегментируются показатели эффективности (например, offerId ). Значения параметров продукта, такие как offerId , отражают состояние продукта на момент показа.

Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "conversionValue": {
    object (Price)
  },
  "marketingMethod": enum (MarketingMethodEnum),
  "customerCountryCode": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number,
  "conversions": number,
  "conversionRate": number
}
Поля
date

object ( Date )

Дата в часовом поясе продавца, к которой применяются показатели. Сегмент.

Условие date необходимо в предложении WHERE .

week

object ( Date )

Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент.

conversionValue

object ( Price )

Ценность конверсий, связанных с продуктом, указанная на дату конверсии. Метрика.

Доступно только для FREE источника трафика.

marketingMethod

enum ( MarketingMethodEnum )

Маркетинговый метод, к которому применяются показатели. Сегмент.

customerCountryCode

string

Код страны, в которой находится заказчик на момент мероприятия. Представлено в формате ISO 3166. Сегмент.

Если страну клиента определить невозможно, возвращается специальный код «ZZ».

offerId

string

Идентификатор товара, предоставленный продавцом. Сегмент.

title

string

Название продукта. Сегмент.

brand

string

Бренд продукта. Сегмент.

categoryL1

string

Категория продукта (1-й уровень) в таксономии продуктов Google. Сегмент.

categoryL2

string

Категория продукта (2-й уровень) в таксономии продуктов Google. Сегмент.

categoryL3

string

Категория продукта (3-й уровень) в таксономии продуктов Google. Сегмент.

categoryL4

string

Категория продукта (4-й уровень) в таксономии продуктов Google. Сегмент.

categoryL5

string

Категория продукта (5-й уровень) в таксономии продуктов Google. Сегмент.

productTypeL1

string

Тип продукта (1-й уровень) в собственной таксономии товаров продавца. Сегмент.

productTypeL2

string

Тип продукта (2-й уровень) в собственной таксономии товаров продавца. Сегмент.

productTypeL3

string

Тип продукта (3-й уровень) в собственной таксономии товаров продавца. Сегмент.

productTypeL4

string

Тип продукта (4-й уровень) в собственной таксономии товаров продавца. Сегмент.

productTypeL5

string

Тип продукта (5-й уровень) в собственной таксономии товаров продавца. Сегмент.

customLabel0

string

Пользовательская метка 0 для индивидуальной группировки продуктов. Сегмент.

customLabel1

string

Пользовательская этикетка 1 для индивидуальной группировки продуктов. Сегмент.

customLabel2

string

Специальная этикетка 2 для индивидуальной группировки продуктов. Сегмент.

customLabel3

string

Специальная этикетка 3 для индивидуальной группировки продуктов. Сегмент.

customLabel4

string

Пользовательская этикетка 4 для индивидуальной группировки продуктов. Сегмент.

clicks

string ( int64 format)

Количество кликов. Метрика.

impressions

string ( int64 format)

Количество показов товаров продавца. Метрика.

clickThroughRate

number

Рейтинг кликов — количество кликов, полученных товарами продавца (кликов), деленное на количество показов товаров (показов). Метрика.

conversions

number

Количество конверсий, связанных с продуктом, зарегистрированное на дату конверсии. В зависимости от модели атрибуции конверсия может распределяться по нескольким кликам, при этом каждому клику присваивается своя ценность. Эта метрика представляет собой сумму всех таких кредитов. Метрика.

Доступно только для FREE источника трафика.

conversionRate

number

Количество конверсий, разделенное на количество кликов, зарегистрированное на дату показа. Метрика.

Доступно только для FREE источника трафика.

МаркетингМетодЕнум

Ценности маркетингового метода.

Перечисления
MARKETING_METHOD_ENUM_UNSPECIFIED Не указан.
ORGANIC Органический маркетинг.
ADS Маркетинг, основанный на рекламе.

NonProductPerformanceView

Поля, доступные для запроса в таблице nonProductPerformanceView .

Данные об эффективности изображений и ссылок интернет-магазинов, ведущих на страницы, не связанные с товарами. Сюда входят показатели эффективности (например, clicks ) и параметры, по которым сегментируются показатели эффективности (например, date ).

Поля сегментов нельзя выбрать в запросах, не выбрав хотя бы одно поле показателя.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Поля
date

object ( Date )

Дата в часовом поясе продавца, к которой применяются показатели. Сегмент.

Условие date необходимо в предложении WHERE .

week

object ( Date )

Первый день недели (понедельник) даты показателей в часовом поясе продавца. Сегмент.

clicks

string ( int64 format)

Количество кликов по изображениям и ссылкам интернет-магазина, ведущим на страницы, не связанные с товарами. Метрика.

impressions

string ( int64 format)

Сколько раз были показаны изображения и ссылки интернет-магазина, ведущие на ваши страницы, не связанные с товарами. Метрика.

clickThroughRate

number

Кликабельность — количество кликов ( clicks ), деленное на количество показов ( impressions ) изображений и ссылок интернет-магазина, ведущих на ваши непродуктовые страницы. Метрика.

Просмотр продукта

Поля, доступные для запроса в таблице productView .

Товары в текущем наличии. Продукты в этой таблице такие же, как в суб-API «Продукты», но не все атрибуты продуктов из суб-API «Продукты» доступны для запроса в этой таблице. В отличие от суб-API «Продукты», эта таблица позволяет фильтровать возвращаемый список продуктов по атрибутам продукта. Чтобы получить один продукт по id или перечислить все продукты, следует использовать субAPI продуктов.

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "price": {
    object (Price)
  },
  "gtin": [
    string
  ],
  "creationTime": string,
  "expirationDate": {
    object (Date)
  },
  "itemIssues": [
    {
      object (ItemIssue)
    }
  ],
  "clickPotential": enum (ClickPotential),
  "id": string,
  "channel": enum (ChannelEnum),
  "languageCode": string,
  "feedLabel": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "condition": string,
  "availability": string,
  "shippingLabel": string,
  "itemGroupId": string,
  "thumbnailLink": string,
  "aggregatedReportingContextStatus": enum (AggregatedReportingContextStatus),
  "clickPotentialRank": string
}
Поля
price

object ( Price )

Цена продукта. Отсутствует, если информация о цене товара отсутствует.

gtin[]

string

Список глобальных номеров торговых позиций (GTIN) продукта.

creationTime

string ( Timestamp format)

Время, когда продавец создал товар в секундах.

expirationDate

object ( Date )

Срок годности продукта указан при вставке.

itemIssues[]

object ( ItemIssue )

Список проблем с продуктом.

Это поле нельзя использовать для сортировки результатов.

Для фильтрации результатов можно использовать только выбранные атрибуты этого поля (например, itemIssues.severity.aggregated_severity ).

clickPotential

enum ( ClickPotential )

Предполагаемый потенциал производительности по сравнению с наиболее эффективными продуктами продавца.

id

string

REST ID продукта в форме channel~languageCode~feedLabel~offerId . Методы Merchant API, которые работают с продуктами, принимают это значение в качестве параметра name .

Требуется в предложении SELECT .

channel

enum ( ChannelEnum )

Канал продукта. Может быть ONLINE или LOCAL .

languageCode

string

Код языка продукта в формате BCP 47.

feedLabel

string

Кормовая этикетка продукта.

offerId

string

Идентификатор товара, предоставленный продавцом.

title

string

Название продукта.

brand

string

Бренд продукта.

categoryL1

string

Категория продукта (1-й уровень) в таксономии продуктов Google .

categoryL2

string

Категория продукта (2-й уровень) в таксономии продуктов Google .

categoryL3

string

Категория продукта (3-й уровень) в таксономии продуктов Google .

categoryL4

string

Категория продукта (4-й уровень) в таксономии продуктов Google .

categoryL5

string

Категория продукта (5-й уровень) в таксономии продуктов Google .

productTypeL1

string

Тип продукта (1-й уровень) в собственной таксономии товаров продавца.

productTypeL2

string

Тип продукта (2-й уровень) в собственной таксономии товаров продавца.

productTypeL3

string

Тип товара (3-й уровень) в собственной таксономии товаров продавца.

productTypeL4

string

Тип товара (4-й уровень) в собственной таксономии товаров продавца.

productTypeL5

string

Тип продукта (5-й уровень) в собственной таксономии товаров продавца.

condition

string

Состояние товара.

availability

string

Доступность продукта.

shippingLabel

string

Нормализованная транспортная этикетка , указанная в источнике данных.

itemGroupId

string

Идентификатор группы товаров, предоставленный продавцом для группировки вариантов.

aggregatedReportingContextStatus

enum ( AggregatedReportingContextStatus )

Агрегированный статус.

clickPotentialRank

string ( int64 format)

Рейтинг продукта на основе его потенциала кликов. Продукт с clickPotentialRank 1 имеет самый высокий потенциал кликов среди продуктов продавца, соответствующих условиям поискового запроса.

Агрегатедрепортингконтекстстатус

Статус продукта, агрегированный для всех контекстов отчетности.

Вот пример того, как вычисляется агрегированный статус:

Бесплатные объявления Товарные объявления Положение дел
Одобренный Одобренный ИМЕЮЩИЙ ПРАВО
Одобренный В ожидании ИМЕЮЩИЙ ПРАВО
Одобренный Отклонено ELIGIBLE_LIMITED
В ожидании В ожидании В ОЖИДАНИИ
Отклонено Отклонено NOT_ELIGIBLE_OR_DISAPPROVED
Перечисления
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Не указан.
NOT_ELIGIBLE_OR_DISAPPROVED Продукт не соответствует критериям или отклонен для всех контекстов отчетности.
PENDING Статус продукта ожидает во всех контекстах отчетности.
ELIGIBLE_LIMITED Продукт подходит для некоторых (но не всех) контекстов отчетности.
ELIGIBLE Продукт подходит для всех контекстов отчетности.

ПредметПроблема

Проблема с товаром, связанная с товаром.

JSON-представление
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Поля
type

object ( ItemIssueType )

Тип проблемы с товаром.

severity

object ( ItemIssueSeverity )

Серьезность проблемы с элементом.

resolution

enum ( ItemIssueResolution )

Решение проблемы с товаром.

ItemIssueType

Тип проблемы.

JSON-представление
{
  "code": string,
  "canonicalAttribute": string
}
Поля
code

string

Код ошибки проблемы, эквивалентный code проблемы с Продуктом .

canonicalAttribute

string

Каноническое имя атрибута для проблем, связанных с атрибутом.

ПунктПроблемаСерьезность

Как проблема влияет на подачу продукта.

JSON-представление
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Поля
severityPerReportingContext[]

object ( IssueSeverityPerReportingContext )

Серьезность проблемы в зависимости от контекста отчетности.

aggregatedSeverity

enum ( AggregatedIssueSeverity )

Совокупная серьезность проблемы для всех контекстов отчетности, на которые она влияет.

Это поле можно использовать для фильтрации результатов.

ПроблемаSeverityPerReportingContext

Серьезность проблемы в зависимости от контекста отчетности.

JSON-представление
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Поля
disapprovedCountries[]

string

Список отклоненных стран в контексте отчетности, представленный в формате ISO 3166.

demotedCountries[]

string

Список пониженных стран в контексте отчетности, представленный в формате ISO 3166.

reportingContext

enum ( ReportingContextEnum )

Контекст отчета, к которому относится проблема.

Агрегированная проблема

Серьезность проблемы агрегирована для всех контекстов отчетности.

Перечисления
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": {
    object (Price)
  },
  "reportCountryCode": string,
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string
}
Поля
price

object ( Price )

Текущая цена товара.

benchmarkPrice

object ( Price )

Последняя доступная эталонная цена для каталога продуктов в эталонной стране.

reportCountryCode

string

Страна ценового ориентира. Представлено в формате ISO 3166.

Требуется в предложении SELECT .

id

string

REST ID продукта в форме channel~languageCode~feedLabel~offerId . Может использоваться для объединения данных с таблицей productView .

Требуется в предложении SELECT .

offerId

string

Идентификатор товара, предоставленный продавцом.

title

string

Название продукта.

brand

string

Бренд продукта.

categoryL1

string

Категория продукта (1-й уровень) в таксономии продуктов Google .

categoryL2

string

Категория продукта (2-й уровень) в таксономии продуктов Google .

categoryL3

string

Категория продукта (3-й уровень) в таксономии продуктов Google .

categoryL4

string

Категория продукта (4-й уровень) в таксономии продуктов Google .

categoryL5

string

Категория продукта (5-й уровень) в таксономии продуктов Google .

productTypeL1

string

Тип продукта (1-й уровень) в собственной таксономии товаров продавца.

productTypeL2

string

Тип продукта (2-й уровень) в собственной таксономии товаров продавца.

productTypeL3

string

Тип товара (3-й уровень) в собственной таксономии товаров продавца.

productTypeL4

string

Тип товара (4-й уровень) в собственной таксономии товаров продавца.

productTypeL5

string

Тип продукта (5-й уровень) в собственной таксономии товаров продавца.

PriceInsightsProductView

Поля, доступные для запроса в таблице priceInsightsProductView .

Отчет о ценах .

Значения задаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "price": {
    object (Price)
  },
  "suggestedPrice": {
    object (Price)
  },
  "effectiveness": enum (Effectiveness),
  "id": string,
  "offerId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "productTypeL1": string,
  "productTypeL2": string,
  "productTypeL3": string,
  "productTypeL4": string,
  "productTypeL5": string,
  "predictedImpressionsChangeFraction": number,
  "predictedClicksChangeFraction": number,
  "predictedConversionsChangeFraction": number
}
Поля
price

object ( Price )

Текущая цена товара.

suggestedPrice

object ( Price )

Последняя рекомендованная цена на продукт.

effectiveness

enum ( Effectiveness )

Прогнозируемая эффективность применения ценового предложения, распределенная по сегментам.

id

string

REST ID продукта в форме channel~languageCode~feedLabel~offerId . Может использоваться для объединения данных с таблицей productView .

Требуется в предложении SELECT .

offerId

string

Идентификатор товара, предоставленный продавцом.

title

string

Название продукта.

brand

string

Бренд продукта.

categoryL1

string

Категория продукта (1-й уровень) в таксономии продуктов Google .

categoryL2

string

Категория продукта (2-й уровень) в таксономии продуктов Google .

categoryL3

string

Категория продукта (3-й уровень) в таксономии продуктов Google .

categoryL4

string

Категория продукта (4-й уровень) в таксономии продуктов Google .

categoryL5

string

Категория продукта (5-й уровень) в таксономии продуктов Google .

productTypeL1

string

Тип продукта (1-й уровень) в собственной таксономии товаров продавца.

productTypeL2

string

Тип продукта (2-й уровень) в собственной таксономии товаров продавца.

productTypeL3

string

Тип товара (3-й уровень) в собственной таксономии товаров продавца.

productTypeL4

string

Тип товара (4-й уровень) в собственной таксономии товаров продавца.

productTypeL5

string

Тип продукта (5-й уровень) в собственной таксономии товаров продавца.

predictedImpressionsChangeFraction

number

Прогнозируемое изменение количества показов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества показов на 5%.

predictedClicksChangeFraction

number

Прогнозируемое изменение количества кликов в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение количества кликов на 5%.

predictedConversionsChangeFraction

number

Прогнозируемое изменение количества конверсий в виде доли после введения предложенной цены по сравнению с текущей активной ценой. Например, 0,05 — это прогнозируемое увеличение конверсий на 5 %.

Эффективность

Ведро прогнозируемой эффективности.

Эффективность показывает, какие продукты больше всего выиграют от изменения цен. Этот рейтинг учитывает повышение производительности, прогнозируемое за счет корректировки цены продажи и разницы между вашей текущей ценой и рекомендованной ценой. Прогнозируется, что ценовые предложения с HIGH эффективностью приведут к максимальному увеличению производительности.

Перечисления
EFFECTIVENESS_UNSPECIFIED Эффективность неизвестна.
LOW Эффективность низкая.
MEDIUM Эффективность средняя.
HIGH Эффективность высокая.

БестселлерыПродуктКластерПросмотр

Поля, доступные для запроса в таблице bestSellersProductClusterView .

Отчеты о бестселлерах с топ-группами продуктов. Кластер продуктов — это группировка различных предложений и вариантов, представляющих один и тот же продукт, например Google Pixel 7.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "reportDate": {
    object (Date)
  },
  "variantGtins": [
    string
  ],
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "title": string,
  "brand": string,
  "categoryL1": string,
  "categoryL2": string,
  "categoryL3": string,
  "categoryL4": string,
  "categoryL5": string,
  "inventoryStatus": enum (InventoryStatus),
  "brandInventoryStatus": enum (InventoryStatus),
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Поля
reportDate

object ( Date )

Дата отчета. Значение этого поля может быть только одним из следующих:

  • Первый день недели (понедельник) для еженедельных отчетов.
  • Первый день месяца для ежемесячных отчетов.

Требуется в предложении SELECT . Если в запросе не указано условие WHERE для reportDate , возвращается последний доступный еженедельный или ежемесячный отчет.

variantGtins[]

string

GTIN примерных вариантов кластера продуктов.

reportGranularity

enum ( ReportGranularityEnum )

Детализация отчета. Рейтинг может быть составлен в течение недели или месяца.

Требуется в предложении SELECT . Условие reportGranularity необходимо указать в предложении WHERE .

reportCountryCode

string

Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166.

Требуется в предложении SELECT . Условие для reportCountryCode является обязательным в предложении WHERE .

reportCategoryId

string ( int64 format)

Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google .

Требуется в предложении SELECT . Если в запросе не указано условие WHERE для reportCategoryId , возвращаются рейтинги для всех категорий верхнего уровня.

title

string

Название кластера продуктов.

brand

string

Бренд продуктового кластера.

categoryL1

string

Категория продукта (1-й уровень) кластера продуктов, представленная в таксономии продуктов Google .

categoryL2

string

Категория продукта (2-й уровень) кластера продуктов, представленная в таксономии продуктов Google .

categoryL3

string

Категория продукта (3-й уровень) кластера продуктов, представленная в таксономии продуктов Google .

categoryL4

string

Категория продуктов (4-й уровень) кластера продуктов, представленная в таксономии продуктов Google .

categoryL5

string

Категория продукта (5-й уровень) кластера продуктов, представленная в таксономии продуктов Google .

inventoryStatus

enum ( InventoryStatus )

Является ли кластер продуктов IN_STOCK в вашем источнике данных о продуктах хотя бы в одной из стран, OUT_OF_STOCK в вашем источнике данных о продуктах во всех странах или вообще NOT_IN_INVENTORY .

В этом поле не учитывается фильтр страны отчета о бестселлерах.

brandInventoryStatus

enum ( InventoryStatus )

Если в вашем источнике данных о продуктах хотя бы в одной из стран есть хотя бы один продукт бренда, который в настоящее время IN_STOCK , все продукты в вашем источнике данных о продуктах во всех странах имеют OUT_OF_STOCK или NOT_IN_INVENTORY .

В этом поле не учитывается фильтр страны отчета о бестселлерах.

rank

string ( int64 format)

Популярность кластера продуктов в рекламе и на обычных поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц.

previousRank

string ( int64 format)

Рейтинг популярности за предыдущую неделю или месяц.

relativeDemand

enum ( RelativeDemandEnum )

Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране.

previousRelativeDemand

enum ( RelativeDemandEnum )

Предполагаемый спрос по отношению к кластеру продуктов с самым высоким рейтингом популярности в той же категории и стране на предыдущей неделе или месяце.

relativeDemandChange

enum ( RelativeDemandChangeTypeEnum )

Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным.

ОтчетГранулярность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 (Date)
  },
  "reportGranularity": enum (ReportGranularityEnum),
  "reportCountryCode": string,
  "reportCategoryId": string,
  "brand": string,
  "rank": string,
  "previousRank": string,
  "relativeDemand": enum (RelativeDemandEnum),
  "previousRelativeDemand": enum (RelativeDemandEnum),
  "relativeDemandChange": enum (RelativeDemandChangeTypeEnum)
}
Поля
reportDate

object ( Date )

Дата отчета. Значение этого поля может быть только одним из следующих:

  • Первый день недели (понедельник) для еженедельных отчетов.
  • Первый день месяца для ежемесячных отчетов.

Требуется в предложении SELECT . Если в запросе не указано условие WHERE для reportDate , возвращается последний доступный еженедельный или ежемесячный отчет.

reportGranularity

enum ( ReportGranularityEnum )

Детализация отчета. Рейтинг может быть составлен в течение недели или месяца.

Требуется в предложении SELECT . Условие reportGranularity необходимо указать в предложении WHERE .

reportCountryCode

string

Страна, в которой рассчитывается рейтинг. Представлено в формате ISO 3166.

Требуется в предложении SELECT . Условие для reportCountryCode является обязательным в предложении WHERE .

reportCategoryId

string ( int64 format)

Идентификатор категории продукта Google для расчета рейтинга, представленный в таксономии продуктов Google .

Требуется в предложении SELECT . Если в запросе не указано условие WHERE для reportCategoryId , возвращаются рейтинги для всех категорий верхнего уровня.

brand

string

Название бренда.

rank

string ( int64 format)

Популярность бренда в рекламе и на органических поверхностях в выбранной категории и стране на основе предполагаемого количества проданных единиц.

previousRank

string ( int64 format)

Рейтинг популярности за предыдущую неделю или месяц.

relativeDemand

enum ( RelativeDemandEnum )

Предполагаемый спрос по отношению к бренду с самым высоким рейтингом популярности в той же категории и стране.

previousRelativeDemand

enum ( RelativeDemandEnum )

Предполагаемый спрос по бренду, имевшему самый высокий рейтинг популярности в той же категории и стране на предыдущей неделе или месяце.

relativeDemandChange

enum ( RelativeDemandChangeTypeEnum )

Изменение предполагаемого спроса. Поднялся ли он, опустился или остался ровным.

КонкурентныйВидимостьПросмотр конкурента

Поля, доступные для запроса в таблице competitiveVisibilityCompetitorView .

Отчет о конкурентной видимости с компаниями с аналогичной видимостью.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number,
  "relativeVisibility": number
}
Поля
date

object ( Date )

Дата этой строки.

В предложении WHERE необходимо указать date .

domain

string

Домен вашего конкурента или ваш домен, если isYourDomain имеет значение true.

Требуется в предложении SELECT . Невозможно отфильтровать в предложении «WHERE».

isYourDomain

boolean

True, если эта строка содержит данные для вашего домена.

Невозможно отфильтровать в предложении «WHERE».

reportCountryCode

string

Страна, где появились впечатления.

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие для reportCountryCode .

reportCategoryId

string ( int64 format)

Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google .

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие для reportCategoryId .

trafficSource

enum ( TrafficSourceEnum )

Источник трафика показов.

Требуется в предложении SELECT .

rank

string ( int64 format)

Позиция домена в рейтинге аналогичных компаний по выбранным ключам ( date , reportCategoryId , reportCountryCode , trafficSource ) на основе показов. 1 – самый высокий.

Невозможно отфильтровать в предложении «WHERE».

adsOrganicRatio

number

Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам.

Невозможно отфильтровать в предложении «WHERE».

pageOverlapRate

number

Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице.

Невозможно отфильтровать в предложении «WHERE».

higherPositionRate

number

Более высокий рейтинг позиции показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение.

Невозможно отфильтровать в предложении «WHERE».

relativeVisibility

number

Относительная видимость показывает, как часто показываются предложения ваших конкурентов по сравнению с вашими предложениями. Другими словами, это количество отображаемых показов у ​​розничного продавца-конкурента, разделенное на количество отображаемых вами показов в течение выбранного диапазона времени для выбранной категории продуктов и страны.

Невозможно отфильтровать в предложении «WHERE».

Трафиксаурцеенум

Значения источника трафика.

Перечисления
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Не указан.
ORGANIC Органический трафик.
ADS Трафик с рекламы.
ALL Органический и рекламный трафик.

КонкурентныйVisibilityTopMerchantView

Поля, доступные для запроса в таблице competitiveVisibilityTopMerchantView .

Отчет о конкурентной видимости с бизнесом с максимальной заметностью.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Поля
date

object ( Date )

Дата этой строки.

Невозможно выбрать в предложении SELECT . В предложении WHERE необходимо указать date .

domain

string

Домен вашего конкурента или ваш домен, если isYourDomain имеет значение true.

Требуется в предложении SELECT . Невозможно отфильтровать в предложении «WHERE».

isYourDomain

boolean

True, если эта строка содержит данные для вашего домена.

Невозможно отфильтровать в предложении «WHERE».

reportCountryCode

string

Страна, где появились впечатления.

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие для reportCountryCode .

reportCategoryId

string ( int64 format)

Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google .

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие reportCategoryId .

trafficSource

enum ( TrafficSourceEnum )

Источник трафика показов.

Требуется в предложении SELECT .

rank

string ( int64 format)

Позиция домена в топе рейтинга продавцов по выбранным ключам ( date , reportCategoryId , reportCountryCode , trafficSource ) на основе показов. 1 – самый высокий.

Невозможно отфильтровать в предложении «WHERE».

adsOrganicRatio

number

Соотношение «Объявления/органический» показывает, как часто домен получает показы товарных объявлений по сравнению с органическим трафиком. Число округляется и распределяется по сегментам.

Невозможно отфильтровать в предложении «WHERE».

pageOverlapRate

number

Коэффициент перекрытия страниц показывает, как часто предложения конкурирующих розничных продавцов отображаются вместе с вашими предложениями на одной странице.

Невозможно отфильтровать в предложении «WHERE».

higherPositionRate

number

Более высокий рейтинг позиции показывает, как часто предложение конкурента занимало более высокую позицию на странице, чем ваше предложение.

Невозможно отфильтровать в предложении «WHERE».

КонкурентныйВидимостьЭталонПросмотр

Поля, доступные для запроса в таблице competitiveVisibilityBenchmarkView .

Отчет о конкурентной видимости с эталоном категории.

Значения устанавливаются только для полей, явно запрошенных в поисковом запросе запроса.

JSON-представление
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Поля
date

object ( Date )

Дата этой строки.

Требуется в предложении SELECT . В предложении WHERE необходимо указать date .

reportCountryCode

string

Страна, где появились впечатления.

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие для reportCountryCode .

reportCategoryId

string ( int64 format)

Идентификатор категории продукта Google, для которой необходимо рассчитать отчет, представленный в таксономии продуктов Google .

Требуется в предложении SELECT . В предложении WHERE необходимо указать условие reportCategoryId .

trafficSource

enum ( TrafficSourceEnum )

Источник трафика показов.

Требуется в предложении SELECT .

yourDomainVisibilityTrend

number

Изменение видимости в зависимости от показов вашего домена относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами).

Невозможно отфильтровать в предложении «WHERE».

categoryBenchmarkVisibilityTrend

number

Изменение видимости на основе показов относительно начала выбранного временного диапазона (или первого дня с ненулевыми показами) для объединенной группы продавцов с самой высокой видимостью, приближенной к рынку.

Невозможно отфильтровать в предложении «WHERE».