Method: accounts.reports.search

Recupera un informe definido por una consulta de búsqueda. La respuesta puede contener menos filas que las especificadas por pageSize. Usa nextPageToken para determinar si hay más filas que solicitar.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. Es el ID de la cuenta que realiza la llamada. Debe ser una cuenta independiente o una cuenta secundaria de MCA. Formato: cuentas/{account}

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON
{
  "query": string,
  "pageSize": integer,
  "pageToken": string
}
Campos
query

string

Obligatorio. Consulta que define un informe que se recuperará.

Para obtener detalles sobre cómo crear tu consulta, revisa la guía del lenguaje de consulta. Para ver la lista completa de tablas y campos disponibles, consulta los campos disponibles.

pageSize

integer

Opcional. Cantidad de elementos ReportRows que se deben recuperar en una sola página. La configuración predeterminada es 1,000. Los valores superiores a 5,000 se convierten a 5,000.

pageToken

string

Opcional. El token de la página que se recuperará. Si no se especifica, se muestra la primera página de resultados. Para solicitar la página siguiente de resultados, se debe usar el valor obtenido de nextPageToken en la respuesta anterior.

Cuerpo de la respuesta

Mensaje de respuesta para el método ReportService.Search.

Si se ejecuta correctamente, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "results": [
    {
      object (ReportRow)
    }
  ],
  "nextPageToken": string
}
Campos
results[]

object (ReportRow)

Filas que coincidieron con la búsqueda.

nextPageToken

string

Es el token que se puede enviar como pageToken para recuperar la página siguiente. Si se omite, no habrá páginas posteriores.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Para obtener más información, consulta la descripción general de OAuth 2.0.

ReportRow

Fila del resultado que se muestra en la búsqueda.

En la respuesta, solo se propaga el mensaje que corresponde a la tabla consultada. En el mensaje propagado, solo se completan los campos solicitados de forma explícita 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 consulta en la tabla productPerformanceView.

nonProductPerformanceView

object (NonProductPerformanceView)

Campos disponibles para consulta en la tabla nonProductPerformanceView.

productView

object (ProductView)

Campos disponibles para consulta en la tabla productView.

priceCompetitivenessProductView

object (PriceCompetitivenessProductView)

Campos disponibles para consulta en la tabla priceCompetitivenessProductView.

priceInsightsProductView

object (PriceInsightsProductView)

Campos disponibles para consulta en la tabla priceInsightsProductView.

bestSellersProductClusterView

object (BestSellersProductClusterView)

Campos disponibles para consulta en la tabla bestSellersProductClusterView.

bestSellersBrandView

object (BestSellersBrandView)

Campos disponibles para consulta en la tabla bestSellersBrandView.

competitiveVisibilityCompetitorView

object (CompetitiveVisibilityCompetitorView)

Campos disponibles para consulta en la tabla competitiveVisibilityCompetitorView.

competitiveVisibilityTopMerchantView

object (CompetitiveVisibilityTopMerchantView)

Campos disponibles para consulta en la tabla competitiveVisibilityTopMerchantView.

competitiveVisibilityBenchmarkView

object (CompetitiveVisibilityBenchmarkView)

Campos disponibles para consulta en la tabla competitiveVisibilityBenchmarkView.

ProductPerformanceView

Campos disponibles para 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 métricas de rendimiento que están segmentadas (por ejemplo, offerId). Los valores de las dimensiones del producto, como offerId, reflejan el estado de un producto en el momento de la impresión.

Los campos de segmento no se pueden seleccionar en las consultas sin seleccionar también al menos un campo de métrica.

Los valores solo se establecen para los campos solicitados de forma explícita 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)

Valor de las conversiones atribuidas al producto, registradas en la fecha de conversión. Métrica (Metric).

Disponible solo para la fuente de tráfico 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 donde se encuentra el cliente en el momento del evento. Se representa en el formato ISO 3166. Segmentación

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

offerId

string

Es el ID del producto proporcionado por 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 (1er nivel) en la taxonomía de productos de Google. Segmentación

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

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

productTypeL2

string

Tipo de producto (2o 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 (4o nivel) en la taxonomía de productos del comercio. Segmentación

productTypeL5

string

Tipo de producto (5o 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 (Metric).

impressions

string (int64 format)

Es la cantidad de veces que se muestran los productos del comercio. Métrica (Metric).

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 (Metric).

conversions

number

Cantidad de conversiones atribuidas al producto, registradas en la fecha de conversión. Según el modelo de atribución, una conversión podría distribuirse entre varios clics, y cada uno recibe su propio crédito asignado. Esta métrica es una suma de todos los créditos. Métrica (Metric).

Disponible solo para la fuente de tráfico 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 (Metric).

Disponible solo para la fuente de tráfico FREE.

MarketingMethodEnum

Valores del método de marketing.

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

NonProductPerformanceView

Campos disponibles para consulta en la tabla nonProductPerformanceView.

Datos de rendimiento en imágenes y 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 en función de las cuales están segmentadas las métricas de rendimiento (por ejemplo, date).

Los campos de segmento no se pueden seleccionar en las consultas sin seleccionar también al menos un campo de métrica.

Los valores solo se establecen para los campos solicitados de forma explícita 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 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 (Metric).

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 dirigían a tus páginas que no son de productos. Métrica (Metric).

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 (Metric).

ProductView

Campos disponibles para consulta en la tabla productView.

Productos en el inventario actual. Los productos de esta tabla son los mismos que los de la subAPI de Productos, pero no todos los atributos de producto de la subAPI de Productos están disponibles para consultar en esta tabla. A diferencia de la API secundaria Productos, esta tabla permite filtrar la lista de productos mostrada por atributos. Para recuperar un solo producto mediante id o enumerar todos los productos, se debe usar la subAPI de Productos.

Los valores solo se establecen para los campos solicitados de forma explícita 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)

Es el precio del producto. Falta la información sobre el precio del producto.

gtin[]

string

Lista de códigos comerciales globales de artículos (GTIN) del producto.

creationTime

string (Timestamp format)

Indica la hora a la que el comercio creó el producto, expresada en segundos.

expirationDate

object (Date)

Es la fecha de vencimiento del producto, que se especifica en la inserción.

itemIssues[]

object (ItemIssue)

Es la lista de problemas del producto.

Este campo no se puede utilizar 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)

Potencial de rendimiento estimado en comparación con los productos de 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 Center que funcionan en los productos toman esto como su parámetro name.

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 de feed del producto.

offerId

string

Es el ID del producto proporcionado por el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Es el tipo de producto (primer nivel) según 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

Indica la condición del producto.

availability

string

Es la disponibilidad del producto.

shippingLabel

string

La etiqueta de envío normalizada se especificó 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 en función de su potencial de clics. Un producto con una clickPotentialRank como 1 tiene el potencial de clics más alto entre los productos del comercio que cumplen 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
Enumeradores
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 es "pendiente" en todos los contextos de informes.
ELIGIBLE_LIMITED El producto es apto para algunos contextos de informes (pero no todos).
ELIGIBLE El producto es apto para todos los contextos de informes.

ItemIssue

Problema del artículo asociado con el producto.

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

object (ItemIssueType)

Es el tipo de problema del elemento.

severity

object (ItemIssueSeverity)

Gravedad del problema del artículo

resolution

enum (ItemIssueResolution)

Resolución del problema del elemento.

ItemIssueType

Tipo de problema.

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

string

Código de error del problema, equivalente al code de Product issues.

canonicalAttribute

string

Es el nombre del atributo canónico para los problemas específicos de los 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 según el contexto del informe.

aggregatedSeverity

enum (AggregatedIssueSeverity)

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

Este campo se puede utilizar para filtrar los resultados.

IssueSeverityPerReportingContext

Gravedad del problema según el contexto del informe.

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

string

Es la lista de países rechazados en el contexto del informe, en formato ISO 3166.

demotedCountries[]

string

Lista de los países que descendieron de nivel en el contexto del informe, representados en formato ISO 3166.

reportingContext

enum (ReportingContextEnum)

Contexto de la denuncia al que se aplica el problema.

AggregatedIssueSeverity

Gravedad del problema agregada para todos los contextos de informes.

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

ItemIssueResolution

Cómo resolver el problema

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

ClickPotential

El potencial de clics de un producto es una estimación de su potencial de rendimiento en comparación con los productos con mejor rendimiento del comercio. El potencial de clics de un producto ayuda a los comercios a priorizar los productos que deben corregirse y a comprender cuál es el rendimiento de los productos en relación con su potencial.

Enumeradores
CLICK_POTENTIAL_UNSPECIFIED Impacto previsto desconocido de los clics.
LOW Potencial para recibir una cantidad baja de clics en comparación con los productos de mejor rendimiento del comercio.
MEDIUM Potencial para recibir una cantidad moderada de clics en comparación con los productos del comercio con el mejor rendimiento.
HIGH Potencial para recibir una cantidad de clics similar a la de los productos con mejor rendimiento del comercio.

PriceCompetitivenessProductView

Campos disponibles para consulta en la tabla priceCompetitivenessProductView.

Informe de competitividad de los precios.

Los valores solo se establecen para los campos solicitados de forma explícita 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)

Es la última comparativa de precios disponible para el catálogo del producto en el país de referencia.

reportCountryCode

string

País de la comparativa de precios. Se representa en el formato ISO 3166.

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.

Obligatorio en la cláusula SELECT.

offerId

string

Es el ID del producto proporcionado por el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Es el tipo de producto (primer nivel) según 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.

PriceInsightsProductView

Campos disponibles para consulta en la tabla priceInsightsProductView.

Informe Estadísticas de precios

Los valores solo se establecen para los campos solicitados de forma explícita 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 del producto.

effectiveness

enum (Effectiveness)

Efectividad prevista de la aplicación de la sugerencia de precios, 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.

Obligatorio en la cláusula SELECT.

offerId

string

Es el ID del producto proporcionado por el comercio.

title

string

Título del producto.

brand

string

Es la marca del producto.

categoryL1

string

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

categoryL2

string

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

categoryL3

string

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

categoryL4

string

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

categoryL5

string

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

productTypeL1

string

Es el tipo de producto (primer nivel) según 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.

predictedImpressionsChangeFraction

number

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

predictedClicksChangeFraction

number

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

predictedConversionsChangeFraction

number

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

Efectividad

Bucket de eficacia prevista.

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 tu precio actual y el sugerido. Se prevé que las sugerencias de precios con una eficacia de HIGH generarán el mayor aumento en el rendimiento.

Enumeradores
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 consulta en la tabla bestSellersProductClusterView.

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

Los valores solo se establecen para los campos solicitados de forma explícita 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
  • Se refiere al primer día del mes para los informes mensuales.

Obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportDate en la consulta, se muestra el último informe semanal o mensual disponible.

variantGtins[]

string

Son los GTIN de las variantes de ejemplo del grupo de productos.

reportGranularity

enum (ReportGranularityEnum)

Nivel de detalle del informe. La clasificación se puede realizar en un plazo 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

País donde se calcula la clasificación. Se representa en el formato ISO 3166.

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 categoría de producto de Google para el que se calculará la clasificación, que se representa en la taxonomía de productos de Google.

Obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportCategoryId en la búsqueda, se muestran las clasificaciones para todas las categorías de nivel superior.

title

string

Título del clúster de productos.

brand

string

Es la marca del clúster de productos.

categoryL1

string

Categoría de producto (primer nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL2

string

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

categoryL3

string

Categoría de producto (tercer nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL4

string

Categoría de producto (cuarto nivel) del clúster de productos, representada en la taxonomía de productos de Google.

categoryL5

string

Categoría de producto (quinto nivel) del clúster de productos, representada en la taxonomía de productos de Google.

inventoryStatus

enum (InventoryStatus)

Si el clúster de productos está IN_STOCK en la fuente de datos de productos en, al menos, uno de los países, OUT_OF_STOCK en la 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 actualmente IN_STOCK en tu fuente de datos de productos en al menos uno de los países, todos los productos están OUT_OF_STOCK en la fuente de datos de productos en todos los países o NOT_IN_INVENTORY.

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

rank

string (int64 format)

Es la popularidad del grupo de productos en los anuncios y las plataformas orgánicas para 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 por 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 por popularidad más alta en la misma categoría y el mismo país durante la semana o el mes anteriores.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Cambio en la demanda estimada. Si aumentó, se hundió o permaneció plana.

ReportGranularityEnum

Valores del nivel de detalle del informe.

Enumeradores
REPORT_GRANULARITY_ENUM_UNSPECIFIED No se especifica.
WEEKLY El informe se calcula a lo largo de un período de una semana.
MONTHLY El informe se procesa a lo largo de un período mensual.

InventoryStatus

Es el estado del clúster de productos o la marca de tu inventario.

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

RelativeDemandEnum

Valores de la demanda relativa.

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

RelativeDemandChangeTypeEnum

Valores del tipo de cambio de demanda relativa.

Enumeradores
RELATIVE_DEMAND_CHANGE_TYPE_ENUM_UNSPECIFIED No se especifica.
SINKER La demanda relativa es más baja que el período anterior.
FLAT La demanda relativa es igual al período anterior.
RISER La demanda relativa es más alta que el período anterior.

BestSellersBrandView

Campos disponibles para consulta en la tabla bestSellersBrandView.

Informe más vendidos con marcas principales

Los valores solo se establecen para los campos solicitados de forma explícita 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
  • Se refiere al primer día del mes para los informes mensuales.

Obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportDate en la consulta, se muestra el último informe semanal o mensual disponible.

reportGranularity

enum (ReportGranularityEnum)

Nivel de detalle del informe. La clasificación se puede realizar en un plazo 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

País donde se calcula la clasificación. Se representa en el formato ISO 3166.

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 categoría de producto de Google para el que se calculará la clasificación, que se representa en la taxonomía de productos de Google.

Obligatorio en la cláusula SELECT. Si no se especifica una condición WHERE en reportCategoryId en la búsqueda, se muestran las clasificaciones para 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)

La demanda estimada en relación con la marca con la clasificación por 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 por popularidad más alta en la misma categoría y el mismo país durante la semana o el mes anteriores.

relativeDemandChange

enum (RelativeDemandChangeTypeEnum)

Cambio en la demanda estimada. Si aumentó, se hundió o permaneció plana.

CompetitiveVisibilityCompetitorView

Campos disponibles para consulta en la tabla competitiveVisibilityCompetitorView.

informe de Visibilidad respecto de la competencia de empresas con una visibilidad similar.

Los valores solo se establecen para los campos solicitados de forma explícita 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

Dominio de la competencia o del tuyo, si "isYourDomain" es verdadero.

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 se publicaron las impresiones

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 categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google.

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

trafficSource

enum (TrafficSourceEnum)

Fuente de tráfico de las impresiones

Obligatorio en la cláusula SELECT.

rank

string (int64 format)

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 valor 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 en buckets.

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 posición superior muestra la frecuencia con la que la oferta de un competidor se ubica en una posición superior a la de su oferta en la página.

No se puede filtrar en la cláusula “WHERE”.

relativeVisibility

number

La visibilidad relativa muestra la frecuencia con la que se muestran las ofertas de la competencia en comparación con tus ofertas. En otras palabras, es la cantidad de impresiones mostradas de un minorista de la competencia dividida por la cantidad de sus impresiones mostradas durante un período determinado para 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.

Enumeradores
TRAFFIC_SOURCE_ENUM_UNSPECIFIED No se especifica.
ORGANIC Tráfico orgánico
ADS Es el tráfico que proviene de los anuncios.
ALL Tráfico orgánico y de anuncios

CompetitiveVisibilityTopMerchantView

Campos disponibles para consulta en la tabla competitiveVisibilityTopMerchantView.

Informe Visibilidad respecto a la competencia con las empresas con la más alta visibilidad.

Los valores solo se establecen para los campos solicitados de forma explícita 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

Dominio de la competencia o del tuyo, si "isYourDomain" es verdadero.

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 se publicaron las impresiones

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 categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google.

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

trafficSource

enum (TrafficSourceEnum)

Fuente de tráfico de las impresiones

Obligatorio en la cláusula SELECT.

rank

string (int64 format)

Posición del dominio en la clasificación de comercios principales para las claves seleccionadas (date, reportCategoryId, reportCountryCode, trafficSource) según las impresiones. 1 es el valor 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 en buckets.

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 posición superior muestra la frecuencia con la que la oferta de un competidor se ubica en una posición superior a la de su oferta en la página.

No se puede filtrar en la cláusula “WHERE”.

CompetitiveVisibilityBenchmarkView

Campos disponibles para consulta en la tabla competitiveVisibilityBenchmarkView.

Informe Visibilidad respecto de la competencia con las comparativas de categorías.

Los valores solo se establecen para los campos solicitados de forma explícita 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.

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 se publicaron las impresiones

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 categoría de producto de Google para el que se calculará el informe, representado en la taxonomía de productos de Google.

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

trafficSource

enum (TrafficSourceEnum)

Fuente de tráfico de las impresiones

Obligatorio en la cláusula SELECT.

yourDomainVisibilityTrend

number

Es el cambio en la visibilidad según las impresiones de tu dominio con respecto al inicio del intervalo de tiempo seleccionado (o el primer día con impresiones distintas de cero).

No se puede filtrar en la cláusula “WHERE”.

categoryBenchmarkVisibilityTrend

number

El cambio en la visibilidad en función de las impresiones con respecto al inicio del intervalo de tiempo seleccionado (o el primer día con impresiones distintas de cero) para un conjunto combinado de comercios con la mayor visibilidad cercana al mercado.

No se puede filtrar en la cláusula “WHERE”.