- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- ReportRow
- ProductPerformanceView
- MarketingMethodEnum
- NonProductPerformanceView
- ProductView
- AggregatedReportingContextStatus
- ItemIssue
- ItemIssueType
- ItemIssueSeverity
- IssueSeverityPerReportingContext
- AggregatedIssueSeverity
- ItemIssueResolution
- ClickPotential
- PriceCompetitivenessProductView
- PriceInsightsProductView
- Eficacia
- BestSellersProductClusterView
- ReportGranularityEnum
- InventoryStatus
- RelativeDemandEnum
- RelativeDemandChangeTypeEnum
- BestSellersBrandView
- CompetitiveVisibilityCompetitorView
- TrafficSourceEnum
- CompetitiveVisibilityTopMerchantView
- CompetitiveVisibilityBenchmarkView
- Pruébalo
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 |
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 |
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 |
Opcional. Cantidad de elementos |
pageToken |
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 |
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 ( |
Campos | |
---|---|
results[] |
Filas que coincidieron con la búsqueda. |
nextPageToken |
Es el token que se puede enviar como |
Alcances 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 ( |
Campos | |
---|---|
productPerformanceView |
Campos disponibles para consulta en la tabla |
nonProductPerformanceView |
Campos disponibles para consulta en la tabla |
productView |
Campos disponibles para consulta en la tabla |
priceCompetitivenessProductView |
Campos disponibles para consulta en la tabla |
priceInsightsProductView |
Campos disponibles para consulta en la tabla |
bestSellersProductClusterView |
Campos disponibles para consulta en la tabla |
bestSellersBrandView |
Campos disponibles para consulta en la tabla |
competitiveVisibilityCompetitorView |
Campos disponibles para consulta en la tabla |
competitiveVisibilityTopMerchantView |
Campos disponibles para consulta en la tabla |
competitiveVisibilityBenchmarkView |
Campos disponibles para consulta en la tabla |
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 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 ( |
Campos | |
---|---|
date |
Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación La condición en |
week |
Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio Segmentación |
conversionValue |
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 |
marketingMethod |
Es el método de marketing al que se aplican las métricas. Segmentación |
customerCountryCode |
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 aplicará una "ZZ" especial. código. |
offerId |
Es el ID del producto proporcionado por el comercio. Segmentación |
title |
Título del producto. Segmentación |
brand |
Es la marca del producto. Segmentación |
categoryL1 |
Categoría de producto (1er nivel) en la taxonomía de productos de Google. Segmentación |
categoryL2 |
Categoría de producto (2o nivel) en la taxonomía de productos de Google. Segmentación |
categoryL3 |
Categoría de producto (tercer nivel) en la taxonomía de productos de Google. Segmentación |
categoryL4 |
Categoría de producto (4o nivel) en la taxonomía de productos de Google. Segmentación |
categoryL5 |
Categoría de producto (5o nivel) en la taxonomía de productos de Google. Segmentación |
productTypeL1 |
Tipo de producto (1er nivel) en la taxonomía de productos del comercio. Segmentación |
productTypeL2 |
Tipo de producto (2o nivel) en la taxonomía de productos del comercio. Segmentación |
productTypeL3 |
Tipo de producto (tercer nivel) en la taxonomía de productos del comercio. Segmentación |
productTypeL4 |
Tipo de producto (4o nivel) en la taxonomía de productos del comercio. Segmentación |
productTypeL5 |
Tipo de producto (5o nivel) en la taxonomía de productos del comercio. Segmentación |
customLabel0 |
Etiqueta personalizada 0 para la agrupación personalizada de productos. Segmentación |
customLabel1 |
Etiqueta personalizada 1 para la agrupación personalizada de productos. Segmentación |
customLabel2 |
Etiqueta personalizada 2 para la agrupación personalizada de productos. Segmentación |
customLabel3 |
Etiqueta personalizada 3 para la agrupación personalizada de productos. Segmentación |
customLabel4 |
Etiqueta personalizada 4 para la agrupación personalizada de productos. Segmentación |
clicks |
Cantidad de clics Métrica (Metric). |
impressions |
Es la cantidad de veces que se muestran los productos del comercio. Métrica (Metric). |
clickThroughRate |
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 |
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 |
conversionRate |
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 |
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 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 ( |
Campos | |
---|---|
date |
Es la fecha en la zona horaria del comercio a la que se aplican las métricas. Segmentación La condición en |
week |
Primer día de la semana (lunes) de la fecha de las métricas en la zona horaria del comercio Segmentación |
clicks |
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 |
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 |
Tasa de clics: Es la cantidad de clics ( |
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 ( |
Campos | |
---|---|
price |
Es el precio del producto. Falta la información sobre el precio del producto. |
gtin[] |
Lista de códigos comerciales globales de artículos (GTIN) del producto. |
creationTime |
Indica la hora a la que el comercio creó el producto, expresada en segundos. |
expirationDate |
Es la fecha de vencimiento del producto, que se especifica en la inserción. |
itemIssues[] |
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, |
clickPotential |
Potencial de rendimiento estimado en comparación con los productos de mejor rendimiento del comercio. |
id |
Es el ID de REST del producto, con el formato Obligatorio en la cláusula |
channel |
Canal del producto. Puede ser |
languageCode |
Es el código de idioma del producto en formato BCP 47. |
feedLabel |
Es la etiqueta de feed del producto. |
offerId |
Es el ID del producto proporcionado por el comercio. |
title |
Título del producto. |
brand |
Es la marca del producto. |
categoryL1 |
Categoría de producto (primer nivel) en la taxonomía de productos de Google. |
categoryL2 |
Categoría de producto (segundo nivel) en la taxonomía de productos de Google. |
categoryL3 |
Categoría de producto (tercer nivel) en la taxonomía de productos de Google. |
categoryL4 |
Categoría de producto (cuarto nivel) en la taxonomía de productos de Google. |
categoryL5 |
Categoría de producto (quinto nivel) en la taxonomía de productos de Google. |
productTypeL1 |
Es el tipo de producto (primer nivel) según la taxonomía de productos del comercio. |
productTypeL2 |
Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio. |
productTypeL3 |
Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio. |
productTypeL4 |
Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio. |
productTypeL5 |
Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio. |
condition |
Indica la condición del producto. |
availability |
Es la disponibilidad del producto. |
shippingLabel |
La etiqueta de envío normalizada se especificó en la fuente de datos. |
itemGroupId |
Es el ID de grupo de artículos que proporciona el comercio para agrupar las variantes. |
thumbnailLink |
Vínculo a la imagen procesada del producto, alojada en la infraestructura de Google. |
aggregatedReportingContextStatus |
Estado agregado. |
clickPotentialRank |
Es la clasificación del producto en función de su potencial de clics. Un producto con una |
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 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 ( |
Campos | |
---|---|
type |
Es el tipo de problema del elemento. |
severity |
Gravedad del problema del artículo |
resolution |
Resolución del problema del elemento. |
ItemIssueType
Tipo de problema.
Representación JSON |
---|
{ "code": string, "canonicalAttribute": string } |
Campos | |
---|---|
code |
Código de error del problema, equivalente al |
canonicalAttribute |
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 ( |
Campos | |
---|---|
severityPerReportingContext[] |
Gravedad del problema según el contexto del informe. |
aggregatedSeverity |
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 ( |
Campos | |
---|---|
disapprovedCountries[] |
Es la lista de países rechazados en el contexto del informe, en formato ISO 3166. |
demotedCountries[] |
Lista de los países que descendieron de nivel en el contexto del informe, representados en formato ISO 3166. |
reportingContext |
Contexto de la denuncia 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 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
Enumeraciones | |
---|---|
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.
Enumeraciones | |
---|---|
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 ( |
Campos | |
---|---|
price |
Es el precio actual del producto. |
benchmarkPrice |
Es la última comparativa de precios disponible para el catálogo del producto en el país de referencia. |
reportCountryCode |
País de la comparativa de precios. Se representa en el formato ISO 3166. Obligatorio en la cláusula |
id |
Es el ID de REST del producto, con el formato Obligatorio en la cláusula |
offerId |
Es el ID del producto proporcionado por el comercio. |
title |
Título del producto. |
brand |
Es la marca del producto. |
categoryL1 |
Categoría de producto (primer nivel) en la taxonomía de productos de Google. |
categoryL2 |
Categoría de producto (segundo nivel) en la taxonomía de productos de Google. |
categoryL3 |
Categoría de producto (tercer nivel) en la taxonomía de productos de Google. |
categoryL4 |
Categoría de producto (cuarto nivel) en la taxonomía de productos de Google. |
categoryL5 |
Categoría de producto (quinto nivel) en la taxonomía de productos de Google. |
productTypeL1 |
Es el tipo de producto (primer nivel) según la taxonomía de productos del comercio. |
productTypeL2 |
Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio. |
productTypeL3 |
Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio. |
productTypeL4 |
Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio. |
productTypeL5 |
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 ( |
Campos | |
---|---|
price |
Es el precio actual del producto. |
suggestedPrice |
Es el precio sugerido más reciente del producto. |
effectiveness |
Efectividad prevista de la aplicación de la sugerencia de precios, agrupada. |
id |
Es el ID de REST del producto, con el formato Obligatorio en la cláusula |
offerId |
Es el ID del producto proporcionado por el comercio. |
title |
Título del producto. |
brand |
Es la marca del producto. |
categoryL1 |
Categoría de producto (primer nivel) en la taxonomía de productos de Google. |
categoryL2 |
Categoría de producto (segundo nivel) en la taxonomía de productos de Google. |
categoryL3 |
Categoría de producto (tercer nivel) en la taxonomía de productos de Google. |
categoryL4 |
Categoría de producto (cuarto nivel) en la taxonomía de productos de Google. |
categoryL5 |
Categoría de producto (quinto nivel) en la taxonomía de productos de Google. |
productTypeL1 |
Es el tipo de producto (primer nivel) según la taxonomía de productos del comercio. |
productTypeL2 |
Es el tipo de producto (segundo nivel) en la taxonomía de productos del comercio. |
productTypeL3 |
Es el tipo de producto (tercer nivel) en la taxonomía de productos del comercio. |
productTypeL4 |
Tipo de producto (cuarto nivel) en la taxonomía de productos del comercio. |
productTypeL5 |
Es el tipo de producto (quinto nivel) en la taxonomía de productos del comercio. |
predictedImpressionsChangeFraction |
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 |
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 |
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.
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 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 ( |
Campos | |
---|---|
reportDate |
Fecha del informe. El valor de este campo solo puede ser uno de los siguientes:
Obligatorio en la cláusula |
variantGtins[] |
Son los GTIN de las variantes de ejemplo del grupo de productos. |
reportGranularity |
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 |
reportCountryCode |
País donde se calcula la clasificación. Se representa en el formato ISO 3166. Obligatorio en la cláusula |
reportCategoryId |
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 |
title |
Título del clúster de productos. |
brand |
Es la marca del clúster de productos. |
categoryL1 |
Categoría de producto (primer nivel) del clúster de productos, representada en la taxonomía de productos de Google. |
categoryL2 |
Categoría de producto (2o nivel) del clúster de productos, representada en la taxonomía de productos de Google. |
categoryL3 |
Categoría de producto (tercer nivel) del clúster de productos, representada en la taxonomía de productos de Google. |
categoryL4 |
Categoría de producto (cuarto nivel) del clúster de productos, representada en la taxonomía de productos de Google. |
categoryL5 |
Categoría de producto (quinto nivel) del clúster de productos, representada en la taxonomía de productos de Google. |
inventoryStatus |
Si el clúster de productos está El campo no considera el filtro del país del informe de los más vendidos |
brandInventoryStatus |
Si hay al menos un producto de la marca actualmente El campo no considera el filtro del país del informe de los más vendidos |
rank |
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 |
Clasificación por popularidad en la semana o el mes anteriores |
relativeDemand |
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 |
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 |
Cambio en la demanda estimada. Si aumentó, se hundió o permaneció plana. |
ReportGranularityEnum
Valores del nivel de detalle del informe.
Enumeraciones | |
---|---|
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.
Enumeraciones | |
---|---|
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.
Enumeraciones | |
---|---|
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.
Enumeraciones | |
---|---|
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 ( |
Campos | |
---|---|
reportDate |
Fecha del informe. El valor de este campo solo puede ser uno de los siguientes:
Obligatorio en la cláusula |
reportGranularity |
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 |
reportCountryCode |
País donde se calcula la clasificación. Se representa en el formato ISO 3166. Obligatorio en la cláusula |
reportCategoryId |
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 |
brand |
Es el nombre de la marca. |
rank |
Es 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 |
Clasificación por popularidad en la semana o el mes anteriores |
relativeDemand |
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 |
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 |
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 ( |
Campos | |
---|---|
date |
Es la fecha de esta fila. Se requiere una condición en |
domain |
Dominio de la competencia o de su dominio, si "isYourDomain" es cierto. Obligatorio en la cláusula |
isYourDomain |
Es verdadero si esta fila contiene datos de tu dominio. No se puede filtrar en "WHERE" . |
reportCountryCode |
País en el que se publicaron las impresiones Obligatorio en la cláusula |
reportCategoryId |
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 |
trafficSource |
Fuente de tráfico de las impresiones Obligatorio en la cláusula |
rank |
Posición del dominio en la clasificación de empresas similares para las claves seleccionadas ( No se puede filtrar en "WHERE" . |
adsOrganicRatio |
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 "WHERE" . |
pageOverlapRate |
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 "WHERE" . |
higherPositionRate |
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 "WHERE" . |
relativeVisibility |
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 "WHERE" . |
TrafficSourceEnum
Valores de la fuente de tráfico.
Enumeraciones | |
---|---|
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 ( |
Campos | |
---|---|
date |
Es la fecha de esta fila. No se puede seleccionar en la cláusula |
domain |
Dominio de la competencia o de su dominio, si "isYourDomain" es cierto. Obligatorio en la cláusula |
isYourDomain |
Es verdadero si esta fila contiene datos de tu dominio. No se puede filtrar en "WHERE" . |
reportCountryCode |
País en el que se publicaron las impresiones Obligatorio en la cláusula |
reportCategoryId |
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 |
trafficSource |
Fuente de tráfico de las impresiones Obligatorio en la cláusula |
rank |
Posición del dominio en la clasificación de comercios principales para las claves seleccionadas ( No se puede filtrar en "WHERE" . |
adsOrganicRatio |
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 "WHERE" . |
pageOverlapRate |
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 "WHERE" . |
higherPositionRate |
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 "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 ( |
Campos | |
---|---|
date |
Es la fecha de esta fila. Obligatorio en la cláusula |
reportCountryCode |
País en el que se publicaron las impresiones Obligatorio en la cláusula |
reportCategoryId |
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 |
trafficSource |
Fuente de tráfico de las impresiones Obligatorio en la cláusula |
yourDomainVisibilityTrend |
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 "WHERE" . |
categoryBenchmarkVisibilityTrend |
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 "WHERE" . |