REST Resource: accounts.reports

Ресурс: ReportRow

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

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

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)
  }
}
Поля
product Performance View

object ( ProductPerformanceView )

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

non Product Performance View

object ( NonProductPerformanceView )

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

product View

object ( ProductView )

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

price Competitiveness Product View

object ( PriceCompetitivenessProductView )

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

price Insights Product View

object ( PriceInsightsProductView )

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

best Sellers Product Cluster View

object ( BestSellersProductClusterView )

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

best Sellers Brand View

object ( BestSellersBrandView )

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

competitive Visibility Competitor View

object ( CompetitiveVisibilityCompetitorView )

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

competitive Visibility Top Merchant View

object ( CompetitiveVisibilityTopMerchantView )

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

competitive Visibility Benchmark View

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 )

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

conversion Value

object ( Price )

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

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

marketing Method

enum ( MarketingMethodEnum )

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

customer Country Code

string

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

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

offer Id

string

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

title

string

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

brand

string

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

category L1

string

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

category L2

string

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

category L3

string

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

category L4

string

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

category L5

string

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

product Type L1

string

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

product Type L2

string

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

product Type L3

string

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

product Type L4

string

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

product Type L5

string

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

custom Label0

string

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

custom Label1

string

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

custom Label2

string

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

custom Label3

string

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

custom Label4

string

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

clicks

string ( int64 format)

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

impressions

string ( int64 format)

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

click Through Rate

number

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

conversions

number

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

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

conversion Rate

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)

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

click Through Rate

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) продукта.

creation Time

string ( Timestamp format)

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

expiration Date

object ( Date )

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

item Issues[]

object ( ItemIssue )

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

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

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

click Potential

enum ( ClickPotential )

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

id

string

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

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

channel

enum ( ChannelEnum )

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

language Code

string

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

feed Label

string

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

offer Id

string

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

title

string

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

brand

string

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

category L1

string

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

category L2

string

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

category L3

string

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

category L4

string

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

category L5

string

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

product Type L1

string

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

product Type L2

string

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

product Type L3

string

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

product Type L4

string

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

product Type L5

string

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

condition

string

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

availability

string

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

shipping Label

string

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

item Group Id

string

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

aggregated Reporting Context Status

enum ( AggregatedReportingContextStatus )

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

click Potential Rank

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 )

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

Тип проблемы

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

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

string

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

canonical Attribute

string

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

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

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

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

object ( IssueSeverityPerReportingContext )

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

aggregated Severity

enum ( AggregatedIssueSeverity )

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

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

ПроблемаSeverityPerReportingContext

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

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

string

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

demoted Countries[]

string

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

reporting Context

enum ( ReportingContextEnum )

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

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": {
    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 )

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

benchmark Price

object ( Price )

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

report Country Code

string

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

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

id

string

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

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

offer Id

string

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

title

string

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

brand

string

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

category L1

string

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

category L2

string

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

category L3

string

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

category L4

string

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

category L5

string

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

product Type L1

string

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

product Type L2

string

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

product Type L3

string

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

product Type L4

string

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

product Type L5

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 )

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

suggested Price

object ( Price )

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

effectiveness

enum ( Effectiveness )

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

id

string

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

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

offer Id

string

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

title

string

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

brand

string

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

category L1

string

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

category L2

string

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

category L3

string

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

category L4

string

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

category L5

string

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

product Type L1

string

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

product Type L2

string

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

product Type L3

string

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

product Type L4

string

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

product Type L5

string

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

predicted Impressions Change Fraction

number

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

predicted Clicks Change Fraction

number

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

predicted Conversions Change Fraction

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)
}
Поля
report Date

object ( Date )

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

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

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

variant Gtins[]

string

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

report Granularity

enum ( ReportGranularityEnum )

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

title

string

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

brand

string

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

category L1

string

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

category L2

string

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

category L3

string

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

category L4

string

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

category L5

string

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

inventory Status

enum ( InventoryStatus )

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

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

brand Inventory Status

enum ( InventoryStatus )

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

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

rank

string ( int64 format)

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

previous Rank

string ( int64 format)

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

relative Demand

enum ( RelativeDemandEnum )

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

previous Relative Demand

enum ( RelativeDemandEnum )

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

relative Demand Change

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)
}
Поля
report Date

object ( Date )

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

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

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

report Granularity

enum ( ReportGranularityEnum )

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

brand

string

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

rank

string ( int64 format)

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

previous Rank

string ( int64 format)

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

relative Demand

enum ( RelativeDemandEnum )

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

previous Relative Demand

enum ( RelativeDemandEnum )

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

relative Demand Change

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».

is Your Domain

boolean

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

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

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

ads Organic Ratio

number

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

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

page Overlap Rate

number

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

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

higher Position Rate

number

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

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

relative Visibility

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».

is Your Domain

boolean

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

rank

string ( int64 format)

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

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

ads Organic Ratio

number

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

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

page Overlap Rate

number

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

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

higher Position Rate

number

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

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

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

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

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

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

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

object ( Date )

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

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

report Country Code

string

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

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

report Category Id

string ( int64 format)

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

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

traffic Source

enum ( TrafficSourceEnum )

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

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

your Domain Visibility Trend

number

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

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

category Benchmark Visibility Trend

number

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

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

Методы

Получает отчет, определенный поисковым запросом.