REST Resource: accounts.reports

Recurso: ReportRow

Linha de resultado retornada pela consulta de pesquisa.

Somente a mensagem correspondente à tabela consultada é preenchida na resposta. Na mensagem preenchida, apenas os campos solicitados explicitamente na consulta são preenchidos.

Representação 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)
  }
}
Campos
productPerformanceView

object (ProductPerformanceView)

Campos disponíveis para consulta na tabela productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Campos disponíveis para consulta na tabela nonProductPerformanceView.

productView

object (ProductView)

Campos disponíveis para consulta na tabela productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Campos disponíveis para consulta na tabela priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Campos disponíveis para consulta na tabela priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Campos disponíveis para consulta na tabela bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Campos disponíveis para consulta na tabela bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Campos disponíveis para consulta na tabela competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Campos disponíveis para consulta na tabela competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Campos disponíveis para consulta na tabela competitiveVisibilityBenchmarkView.

ProductPerformanceView

Campos disponíveis para consulta na tabela productPerformanceView.

Dados de performance do produto da sua conta, incluindo métricas de performance (por exemplo, clicks) e dimensões de acordo com as quais as métricas de performance são segmentadas (por exemplo, offerId). Os valores das dimensões do produto, como offerId, refletem o estado de um produto no momento da impressão.

Não é possível selecionar campos de segmento em consultas sem selecionar pelo menos um campo de métrica.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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
}
Campos
date

object (Date)

Data no fuso horário do comerciante a que as métricas se aplicam. Segmento.

A condição em date é obrigatória na cláusula WHERE.

week

object (Date)

Primeiro dia da semana (segunda-feira) da data das métricas no fuso horário do comerciante. Segmento.

conversionValue

object (Price)

Valor das conversões atribuídas ao produto, informado na data da conversão. Métrica.

Disponível apenas para a origem de tráfego FREE.

marketingMethod

enum (MarketingMethodEnum)

Método de marketing a que as métricas se aplicam. Segmento.

customerCountryCode

string

Código do país em que o cliente está no momento do evento. Representado no formato ISO 3166. Segmento.

Se não for possível determinar o país do cliente, um código especial "ZZ" será retornado.

offerId

string

ID do produto fornecido pelo comerciante. Segmento.

title

string

Título do produto. Segmento.

brand

string

Marca do produto. Segmento.

categoryL1

string

Categoria do produto (primeiro nível) na taxonomia de produtos do Google. Segmento.

categoryL2

string

Categoria do produto (2º nível) na taxonomia de produtos do Google. Segmento.

categoryL3

string

Categoria do produto (terceiro nível) na taxonomia de produtos do Google. Segmento.

categoryL4

string

Categoria do produto (quarto nível) na taxonomia de produtos do Google. Segmento.

categoryL5

string

Categoria do produto (quinto nível) na taxonomia de produtos do Google. Segmento.

productTypeL1

string

Tipo de produto (1º nível) na taxonomia de produtos do comerciante. Segmento.

productTypeL2

string

Tipo de produto (2º nível) na própria taxonomia de produtos do comerciante. Segmento.

productTypeL3

string

Tipo de produto (3º nível) na taxonomia de produtos do comerciante. Segmento.

productTypeL4

string

Tipo de produto (4º nível) na taxonomia de produtos do comerciante. Segmento.

productTypeL5

string

Tipo de produto (5º nível) na taxonomia de produtos do comerciante. Segmento.

customLabel0

string

Rótulo personalizado 0 para agrupamento personalizado de produtos. Segmento.

customLabel1

string

Rótulo personalizado 1 para agrupamento personalizado de produtos. Segmento.

customLabel2

string

Rótulo personalizado 2 para agrupamento personalizado de produtos. Segmento.

customLabel3

string

Rótulo personalizado 3 para agrupamento personalizado de produtos. Segmento.

customLabel4

string

Rótulo personalizado 4 para agrupamento personalizado de produtos. Segmento.

clicks

string (int64 format)

Número de cliques. Métrica.

impressions

string (int64 format)

Número de vezes que os produtos do comerciante são mostrados. Métrica.

clickThroughRate

number

Taxa de cliques: o número de cliques que os produtos do comerciante recebem (cliques) dividido pelo número de vezes que os produtos são mostrados (impressões). Métrica.

conversions

number

Número de conversões atribuídas ao produto, informadas na data da conversão. Dependendo do modelo de atribuição, uma conversão pode ser distribuída entre vários cliques, e cada clique recebe o próprio crédito. Essa métrica é a soma de todos esses créditos. Métrica.

Disponível apenas para a origem de tráfego FREE.

conversionRate

number

É o número de conversões dividido pelo número de cliques, informado na data da impressão. Métrica.

Disponível apenas para a origem de tráfego FREE.

MarketingMethodEnum

Valores do método de marketing.

Enums
MARKETING_METHOD_ENUM_UNSPECIFIED Não especificado.
ORGANIC Marketing orgânico.
ADS Marketing com base em anúncios.

NonProductPerformanceView

Campos disponíveis para consulta na tabela nonProductPerformanceView.

Dados de performance de imagens e links da loja on-line que levam às suas páginas que não são de produtos. Isso inclui métricas de performance (por exemplo, clicks) e dimensões de acordo com as quais as métricas de performance são segmentadas (por exemplo, date).

Não é possível selecionar campos de segmento em consultas sem selecionar pelo menos um campo de métrica.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Campos
date

object (Date)

Data no fuso horário do comerciante a que as métricas se aplicam. Segmento.

A condição em date é obrigatória na cláusula WHERE.

week

object (Date)

Primeiro dia da semana (segunda-feira) da data das métricas no fuso horário do comerciante. Segmento.

clicks

string (int64 format)

Número de cliques em imagens e links da loja on-line que levam a páginas que não são de produtos. Métrica.

impressions

string (int64 format)

Número de vezes que as imagens e os links da loja on-line que levam às suas páginas que não são de produtos foram mostrados. Métrica.

clickThroughRate

number

Taxa de cliques: é o número de cliques (clicks) dividido pelo número de impressões (impressions) de imagens e links da loja on-line que levam às suas páginas que não são de produtos. Métrica.

ProductView

Campos disponíveis para consulta na tabela productView.

Produtos no inventário atual. Os produtos nesta tabela são os mesmos da sub-API "Products", mas nem todos os atributos de produto da sub-API "Products" estão disponíveis para consulta nesta tabela. Ao contrário da sub-API de produtos, essa tabela permite filtrar a lista de produtos retornada por atributos. Para recuperar um único produto por id ou listar todos os produtos, use a sub-API "Products".

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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
}
Campos
price

object (Price)

Preço do produto. Ausente se as informações sobre o preço do produto não estiverem disponíveis.

gtin[]

string

Lista de números globais de item comercial (GTINs) do produto.

creationTime

string (Timestamp format)

A hora em que o comerciante criou o produto em segundos de carimbo de data/hora.

expirationDate

object (Date)

Data de validade do produto, especificada na inserção.

itemIssues[]

object (ItemIssue)

Lista de problemas do item do produto.

Esse campo não pode ser usado para classificar os resultados.

Apenas alguns atributos deste campo (por exemplo, itemIssues.severity.aggregated_severity) podem ser usados para filtrar os resultados.

clickPotential

enum (ClickPotential)

Potencial de performance estimado em comparação com os produtos de melhor desempenho do comerciante.

id

string

ID REST do produto no formato channel~languageCode~feedLabel~offerId. Os métodos da API Merchant que operam em produtos usam isso como parâmetro name.

Obrigatório na cláusula SELECT.

channel

enum (ChannelEnum)

Canal do produto. Pode ser ONLINE ou LOCAL.

languageCode

string

Código do idioma do produto no formato BCP 47.

feedLabel

string

Rótulo do feed do produto.

offerId

string

ID do produto fornecido pelo comerciante.

title

string

Título do produto.

brand

string

Marca do produto.

categoryL1

string

Categoria do produto (primeiro nível) na taxonomia de produtos do Google.

categoryL2

string

Categoria do produto (segundo nível) na taxonomia de produtos do Google.

categoryL3

string

Categoria do produto (terceiro nível) na taxonomia de produtos do Google.

categoryL4

string

Categoria do produto (quarto nível) na taxonomia de produtos do Google.

categoryL5

string

Categoria do produto (quinto nível) na taxonomia de produtos do Google.

productTypeL1

string

Tipo de produto (primeiro nível) na taxonomia de produtos do comerciante.

productTypeL2

string

Tipo de produto (2º nível) na taxonomia de produtos do comerciante.

productTypeL3

string

Tipo de produto (3º nível) na taxonomia de produtos do comerciante.

productTypeL4

string

Tipo de produto (4º nível) na taxonomia de produtos do comerciante.

productTypeL5

string

Tipo de produto (5º nível) na taxonomia de produtos do comerciante.

condition

string

Condição do produto.

availability

string

Disponibilidade do produto.

shippingLabel

string

Etiqueta para envio normalizada especificada na fonte de dados.

itemGroupId

string

ID do grupo de itens fornecido pelo comerciante para agrupar variantes.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Status agregado.

clickPotentialRank

string (int64 format)

Classificação do produto com base no potencial de cliques. Um produto com clickPotentialRank 1 tem o maior potencial de cliques entre os produtos do comerciante que atendem às condições da consulta de pesquisa.

AggregatedReportingContextStatus

Status do produto agregado para todos os contextos de relatório.

Confira um exemplo de como o status agregado é calculado:

Listagens gratuitas Anúncios do Shopping Status
Aprovado Aprovado QUALIFICADA
Aprovado Pendente QUALIFICADA
Aprovado Reprovado ELIGIBLE_LIMITED
Pendente Pendente PENDENTE
Reprovado Reprovado NOT_ELIGIBLE_OR_DISAPPROVED
Enums
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED Não especificado.
NOT_ELIGIBLE_OR_DISAPPROVED O produto não está qualificado ou foi reprovado em todos os contextos de relatórios.
PENDING O status do produto está pendente em todos os contextos de relatório.
ELIGIBLE_LIMITED O produto está qualificado para alguns (mas não todos) contextos de relatórios.
ELIGIBLE O produto está qualificado para todos os contextos de relatório.

ItemIssue

Problema do item associado ao produto.

Representação JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Campos
type

object (ItemIssueType)

Tipo de problema do item.

severity

object (ItemIssueSeverity)

Gravidade do problema do item.

resolution

enum (ItemIssueResolution)

Resolução do problema do item.

ItemIssueType

Tipo de problema.

Representação JSON
{
  "code": string,
  "canonicalAttribute": string
}
Campos
code

string

Código de erro do problema, equivalente ao code de Problemas no produto.

canonicalAttribute

string

Nome do atributo canônico para problemas específicos do atributo.

ItemIssueSeverity

Como o problema afeta a veiculação do produto.

Representação JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Campos
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Gravidade do problema por contexto de relatório.

aggregatedSeverity

enum (AggregatedIssueSeverity)

Gravidade agregada do problema em todos os contextos de relatórios que ele afeta.

Esse campo pode ser usado para filtrar os resultados.

IssueSeverityPerReportingContext

Gravidade do problema por contexto de relatório.

Representação JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Campos
disapprovedCountries[]

string

Lista de países reprovados no contexto do relatório, representada no formato ISO 3166.

demotedCountries[]

string

Lista de países rebaixados no contexto do relatório, representada no formato ISO 3166.

reportingContext

enum (ReportingContextEnum)

Contexto do relatório ao qual o problema se aplica.

AggregatedIssueSeverity

Gravidade do problema agregada para todos os contextos de relatório.

Enums
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED Não especificado.
DISAPPROVED O problema reprova o produto em pelo menos um contexto de relatório.
DEMOTED O problema reduz o produto em todos os contextos de relatórios que ele afeta.
PENDING A resolução do problema é PENDING_PROCESSING.

ItemIssueResolution

Como resolver o problema.

Enums
ITEM_ISSUE_RESOLUTION_UNSPECIFIED Não especificado.
MERCHANT_ACTION O comerciante precisa corrigir o problema.
PENDING_PROCESSING O problema será resolvido automaticamente (por exemplo, rastreamento de imagens) ou por uma análise do Google. Nenhuma ação do comerciante é necessária no momento. A resolução pode levar a outro problema (por exemplo, se o rastreamento falhar).

ClickPotential

O potencial de cliques de um produto estima a chance de ele receber cliques em comparação com os produtos de melhor performance do comerciante. O potencial de cliques de um produto ajuda os comerciantes a priorizar os itens a serem corrigidos e a entender o desempenho deles em relação ao potencial.

Enums
CLICK_POTENTIAL_UNSPECIFIED Impacto de cliques previstos desconhecidos.
LOW Potencial para receber um número baixo de cliques em comparação com os produtos de melhor desempenho do comerciante.
MEDIUM Potencial para receber um número moderado de cliques em comparação com os produtos de melhor desempenho do comerciante.
HIGH Potencial para receber um número de cliques semelhante ao dos produtos com a melhor performance do comerciante.

PriceCompetitivenessProductView

Campos disponíveis para consulta na tabela priceCompetitivenessProductView.

Relatório de competitividade de preço.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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
}
Campos
price

object (Price)

Preço atual do produto.

benchmarkPrice

object (Price)

Preço de mercado mais recente disponível para o catálogo do produto no país de comparação.

reportCountryCode

string

País do comparativo de mercado. Representado no formato ISO 3166.

Obrigatório na cláusula SELECT.

id

string

ID REST do produto no formato channel~languageCode~feedLabel~offerId. Pode ser usado para mesclar dados com a tabela productView.

Obrigatório na cláusula SELECT.

offerId

string

ID do produto fornecido pelo comerciante.

title

string

Título do produto.

brand

string

Marca do produto.

categoryL1

string

Categoria do produto (primeiro nível) na taxonomia de produtos do Google.

categoryL2

string

Categoria do produto (segundo nível) na taxonomia de produtos do Google.

categoryL3

string

Categoria do produto (terceiro nível) na taxonomia de produtos do Google.

categoryL4

string

Categoria do produto (quarto nível) na taxonomia de produtos do Google.

categoryL5

string

Categoria do produto (quinto nível) na taxonomia de produtos do Google.

productTypeL1

string

Tipo de produto (primeiro nível) na taxonomia de produtos do comerciante.

productTypeL2

string

Tipo de produto (2º nível) na taxonomia de produtos do comerciante.

productTypeL3

string

Tipo de produto (3º nível) na taxonomia de produtos do comerciante.

productTypeL4

string

Tipo de produto (4º nível) na taxonomia de produtos do comerciante.

productTypeL5

string

Tipo de produto (5º nível) na taxonomia de produtos do comerciante.

PriceInsightsProductView

Campos disponíveis para consulta na tabela priceInsightsProductView.

Relatório Informações de preço.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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
}
Campos
price

object (Price)

Preço atual do produto.

suggestedPrice

object (Price)

Preço sugerido mais recente para o produto.

effectiveness

enum (Effectiveness)

A eficácia prevista da aplicação da sugestão de preço, agrupada.

id

string

ID REST do produto no formato channel~languageCode~feedLabel~offerId. Pode ser usado para mesclar dados com a tabela productView.

Obrigatório na cláusula SELECT.

offerId

string

ID do produto fornecido pelo comerciante.

title

string

Título do produto.

brand

string

Marca do produto.

categoryL1

string

Categoria do produto (primeiro nível) na taxonomia de produtos do Google.

categoryL2

string

Categoria do produto (segundo nível) na taxonomia de produtos do Google.

categoryL3

string

Categoria do produto (terceiro nível) na taxonomia de produtos do Google.

categoryL4

string

Categoria do produto (quarto nível) na taxonomia de produtos do Google.

categoryL5

string

Categoria do produto (quinto nível) na taxonomia de produtos do Google.

productTypeL1

string

Tipo de produto (primeiro nível) na taxonomia de produtos do comerciante.

productTypeL2

string

Tipo de produto (2º nível) na taxonomia de produtos do comerciante.

productTypeL3

string

Tipo de produto (3º nível) na taxonomia de produtos do comerciante.

productTypeL4

string

Tipo de produto (4º nível) na taxonomia de produtos do comerciante.

productTypeL5

string

Tipo de produto (5º nível) na taxonomia de produtos do comerciante.

predictedImpressionsChangeFraction

number

Mudança prevista nas impressões como uma fração após a introdução do preço sugerido em comparação com o preço ativo atual. Por exemplo, 0,05 é um aumento previsto de 5% nas impressões.

predictedClicksChangeFraction

number

Mudança prevista nos cliques como uma fração após a introdução do preço sugerido em comparação com o preço ativo atual. Por exemplo, 0,05 é um aumento previsto de 5% nos cliques.

predictedConversionsChangeFraction

number

Mudança prevista nas conversões como uma fração após a introdução do preço sugerido em comparação com o preço ativo atual. Por exemplo, 0,05 é um aumento previsto de 5% nas conversões.

Eficácia

Intervalo de eficácia prevista.

A eficácia indica quais produtos se beneficiariam mais de mudanças de preço. Essa classificação considera o aumento da performance previsto pelo ajuste do preço promocional e a diferença entre o preço atual e o sugerido. As sugestões de preço com eficácia HIGH têm previsão de gerar o maior aumento na performance.

Enums
EFFECTIVENESS_UNSPECIFIED A eficácia é desconhecida.
LOW A eficácia é baixa.
MEDIUM A eficácia é média.
HIGH A eficácia é alta.

BestSellersProductClusterView

Campos disponíveis para consulta na tabela bestSellersProductClusterView.

Relatório Mais vendidos com os principais clusters de produtos. Um cluster de produtos é um agrupamento de diferentes ofertas e variantes que representam o mesmo produto, por exemplo, Google Pixel 7.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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)
}
Campos
reportDate

object (Date)

Data do relatório. O valor desse campo só pode ser um dos seguintes:

  • O primeiro dia da semana (segunda-feira) para relatórios semanais,
  • O primeiro dia do mês para relatórios mensais.

Obrigatório na cláusula SELECT. Se uma condição WHERE em reportDate não for especificada na consulta, o relatório semanal ou mensal mais recente disponível será retornado.

variantGtins[]

string

GTINs de exemplos de variantes do cluster de produtos.

reportGranularity

enum (ReportGranularityEnum)

Granularidade do relatório. A classificação pode ser feita em um período de uma semana ou um mês.

Obrigatório na cláusula SELECT. A condição em reportGranularity é obrigatória na cláusula WHERE.

reportCountryCode

string

País em que a classificação é calculada. Representado no formato ISO 3166.

Obrigatório na cláusula SELECT. A condição em reportCountryCode é obrigatória na cláusula WHERE.

reportCategoryId

string (int64 format)

ID da categoria Google do produto para calcular a classificação, representado na taxonomia de produtos do Google.

Obrigatório na cláusula SELECT. Se uma condição WHERE em reportCategoryId não for especificada na consulta, as classificações de todas as categorias de nível superior serão retornadas.

title

string

Título do cluster de produtos.

brand

string

Marca do cluster de produtos.

categoryL1

string

Categoria do produto (primeiro nível) do cluster de produtos, representada na taxonomia de produtos do Google.

categoryL2

string

Categoria do produto (segundo nível) do cluster de produtos, representada na taxonomia de produtos do Google.

categoryL3

string

Categoria do produto (terceiro nível) do cluster de produtos, representada na taxonomia de produtos do Google.

categoryL4

string

Categoria do produto (quarto nível) do cluster de produtos, representada na taxonomia de produtos do Google.

categoryL5

string

Categoria do produto (quinto nível) do cluster de produtos, representada na taxonomia de produtos do Google.

inventoryStatus

enum (InventoryStatus)

Indica se o cluster de produtos é IN_STOCK na sua fonte de dados de produtos em pelo menos um dos países, OUT_OF_STOCK na fonte de dados de produtos em todos os países ou NOT_IN_INVENTORY.

O campo não considera o filtro de país do relatório "Mais vendidos".

brandInventoryStatus

enum (InventoryStatus)

Se há pelo menos um produto da marca IN_STOCK na sua fonte de dados de produtos em pelo menos um dos países, se todos os produtos são OUT_OF_STOCK na sua fonte de dados de produtos em todos os países ou NOT_IN_INVENTORY.

O campo não considera o filtro de país do relatório "Mais vendidos".

rank

string (int64 format)

Popularidade do cluster de produtos em anúncios e plataformas orgânicas, na categoria e no país selecionados, com base no número estimado de unidades vendidas.

previousRank

string (int64 format)

Classificação de popularidade na semana ou no mês anterior.

relativeDemand

enum (RelativeDemandEnum)

Demanda estimada em relação ao cluster de produtos com a classificação de popularidade mais alta na mesma categoria e país.

previousRelativeDemand

enum (RelativeDemandEnum)

Demanda estimada em relação ao cluster de produtos com a classificação de popularidade mais alta na mesma categoria e país na semana ou no mês anterior.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Mudança na demanda estimada. Se ele aumentou, diminuiu ou permaneceu estável.

ReportGranularityEnum

Informar valores de granularidade.

Enums
REPORT_GRANULARITY_ENUM_UNSPECIFIED Não especificado.
WEEKLY O relatório é calculado em um período de uma semana.
MONTHLY O relatório é calculado em um período de um mês.

InventoryStatus

Status do cluster de produtos ou da marca no seu inventário.

Enums
INVENTORY_STATUS_UNSPECIFIED Não especificado.
IN_STOCK Você tem um produto para este cluster ou marca em estoque.
OUT_OF_STOCK Você tem um produto para esse cluster ou marca no inventário, mas ele está em falta.
NOT_IN_INVENTORY Você não tem um produto para este cluster ou marca no inventário.

RelativeDemandEnum

Valores de demanda relativa.

Enums
RELATIVE_DEMAND_ENUM_UNSPECIFIED Não especificado.
VERY_LOW A demanda é de 0 a 5% da demanda do cluster ou da marca de produto com a melhor classificação.
LOW A demanda é de 6 a 10% da demanda do cluster ou da marca de produto com a melhor classificação.
MEDIUM A demanda é de 11% a 20% da demanda do cluster ou da marca de produto com a melhor classificação.
HIGH A demanda é de 21% a 50% da demanda do cluster ou da marca de produto com a melhor classificação.
VERY_HIGH A demanda é de 51% a 100% da demanda do cluster ou da marca de produto com a melhor classificação.

RelativeDemandChangeTypeEnum

Valores do tipo de mudança na demanda relativa.

Enums
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED Não especificado.
SINKER A demanda relativa é menor do que no período anterior.
FLAT A demanda relativa é igual ao período anterior.
RISER A demanda relativa é maior do que no período anterior.

BestSellersBrandView

Campos disponíveis para consulta na tabela bestSellersBrandView.

Relatório Mais vendidos com as principais marcas.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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)
}
Campos
reportDate

object (Date)

Data do relatório. O valor desse campo só pode ser um dos seguintes:

  • O primeiro dia da semana (segunda-feira) para relatórios semanais,
  • O primeiro dia do mês para relatórios mensais.

Obrigatório na cláusula SELECT. Se uma condição WHERE em reportDate não for especificada na consulta, o relatório semanal ou mensal mais recente disponível será retornado.

reportGranularity

enum (ReportGranularityEnum)

Granularidade do relatório. A classificação pode ser feita em um período de uma semana ou um mês.

Obrigatório na cláusula SELECT. A condição em reportGranularity é obrigatória na cláusula WHERE.

reportCountryCode

string

País em que a classificação é calculada. Representado no formato ISO 3166.

Obrigatório na cláusula SELECT. A condição em reportCountryCode é obrigatória na cláusula WHERE.

reportCategoryId

string (int64 format)

ID da categoria Google do produto para calcular a classificação, representado na taxonomia de produtos do Google.

Obrigatório na cláusula SELECT. Se uma condição WHERE em reportCategoryId não for especificada na consulta, as classificações de todas as categorias de nível superior serão retornadas.

brand

string

Nome da marca.

rank

string (int64 format)

Popularidade da marca em anúncios e plataformas orgânicas, na categoria e no país selecionados, com base no número estimado de unidades vendidas.

previousRank

string (int64 format)

Classificação de popularidade na semana ou no mês anterior.

relativeDemand

enum (RelativeDemandEnum)

Demanda estimada em relação à marca com a classificação de popularidade mais alta na mesma categoria e país.

previousRelativeDemand

enum (RelativeDemandEnum)

Demanda estimada em relação à marca com a classificação de popularidade mais alta na mesma categoria e país na semana ou no mês anterior.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Mudança na demanda estimada. Se ele aumentou, diminuiu ou permaneceu estável.

CompetitiveVisibilityCompetitorView

Campos disponíveis para consulta na tabela competitiveVisibilityCompetitorView.

Relatório de visibilidade competitiva com empresas com visibilidade semelhante.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação 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
}
Campos
date

object (Date)

Data desta linha.

Uma condição em date é necessária na cláusula WHERE.

domain

string

Domínio do seu concorrente ou seu domínio, se "isYourDomain" for verdadeiro.

Obrigatório na cláusula SELECT. Não é possível filtrar na cláusula "WHERE".

isYourDomain

boolean

Verdadeiro se a linha contém dados do seu domínio.

Não é possível filtrar na cláusula "WHERE".

reportCountryCode

string

País em que as impressões apareceram.

Obrigatório na cláusula SELECT. Uma condição em reportCountryCode é necessária na cláusula WHERE.

reportCategoryId

string (int64 format)

ID da categoria Google do produto para calcular o relatório, representado na taxonomia de produtos do Google.

Obrigatório na cláusula SELECT. Uma condição em reportCategoryId é necessária na cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Origem do tráfego das impressões.

Obrigatório na cláusula SELECT.

rank

string (int64 format)

Posição do domínio na classificação de empresas semelhantes para as chaves selecionadas (date, reportCategoryId, reportCountryCode, trafficSource) com base nas impressões. 1 é o mais alto.

Não é possível filtrar na cláusula "WHERE".

adsOrganicRatio

number

A proporção de anúncios / orgânicos mostra a frequência com que o domínio recebe impressões de anúncios do Shopping em comparação com o tráfego orgânico. O número é arredondado e agrupado.

Não é possível filtrar na cláusula "WHERE".

pageOverlapRate

number

A taxa de sobreposição da página mostra com que frequência as ofertas de varejistas concorrentes são exibidas com as suas na mesma página.

Não é possível filtrar na cláusula "WHERE".

higherPositionRate

number

A Taxa de posição mais alta mostra com que frequência a oferta de um concorrente apareceu em uma posição mais alta na página do que a sua.

Não é possível filtrar na cláusula "WHERE".

relativeVisibility

number

A visibilidade relativa mostra a frequência com que as ofertas dos concorrentes aparecem em comparação com as suas. Em outras palavras, é o número de impressões exibidas de um varejista concorrente dividido pelo número das suas impressões exibidas durante um período selecionado para uma categoria de produtos e um país.

Não é possível filtrar na cláusula "WHERE".

TrafficSourceEnum

Valores da origem do tráfego.

Enums
TRAFFIC_SOURCE_ENUM_UNSPECIFIED Não especificado.
ORGANIC Tráfego orgânico.
ADS Tráfego de anúncios.
ALL Tráfego orgânico e de anúncios.

CompetitiveVisibilityTopMerchantView

Campos disponíveis para consulta na tabela competitiveVisibilityTopMerchantView.

Relatório de visibilidade competitiva com a empresa com maior visibilidade.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação JSON
{
  "date": {
    object (Date)
  },
  "domain": string,
  "isYourDomain": boolean,
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "rank": string,
  "adsOrganicRatio": number,
  "pageOverlapRate": number,
  "higherPositionRate": number
}
Campos
date

object (Date)

Data desta linha.

Não pode ser selecionado na cláusula SELECT. Uma condição em date é necessária na cláusula WHERE.

domain

string

Domínio do seu concorrente ou seu domínio, se "isYourDomain" for verdadeiro.

Obrigatório na cláusula SELECT. Não é possível filtrar na cláusula "WHERE".

isYourDomain

boolean

Verdadeiro se a linha contém dados do seu domínio.

Não é possível filtrar na cláusula "WHERE".

reportCountryCode

string

País em que as impressões apareceram.

Obrigatório na cláusula SELECT. Uma condição em reportCountryCode é necessária na cláusula WHERE.

reportCategoryId

string (int64 format)

ID da categoria Google do produto para calcular o relatório, representado na taxonomia de produtos do Google.

Obrigatório na cláusula SELECT. Uma condição em reportCategoryId é necessária na cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Origem do tráfego das impressões.

Obrigatório na cláusula SELECT.

rank

string (int64 format)

Posição do domínio na classificação dos principais comerciantes para as chaves selecionadas (date, reportCategoryId, reportCountryCode, trafficSource) com base nas impressões. 1 é o mais alto.

Não é possível filtrar na cláusula "WHERE".

adsOrganicRatio

number

A proporção de anúncios / orgânicos mostra a frequência com que o domínio recebe impressões de anúncios do Shopping em comparação com o tráfego orgânico. O número é arredondado e agrupado.

Não é possível filtrar na cláusula "WHERE".

pageOverlapRate

number

A taxa de sobreposição da página mostra com que frequência as ofertas de varejistas concorrentes são exibidas com as suas na mesma página.

Não é possível filtrar na cláusula "WHERE".

higherPositionRate

number

A Taxa de posição mais alta mostra com que frequência a oferta de um concorrente apareceu em uma posição mais alta na página do que a sua.

Não é possível filtrar na cláusula "WHERE".

CompetitiveVisibilityBenchmarkView

Campos disponíveis para consulta na tabela competitiveVisibilityBenchmarkView.

Relatório de visibilidade competitiva com o comparativo de mercado da categoria.

Os valores são definidos apenas para campos solicitados explicitamente na consulta de pesquisa da solicitação.

Representação JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Campos
date

object (Date)

Data desta linha.

Obrigatório na cláusula SELECT. Uma condição em date é necessária na cláusula WHERE.

reportCountryCode

string

País em que as impressões apareceram.

Obrigatório na cláusula SELECT. Uma condição em reportCountryCode é necessária na cláusula WHERE.

reportCategoryId

string (int64 format)

ID da categoria Google do produto para calcular o relatório, representado na taxonomia de produtos do Google.

Obrigatório na cláusula SELECT. Uma condição em reportCategoryId é necessária na cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Origem do tráfego das impressões.

Obrigatório na cláusula SELECT.

yourDomainVisibilityTrend

number

Mudança na visibilidade com base nas impressões do seu domínio em relação ao início do período selecionado (ou o primeiro dia com impressões diferentes de zero).

Não é possível filtrar na cláusula "WHERE".

categoryBenchmarkVisibilityTrend

number

Mudança na visibilidade com base nas impressões em relação ao início do período selecionado (ou o primeiro dia com impressões não nulas) para um conjunto combinado de comerciantes com a maior visibilidade aproximada do mercado.

Não é possível filtrar na cláusula "WHERE".

Métodos

Recupera um relatório definido por uma consulta de pesquisa.