REST Resource: accounts.reports

Recurso: ReportRow

Es la fila de resultados que se muestra a partir de la búsqueda.

Solo se propaga en la respuesta el mensaje correspondiente a la tabla consultada. Dentro del mensaje propagado, solo se propagan los campos solicitados explícitamente en la consulta.

Representación 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 disponibles para la consulta en la tabla productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Campos disponibles para la consulta en la tabla nonProductPerformanceView.

productView

object (ProductView)

Campos disponibles para la consulta en la tabla productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Campos disponibles para la consulta en la tabla priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Campos disponibles para la consulta en la tabla priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Campos disponibles para la consulta en la tabla bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Campos disponibles para la consulta en la tabla bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Campos disponibles para la consulta en la tabla competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Campos disponibles para la consulta en la tabla competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Campos disponibles para la consulta en la tabla competitiveVisibilityBenchmarkView.

ProductPerformanceView

Campos disponibles para la consulta en la tabla productPerformanceView.

Datos de rendimiento de los productos de tu cuenta, incluidas las métricas de rendimiento (por ejemplo, clicks) y las dimensiones según las cuales se segmentan las métricas de rendimiento (por ejemplo, offerId). Los valores de las dimensiones de productos, como offerId, reflejan el estado de un producto en el momento de la impresión.

No se pueden seleccionar campos de segmento en las consultas sin seleccionar al menos un campo de métrica.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación

La condición en date es obligatoria en la cláusula WHERE.

week

object (Date)

Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio. Segmentación

conversionValue

object (Price)

Es el valor de las conversiones atribuidas al producto, que se informa en la fecha de conversión. Métrica.

Disponible solo para la fuente de tráfico de FREE.

marketingMethod

enum (MarketingMethodEnum)

Es el método de marketing al que se aplican las métricas. Segmentación

customerCountryCode

string

Es el código del país en el que se encuentra el cliente en el momento del evento. Se representa en formato ISO 3166. Segmentación

Si no se puede determinar el país del cliente, se muestra un código especial "ZZ".

offerId

string

Es el ID del producto que proporcionó el comercio. Segmentación

title

string

Título del producto. Segmentación

brand

string

Es la marca del producto. Segmentación

categoryL1

string

Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google. Segmentación

categoryL2

string

Categoría de producto (2º nivel) en la taxonomía de productos de Google. Segmentación

categoryL3

string

Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google. Segmentación

categoryL4

string

Categoría de producto (4º nivel) en la taxonomía de productos de Google. Segmentación

categoryL5

string

Categoría de producto (5º nivel) en la taxonomía de productos de Google. Segmentación

productTypeL1

string

Tipo de producto (1ᵉʳ nivel) en la taxonomía de productos del comercio Segmentación

productTypeL2

string

Tipo de producto (2ᵒ nivel) en la taxonomía de productos del comercio Segmentación

productTypeL3

string

Tipo de producto (tercer nivel) en la taxonomía de productos del comercio Segmentación

productTypeL4

string

Tipo de producto (4° nivel) en la taxonomía de productos del comercio Segmentación

productTypeL5

string

Tipo de producto (5ᵉʳ nivel) en la taxonomía de productos del comercio Segmentación

customLabel0

string

Etiqueta personalizada 0 para la agrupación personalizada de productos. Segmentación

customLabel1

string

Etiqueta personalizada 1 para la agrupación personalizada de productos. Segmentación

customLabel2

string

Etiqueta personalizada 2 para la agrupación personalizada de productos. Segmentación

customLabel3

string

Etiqueta personalizada 3 para la agrupación personalizada de productos. Segmentación

customLabel4

string

Etiqueta personalizada 4 para la agrupación personalizada de productos. Segmentación

clicks

string (int64 format)

Cantidad de clics. Métrica.

impressions

string (int64 format)

Cantidad de veces que se muestran los productos del comercio. Métrica.

clickThroughRate

number

Tasa de clics: Es la cantidad de clics que reciben los productos del comercio (clics) dividida por la cantidad de veces que se muestran los productos (impresiones). Métrica.

conversions

number

Es la cantidad de conversiones atribuidas al producto, registradas en la fecha de la conversión. Según el modelo de atribución, una conversión puede distribuirse en varios clics, en los que cada clic recibe su propio crédito asignado. Esta métrica es la suma de todos esos créditos. Métrica.

Disponible solo para la fuente de tráfico de FREE.

conversionRate

number

Es la cantidad de conversiones dividida por la cantidad de clics, que se informa en la fecha de la impresión. Métrica.

Disponible solo para la fuente de tráfico de FREE.

MarketingMethodEnum

Valores del método de marketing

Enumeraciones
MARKETING_METHOD_ENUM_UNSPECIFIED No se especifica.
ORGANIC Marketing orgánico.
ADS Marketing basado en anuncios.

NonProductPerformanceView

Campos disponibles para la consulta en la tabla nonProductPerformanceView.

Datos de rendimiento sobre las imágenes y los vínculos a tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos Esto incluye las métricas de rendimiento (por ejemplo, clicks) y las dimensiones según las cuales se segmentan las métricas de rendimiento (por ejemplo, date).

No se pueden seleccionar campos de segmento en las consultas sin seleccionar al menos un campo de métrica.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación JSON
{
  "date": {
    object (Date)
  },
  "week": {
    object (Date)
  },
  "clicks": string,
  "impressions": string,
  "clickThroughRate": number
}
Campos
date

object (Date)

Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación

La condición en date es obligatoria en la cláusula WHERE.

week

object (Date)

Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio. Segmentación

clicks

string (int64 format)

Es la cantidad de clics en las imágenes y los vínculos de la tienda en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.

impressions

string (int64 format)

Es la cantidad de veces que se mostraron las imágenes y los vínculos a tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.

clickThroughRate

number

Tasa de clics: Es la cantidad de clics (clicks) dividida por la cantidad de impresiones (impressions) de imágenes y vínculos a tiendas en línea que dirigen a los usuarios a tus páginas que no son de productos. Métrica.

ProductView

Campos disponibles para la consulta en la tabla productView.

Productos del inventario actual. Los productos de esta tabla son los mismos que los de la subAPI de Products, pero no todos los atributos de productos de la subAPI de Products están disponibles para consultarse en esta tabla. A diferencia de la sub-API de Products, esta tabla permite filtrar la lista de productos que se muestra por atributos. Para recuperar un solo producto por id o mostrar todos los productos, se debe usar la sub-API de Products.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Precio del producto. No se incluye si la información sobre el precio del producto no está disponible.

gtin[]

string

Es la lista de los códigos comerciales globales de artículo (GTIN) del producto.

creationTime

string (Timestamp format)

Es la hora en que el comercio creó el producto, expresada en segundos de marca de tiempo.

expirationDate

object (Date)

Es la fecha de vencimiento del producto, especificada en la inserción.

itemIssues[]

object (ItemIssue)

Es la lista de problemas de los artículos del producto.

Este campo no se puede usar para ordenar los resultados.

Solo se pueden usar los atributos seleccionados de este campo (por ejemplo, itemIssues.severity.aggregated_severity) para filtrar los resultados.

clickPotential

enum (ClickPotential)

Es el potencial de rendimiento estimado en comparación con los productos con mejor rendimiento del comercio.

id

string

Es el ID de REST del producto, con el formato channel~languageCode~feedLabel~offerId. Los métodos de la API de Merchant que operan en productos toman esto como su parámetro name.

Es obligatorio en la cláusula SELECT.

channel

enum (ChannelEnum)

Canal del producto. Puede ser ONLINE o LOCAL.

languageCode

string

Es el código de idioma del producto en formato BCP 47.

feedLabel

string

Es la etiqueta del feed del producto.

offerId

string

Es el ID del producto que proporcionó el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL2

string

Categoría de producto (2º nivel) en la taxonomía de productos de Google.

categoryL3

string

Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL4

string

Categoría de producto (4º nivel) en la taxonomía de productos de Google.

categoryL5

string

Categoría de producto (5º nivel) en la taxonomía de productos de Google.

productTypeL1

string

Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.

productTypeL2

string

Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.

productTypeL3

string

Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio.

productTypeL4

string

Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.

productTypeL5

string

Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.

condition

string

Estado del producto.

availability

string

Disponibilidad del producto.

shippingLabel

string

Etiqueta de envío normalizada especificada en la fuente de datos.

itemGroupId

string

Es el ID de grupo de artículos que proporciona el comercio para agrupar las variantes.

aggregatedReportingContextStatus

enum (AggregatedReportingContextStatus)

Estado agregado.

clickPotentialRank

string (int64 format)

Es la clasificación del producto según su potencial de clics. Un producto con clickPotentialRank 1 tiene el mayor potencial de clics entre los productos del comercio que cumplen con las condiciones de la búsqueda.

AggregatedReportingContextStatus

Es el estado del producto agregado para todos los contextos de informes.

Este es un ejemplo de cómo se calcula el estado agregado:

Fichas gratuitas Anuncios de Shopping Estado
Aprobada Aprobada APTA
Aprobada Pendiente APTA
Aprobada Rechazado ELIGIBLE_LIMITED
Pendiente Pendiente PENDIENTE
Rechazado Rechazado NOT_ELIGIBLE_OR_DISAPPROVED
Enumeraciones
AGGREGATED_REPORTING_CONTEXT_STATUS_UNSPECIFIED No se especifica.
NOT_ELIGIBLE_OR_DISAPPROVED El producto no es apto o se rechazó para todos los contextos de informes.
PENDING El estado del producto está pendiente en todos los contextos de informes.
ELIGIBLE_LIMITED El producto es apto para algunos (pero no todos) los contextos de informes.
ELIGIBLE El producto es apto para todos los contextos de informes.

ItemIssue

Es el problema del artículo asociado con el producto.

Representación JSON
{
  "type": {
    object (ItemIssueType)
  },
  "severity": {
    object (ItemIssueSeverity)
  },
  "resolution": enum (ItemIssueResolution)
}
Campos
type

object (ItemIssueType)

Tipo de problema del artículo.

severity

object (ItemIssueSeverity)

Gravedad del problema del artículo

resolution

enum (ItemIssueResolution)

Resolución de problemas de artículos

ItemIssueType

Tipo de problema.

Representación JSON
{
  "code": string,
  "canonicalAttribute": string
}
Campos
code

string

Es el código de error del problema, equivalente al code de Problemas del producto.

canonicalAttribute

string

Es el nombre del atributo canónico para problemas específicos de atributos.

ItemIssueSeverity

Cómo afecta el problema a la publicación del producto

Representación JSON
{
  "severityPerReportingContext": [
    {
      object (IssueSeverityPerReportingContext)
    }
  ],
  "aggregatedSeverity": enum (AggregatedIssueSeverity)
}
Campos
severityPerReportingContext[]

object (IssueSeverityPerReportingContext)

Gravedad del problema por contexto de informes

aggregatedSeverity

enum (AggregatedIssueSeverity)

Gravedad agregada del problema en todos los contextos de informes que afecta.

Este campo se puede usar para filtrar los resultados.

IssueSeverityPerReportingContext

Gravedad del problema por contexto de informes

Representación JSON
{
  "disapprovedCountries": [
    string
  ],
  "demotedCountries": [
    string
  ],
  "reportingContext": enum (ReportingContextEnum)
}
Campos
disapprovedCountries[]

string

Es una lista de países rechazados en el contexto de informes, representada en formato ISO 3166.

demotedCountries[]

string

Lista de países que descendieron en el contexto de informes, representadas en formato ISO 3166.

reportingContext

enum (ReportingContextEnum)

Es el contexto de informes al que se aplica el problema.

AggregatedIssueSeverity

Gravedad del problema agregada para todos los contextos de informes.

Enumeraciones
AGGREGATED_ISSUE_SEVERITY_UNSPECIFIED No se especifica.
DISAPPROVED El problema rechaza el producto en al menos un contexto de informes.
DEMOTED El problema degrada el producto en todos los contextos de informes que afecta.
PENDING La resolución del problema es PENDING_PROCESSING.

ItemIssueResolution

Cómo resolver el problema

Enumeraciones
ITEM_ISSUE_RESOLUTION_UNSPECIFIED No se especifica.
MERCHANT_ACTION El comercio debe solucionar el problema.
PENDING_PROCESSING El problema se resolverá automáticamente (por ejemplo, rastreo de imágenes) o mediante una revisión de Google. No es necesario que el comercio realice ninguna acción en este momento. La resolución podría generar otro problema (por ejemplo, si falla el rastreo).

ClickPotential

El potencial de clics de un producto es un cálculo de su potencial de rendimiento en comparación con los productos del comercio que tienen el mejor rendimiento. El potencial de clics de un producto ayuda a los comercios a priorizar los productos que deben corregir y comprender su rendimiento en función de su potencial.

Enumeraciones
CLICK_POTENTIAL_UNSPECIFIED Impacto desconocido de los clics previstos.
LOW Posibilidad de recibir una cantidad baja de clics en comparación con los productos de mejor rendimiento del comercio
MEDIUM Posibilidad de recibir una cantidad moderada de clics en comparación con los productos de mejor rendimiento del comercio.
HIGH Posibilidad de recibir una cantidad de clics similar a la de los productos con mejor rendimiento del comercio

PriceCompetitivenessProductView

Campos disponibles para la consulta en la tabla priceCompetitivenessProductView.

Informe de competitividad de los precios.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Es el precio actual del producto.

benchmarkPrice

object (Price)

El precio de referencia más reciente disponible para el catálogo del producto en el país de referencia

reportCountryCode

string

Es el país de las comparativas de precios. Se representa en formato ISO 3166.

Es obligatorio en la cláusula SELECT.

id

string

Es el ID de REST del producto, con el formato channel~languageCode~feedLabel~offerId. Se puede usar para unir datos con la tabla productView.

Es obligatorio en la cláusula SELECT.

offerId

string

Es el ID del producto que proporcionó el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL2

string

Categoría de producto (2º nivel) en la taxonomía de productos de Google.

categoryL3

string

Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL4

string

Categoría de producto (4º nivel) en la taxonomía de productos de Google.

categoryL5

string

Categoría de producto (5º nivel) en la taxonomía de productos de Google.

productTypeL1

string

Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.

productTypeL2

string

Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.

productTypeL3

string

Tipo de producto (tercer nivel) en la taxonomía de productos del comercio

productTypeL4

string

Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.

productTypeL5

string

Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.

PriceInsightsProductView

Campos disponibles para la consulta en la tabla priceInsightsProductView.

Informe Información sobre precios.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Es el precio actual del producto.

suggestedPrice

object (Price)

Es el precio sugerido más reciente para el producto.

effectiveness

enum (Effectiveness)

Es la eficacia prevista de aplicar la sugerencia de precio, agrupada.

id

string

Es el ID de REST del producto, con el formato channel~languageCode~feedLabel~offerId. Se puede usar para unir datos con la tabla productView.

Es obligatorio en la cláusula SELECT.

offerId

string

Es el ID del producto que proporcionó el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

Categoría de producto (1ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL2

string

Categoría de producto (2º nivel) en la taxonomía de productos de Google.

categoryL3

string

Categoría de producto (3ᵉʳ nivel) en la taxonomía de productos de Google.

categoryL4

string

Categoría de producto (4º nivel) en la taxonomía de productos de Google.

categoryL5

string

Categoría de producto (5º nivel) en la taxonomía de productos de Google.

productTypeL1

string

Es el tipo de producto (primer nivel) en la taxonomía de productos del comercio.

productTypeL2

string

Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio.

productTypeL3

string

Tipo de producto (tercer nivel) en la taxonomía de productos del comercio

productTypeL4

string

Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio.

productTypeL5

string

Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio.

predictedImpressionsChangeFraction

number

Es el cambio previsto en las impresiones como fracción después de introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es un aumento previsto del 5% en las impresiones.

predictedClicksChangeFraction

number

Es el cambio previsto en los clics como fracción después de introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es un aumento previsto del 5% en los clics.

predictedConversionsChangeFraction

number

Es el cambio previsto en las conversiones como una fracción después de introducir el precio sugerido en comparación con el precio activo actual. Por ejemplo, 0.05 es un aumento previsto del 5% en las conversiones).

Efectividad

Intervalo de eficacia previsto

La eficacia indica qué productos se beneficiarían más de los cambios de precio. En esta calificación, se tiene en cuenta el aumento del rendimiento que se predice ajustando el precio de oferta y la diferencia entre tus precios actuales y los sugeridos. Se prevé que las sugerencias de precios con una eficacia de HIGH generarán el mayor aumento en el rendimiento.

Enumeraciones
EFFECTIVENESS_UNSPECIFIED Se desconoce la eficacia.
LOW La eficacia es baja.
MEDIUM La eficacia es media.
HIGH La eficacia es alta.

BestSellersProductClusterView

Campos disponibles para la consulta en la tabla bestSellersProductClusterView.

Informe Más vendidos con los clústeres de productos principales Un clúster de productos es una agrupación de diferentes ofertas y variantes que representan el mismo producto, por ejemplo, Google Pixel 7.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Fecha del informe. El valor de este campo solo puede ser uno de los siguientes:

  • El primer día de la semana (lunes) para los informes semanales,
  • El primer día del mes para los informes mensuales.

Es obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportDate en la consulta, se muestra el informe semanal o mensual más reciente disponible.

variantGtins[]

string

Los GTIN de las variantes de ejemplo del clúster de productos

reportGranularity

enum (ReportGranularityEnum)

Nivel de detalle del informe. La clasificación se puede realizar en un período de una semana o un mes.

Obligatorio en la cláusula SELECT. La condición en reportGranularity es obligatoria en la cláusula WHERE.

reportCountryCode

string

Es el país en el que se calcula la clasificación. Se representa en formato ISO 3166.

Es obligatorio en la cláusula SELECT. La condición en reportCountryCode es obligatoria en la cláusula WHERE.

reportCategoryId

string (int64 format)

Es el ID de la categoría de producto de Google para el que se calcula la clasificación, representado en la taxonomía de productos de Google.

Es obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportCategoryId en la consulta, se muestran las clasificaciones de todas las categorías de nivel superior.

title

string

Es el título del clúster de productos.

brand

string

Es la marca del clúster de productos.

categoryL1

string

Es la categoría de producto (1ᵉʳ nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL2

string

Es la categoría de producto (2º nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL3

string

Es la categoría de producto (3ᵉʳ nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL4

string

Es la categoría de producto (4º nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL5

string

Es la categoría de producto (5º nivel) del clúster de productos, representada en la taxonomía de productos de Google.

inventoryStatus

enum (InventoryStatus)

Si el clúster de productos es IN_STOCK en tu fuente de datos de productos en al menos uno de los países, OUT_OF_STOCK en tu fuente de datos de productos en todos los países o NOT_IN_INVENTORY en absoluto

El campo no considera el filtro del país del informe de los más vendidos.

brandInventoryStatus

enum (InventoryStatus)

Si hay al menos un producto de la marca que actualmente tiene el estado IN_STOCK en tu fuente de datos de productos en al menos uno de los países, si todos los productos tienen el estado OUT_OF_STOCK en tu fuente de datos de productos en todos los países o si el estado es NOT_IN_INVENTORY.

El campo no considera el filtro del país del informe de los más vendidos.

rank

string (int64 format)

Popularidad del clúster de productos en los anuncios y las plataformas orgánicas, en la categoría y el país seleccionados, según la cantidad estimada de unidades vendidas

previousRank

string (int64 format)

Clasificación por popularidad en la semana o el mes anteriores

relativeDemand

enum (RelativeDemandEnum)

Es la demanda estimada en relación con el clúster de productos con la clasificación de popularidad más alta en la misma categoría y el mismo país.

previousRelativeDemand

enum (RelativeDemandEnum)

Es la demanda estimada en relación con el clúster de productos con la clasificación de popularidad más alta en la misma categoría y el mismo país en la semana o el mes anteriores.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Cambio en la demanda estimada. Si aumentó, disminuyó o se mantuvo estable.

ReportGranularityEnum

Informa los valores de nivel de detalle.

Enumeraciones
REPORT_GRANULARITY_ENUM_UNSPECIFIED No se especifica.
WEEKLY El informe se calcula durante un período de una semana.
MONTHLY El informe se calcula en un período de un mes.

InventoryStatus

Estado del clúster de productos o la marca en tu inventario.

Enumeraciones
INVENTORY_STATUS_UNSPECIFIED No se especifica.
IN_STOCK Tienes un producto de este clúster de productos o marca en stock.
OUT_OF_STOCK Tienes un producto para este clúster o marca de productos en el inventario, pero actualmente está agotado.
NOT_IN_INVENTORY No tienes un producto para este clúster de productos o marca en el inventario.

RelativeDemandEnum

Valores de demanda relativa

Enumeraciones
RELATIVE_DEMAND_ENUM_UNSPECIFIED No se especifica.
VERY_LOW La demanda es de entre un 0% y un 5% de la demanda del clúster o la marca de productos con la clasificación más alta.
LOW La demanda es de entre un 6% y un 10% de la demanda del clúster o la marca de productos con la clasificación más alta.
MEDIUM La demanda es de entre el 11% y el 20% de la demanda del clúster o la marca de productos con la clasificación más alta.
HIGH La demanda es de entre el 21% y el 50% de la demanda del clúster o la marca de productos con la clasificación más alta.
VERY_HIGH La demanda es de entre el 51% y el 100% de la demanda del clúster o la marca de productos con la clasificación más alta.

RelativeDemandChangeTypeEnum

Valores del tipo de cambio relativo en la demanda.

Enumeraciones
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED No se especifica.
SINKER La demanda relativa es inferior al período anterior.
FLAT La demanda relativa es igual al período anterior.
RISER La demanda relativa es superior al período anterior.

BestSellersBrandView

Campos disponibles para la consulta en la tabla bestSellersBrandView.

Informe Más vendidos con las marcas principales.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Fecha del informe. El valor de este campo solo puede ser uno de los siguientes:

  • El primer día de la semana (lunes) para los informes semanales,
  • El primer día del mes para los informes mensuales.

Es obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportDate en la consulta, se muestra el informe semanal o mensual más reciente disponible.

reportGranularity

enum (ReportGranularityEnum)

Nivel de detalle del informe. La clasificación se puede realizar en un período de una semana o un mes.

Obligatorio en la cláusula SELECT. La condición en reportGranularity es obligatoria en la cláusula WHERE.

reportCountryCode

string

Es el país en el que se calcula la clasificación. Se representa en formato ISO 3166.

Es obligatorio en la cláusula SELECT. La condición en reportCountryCode es obligatoria en la cláusula WHERE.

reportCategoryId

string (int64 format)

Es el ID de la categoría de producto de Google para el que se calcula la clasificación, representado en la taxonomía de productos de Google.

Es obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportCategoryId en la consulta, se muestran las clasificaciones de todas las categorías de nivel superior.

brand

string

Es el nombre de la marca.

rank

string (int64 format)

La popularidad de la marca en los anuncios y las plataformas orgánicas, en la categoría y el país seleccionados, según la cantidad estimada de unidades vendidas

previousRank

string (int64 format)

Clasificación por popularidad en la semana o el mes anteriores

relativeDemand

enum (RelativeDemandEnum)

Es la demanda estimada en relación con la marca que tiene la clasificación de popularidad más alta en la misma categoría y el mismo país.

previousRelativeDemand

enum (RelativeDemandEnum)

Es la demanda estimada en relación con la marca que tiene la clasificación de popularidad más alta en la misma categoría y el mismo país en la semana o el mes anterior.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Cambio en la demanda estimada. Si aumentó, disminuyó o se mantuvo estable.

CompetitiveVisibilityCompetitorView

Campos disponibles para la consulta en la tabla competitiveVisibilityCompetitorView.

Informe Visibilidad de competencia con empresas que tienen una visibilidad similar.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Es la fecha de esta fila.

Se requiere una condición en date en la cláusula WHERE.

domain

string

Es el dominio de tu competidor o el tuyo, si "isYourDomain" es verdadero.

Es obligatorio en la cláusula SELECT. No se puede filtrar en la cláusula "WHERE".

isYourDomain

boolean

Es verdadero si esta fila contiene datos de tu dominio.

No se puede filtrar en la cláusula "WHERE".

reportCountryCode

string

País en el que aparecieron las impresiones.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCountryCode en la cláusula WHERE.

reportCategoryId

string (int64 format)

Es el ID de la categoría de producto de Google para el que se calcula el informe, representado en la taxonomía de productos de Google.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCategoryId en la cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Es la fuente de tráfico de las impresiones.

Es obligatorio en la cláusula SELECT.

rank

string (int64 format)

Es la posición del dominio en la clasificación de empresas similares para las claves seleccionadas (date, reportCategoryId, reportCountryCode, trafficSource) según las impresiones. 1 es el más alto.

No se puede filtrar en la cláusula "WHERE".

adsOrganicRatio

number

La proporción de anuncios y de búsqueda orgánica muestra la frecuencia con la que el dominio recibe impresiones de los anuncios de Shopping en comparación con el tráfico orgánico. El número se redondea y se agrupa.

No se puede filtrar en la cláusula "WHERE".

pageOverlapRate

number

El porcentaje de superposición en la página muestra la frecuencia con la que se muestran las ofertas de los minoristas que compiten con las tuyas en la misma página.

No se puede filtrar en la cláusula "WHERE".

higherPositionRate

number

El porcentaje de posiciones superiores indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de tu página.

No se puede filtrar en la cláusula "WHERE".

relativeVisibility

number

La visibilidad relativa indica la frecuencia con la que se muestran las ofertas de la competencia en comparación con las tuyas. En otras palabras, es la cantidad de impresiones mostradas de un minorista de la competencia dividida por la cantidad de tus impresiones mostradas durante un intervalo de tiempo determinado en un país y una categoría de producto determinados.

No se puede filtrar en la cláusula "WHERE".

TrafficSourceEnum

Valores de la fuente de tráfico

Enumeraciones
TRAFFIC_SOURCE_ENUM_UNSPECIFIED No se especifica.
ORGANIC Tráfico orgánico.
ADS Tráfico proveniente de anuncios
ALL Tráfico orgánico y de anuncios

CompetitiveVisibilityTopMerchantView

Campos disponibles para la consulta en la tabla competitiveVisibilityTopMerchantView.

Informe Visibilidad de competencia con la empresa con la visibilidad más alta.

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación 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)

Es la fecha de esta fila.

No se puede seleccionar en la cláusula SELECT. Se requiere una condición en date en la cláusula WHERE.

domain

string

Es el dominio de tu competidor o el tuyo, si "isYourDomain" es verdadero.

Es obligatorio en la cláusula SELECT. No se puede filtrar en la cláusula "WHERE".

isYourDomain

boolean

Es verdadero si esta fila contiene datos de tu dominio.

No se puede filtrar en la cláusula "WHERE".

reportCountryCode

string

País en el que aparecieron las impresiones.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCountryCode en la cláusula WHERE.

reportCategoryId

string (int64 format)

Es el ID de la categoría de producto de Google para el que se calcula el informe, representado en la taxonomía de productos de Google.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCategoryId en la cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Es la fuente de tráfico de las impresiones.

Es obligatorio en la cláusula SELECT.

rank

string (int64 format)

Es la posición del dominio en la clasificación de los comercios principales para las claves seleccionadas (date, reportCategoryId, reportCountryCode, trafficSource) según las impresiones. 1 es el más alto.

No se puede filtrar en la cláusula "WHERE".

adsOrganicRatio

number

La proporción de anuncios y de búsqueda orgánica muestra la frecuencia con la que el dominio recibe impresiones de los anuncios de Shopping en comparación con el tráfico orgánico. El número se redondea y se agrupa.

No se puede filtrar en la cláusula "WHERE".

pageOverlapRate

number

El porcentaje de superposición en la página muestra la frecuencia con la que se muestran las ofertas de los minoristas que compiten con las tuyas en la misma página.

No se puede filtrar en la cláusula "WHERE".

higherPositionRate

number

El porcentaje de posiciones superiores indica la frecuencia con la que una oferta de la competencia se publicó en una posición superior a la de tu página.

No se puede filtrar en la cláusula "WHERE".

CompetitiveVisibilityBenchmarkView

Campos disponibles para la consulta en la tabla competitiveVisibilityBenchmarkView.

Informe Visibilidad de competencia con las comparativas de la categoría

Los valores solo se establecen para los campos solicitados explícitamente en la búsqueda de la solicitud.

Representación JSON
{
  "date": {
    object (Date)
  },
  "reportCountryCode": string,
  "reportCategoryId": string,
  "trafficSource": enum (TrafficSourceEnum),
  "yourDomainVisibilityTrend": number,
  "categoryBenchmarkVisibilityTrend": number
}
Campos
date

object (Date)

Es la fecha de esta fila.

Es obligatorio en la cláusula SELECT. Se requiere una condición en date en la cláusula WHERE.

reportCountryCode

string

País en el que aparecieron las impresiones.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCountryCode en la cláusula WHERE.

reportCategoryId

string (int64 format)

Es el ID de la categoría de producto de Google para el que se calcula el informe, representado en la taxonomía de productos de Google.

Es obligatorio en la cláusula SELECT. Se requiere una condición en reportCategoryId en la cláusula WHERE.

trafficSource

enum (TrafficSourceEnum)

Es la fuente de tráfico de las impresiones.

Es obligatorio en la cláusula SELECT.

yourDomainVisibilityTrend

number

Es el cambio en la visibilidad en función de las impresiones de tu dominio con respecto al inicio del período seleccionado (o el primer día con impresiones distintas de cero).

No se puede filtrar en la cláusula "WHERE".

categoryBenchmarkVisibilityTrend

number

Es el cambio en la visibilidad según las impresiones en relación con el inicio del período seleccionado (o el primer día con impresiones distintas de cero) para un conjunto combinado de comercios con la mayor visibilidad que se aproxima al mercado.

No se puede filtrar en la cláusula "WHERE".

Métodos

Recupera un informe definido por una búsqueda.