Informes

Al igual que con otros tipos de anuncios, puedes usar GoogleAdsService.SearchStream para recuperar el estado del producto y los datos de rendimiento de los productos de Shopping.

Las campañas que admiten productos tienen los siguientes informes específicos:

• Vista de rendimiento de Shopping
• Vista del grupo de productos
• Vista del grupo de productos del grupo de recursos
• Producto de Shopping

Nota: Tanto "Vista de rendimiento de Shopping" como "Producto de Shopping" pueden devolver métricas a nivel del producto. La "Vista del rendimiento de Shopping" proporcionará el estado "histórico" de un producto que publicó anuncios, mientras que "Producto de Shopping" proporciona el estado actual de un producto, ya sea que haya publicado anuncios o no. Se recomienda que "Shopping Product" se use principalmente para evaluar el "estado" de un producto y los problemas que impiden que una campaña lo use.

Vista del rendimiento de Shopping

La vista de rendimiento de Shopping proporciona estadísticas históricas agregadas sobre el rendimiento de los productos por atributos, como product_item_id.

La vista Rendimiento de Shopping captura el estado del producto en el momento en que se registraron las métricas pertinentes. Esto incluye segmentos como product_title, que podría haber cambiado desde que se registró la métrica.

A continuación, se incluye un ejemplo de consulta que recupera las impresiones, los clics, el costo, las conversiones y todas las conversiones de los productos por product_item_id con clics en los últimos 30 días (ordenados de forma descendente por todas las conversiones, luego por las conversiones, luego por los clics, luego por el costo y, por último, por las impresiones):

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM  shopping_performance_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.clicks > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.cost_micros DESC,
  metrics.impressions DESC

Vista del grupo de productos

La vista de grupos de productos proporciona estadísticas de informes agregados para los grupos de fichas de Shopping (denominados grupos de productos en la IU). Consulta la guía de informes de las campañas de máximo rendimiento para ver ejemplos de la vista de grupos de productos del grupo de recursos.

A continuación, se incluye un ejemplo de consulta que recupera las impresiones, los clics, las conversiones y todas las conversiones de los grupos de fichas de Shopping por campaña con impresiones en los últimos 30 días (ordenados de forma descendente por todas las conversiones, luego por conversiones, luego por clics y, por último, por impresiones):

SELECT
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.all_conversions
FROM product_group_view
WHERE segments.date DURING LAST_30_DAYS
  AND metrics.impressions > 0
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Producto de Shopping

El informe Producto de Shopping proporciona los atributos y las estadísticas de informes de los productos que existen en las cuentas de Google Merchant Center vinculadas a la cuenta de Google Ads. Este informe se puede usar para inspeccionar las estadísticas a nivel del cliente, la campaña y el grupo de anuncios.

A continuación, se incluye un ejemplo de consulta que recupera las impresiones, los clics, las conversiones y todas las conversiones de los últimos 30 días (ordenados de forma descendente por todas las conversiones, luego por las conversiones, luego por los clics y, por último, por las impresiones) para todos los productos de Shopping de todas las cuentas vinculadas de Google Merchant Center:

SELECT
  shopping_product.resource_name,
  shopping_product.item_id,
  shopping_product.feed_label,
  shopping_product.merchant_center_id,
  metrics.clicks,
  metrics.impressions,
  metrics.conversions,
  metrics.all_conversions
FROM shopping_product
WHERE segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.all_conversions DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC

Consulta la guía de informes para obtener más detalles sobre las consultas.

Consideraciones de rendimiento

El informe de productos de Shopping puede devolver una cantidad significativa de datos cuando una cuenta está vinculada a una gran cantidad de productos. Las siguientes recomendaciones pueden ayudarte a mejorar el rendimiento de tus consultas de GAQL:

• Las consultas a nivel de la campaña y del grupo de anuncios suelen ser más rápidas que las que se realizan a nivel de la cuenta, ya que es probable que contengan menos productos y requieran acceso a menos datos.
• Cuantos más campos y métricas haya en la cláusula SELECT, más lento será el tiempo de respuesta. Te recomendamos que selecciones solo los campos y las métricas que necesites en la consulta.
• Ten en cuenta que los productos con uno o más problemas devolverán más datos. Puedes filtrar por shopping_product.status en WHERE para comprender qué productos es probable que devuelvan problemas que hayan causado el estado correspondiente.

Casos de uso del informe de productos de Shopping

El informe Producto de Shopping proporciona acceso flexible a la información de los productos para las campañas que utilizan feeds de productos. Puede proporcionarte estadísticas sobre el estado de los productos de las cuentas de Google Merchant Center, pero también información específica de los anuncios, como las métricas de rendimiento y los problemas que impiden que los productos publiquen anuncios.

En esta sección, se abordan algunos casos de uso típicos similares a los que se pueden realizar en la vista "Productos" de la IU de Google Ads.

El campo "issues" del producto de Shopping es similar al que proporciona productstatuses en Content API for Shopping, con la adición de problemas específicos de Google Ads. Para verificar si el problema se debe resolver en Google Merchant Center o en Google Ads, primero consulta el campo shopping_product.issues.documentation de la respuesta, que incluye un artículo del Centro de ayuda para brindarte asistencia.

Estados del producto (a nivel de la cuenta)

Si especificas el informe sin filtros para la campaña o el grupo de anuncios, se mostrarán todos los productos a nivel de la cuenta.

Admite métricas, estados y problemas de todas las campañas de la cuenta de los siguientes tipos:

• Compras
• Máximo rendimiento

Esta consulta te permite ver el estado del producto, por ejemplo, NOT_ELIGIBLE, y una lista de problemas específicos del producto que generaron el estado determinado:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product

Estados de los productos (a nivel de la campaña)

Si especificas el informe con un recurso de campaña como parte de la cláusula WHERE, se mostrarán todos los productos incluidos en la campaña seleccionada.

Se admite en los siguientes tipos de campañas que pueden utilizar feeds de productos:

• Compras
• Máximo rendimiento
• Generación de demanda
• Video

Esta búsqueda te permite ver el estado del producto incluido en una campaña determinada. Te permite verificar el estado de cada producto, incluidos los problemas que lo causan. Por ejemplo, una campaña detenida afectará el estado del producto de la siguiente manera:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"

Estados de los productos (a nivel del grupo de anuncios)

Si especificas el informe con ambos recursos, un recurso de grupo de anuncios y un recurso de campaña, y como parte de la cláusula WHERE, se devolverán todos los productos incluidos en la campaña seleccionada. Las métricas, el estado y los problemas del producto reflejarán si se incluye o excluye del grupo de anuncios seleccionado.

Esta consulta te permite ver el estado del producto con respecto a ese grupo de anuncios. Te permite confirmar que los filtros del grupo de productos (a nivel del grupo de anuncios) se aplican correctamente y verificar el estado de cada producto:

SELECT
  shopping_product.resource_name,
  shopping_product.campaign,
  campaign.name,
  shopping_product.ad_group,
  ad_group.name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  shopping_product.status,
  shopping_product.issues
FROM shopping_product
WHERE
  shopping_product.campaign = "customers/<CUSTOMER_ID>/campaigns/<CAMPAIGN_ID>"
  AND shopping_product.ad_group = "customers/<CUSTOMER_ID>/adGroups/<AD_GROUP_ID>"

Nota: Tanto la campaña como el grupo de anuncios deben especificarse en la cláusula WHERE. Si uno u otro no están presentes, se producirá uno de los siguientes errores: MISSING_CAMPAIGN_FILTER y MISSING_AD_GROUP_FILTER.

Métricas de productos, filtradas por fecha (a nivel de la cuenta)

Si especificas el informe con una fecha o un período en la cláusula WHERE, se devolverán métricas para todos los productos a nivel de la cuenta (independientemente de si las métricas son distintas de cero) para el período especificado.

No puedes seleccionar segments.date, ya que se produciría un error UNSUPPORTED_DATE_SEGMENTATION.

Esta consulta te permite ver el rendimiento del producto actual para un día determinado o cualquier otro valor de fecha compatible. Esto se puede usar para generar un resumen de cada producto devuelto agregado en todas las campañas:

SELECT
  shopping_product.resource_name,
  shopping_product.merchant_center_id,
  shopping_product.channel,
  shopping_product.language_code,
  shopping_product.feed_label,
  shopping_product.item_id,
  metrics.clicks,
  metrics.impressions,
  metrics.cost_micros
FROM shopping_product
WHERE
  segments.date = '2024-01-01'

Rendimiento del producto con datos del carrito

Los anunciantes minoristas pueden acceder a métricas relevantes de ventas y ganancias, como ingresos, ganancias brutas, margen de ganancias brutas y unidades vendidas. Estas métricas están disponibles para todos los anunciantes que implementan las conversiones con datos del carrito en las campañas de Shopping y son compatibles con los siguientes informes.

• ad_group
• ad_group_ad
• campaign
• customer (agregado para todas las campañas)
• product_group_view
• shopping_performance_view

Las siguientes métricas de datos del carrito se pueden usar en informes, como el shopping_performance_view, para las campañas de Shopping.

metrics.average_cart_size
metrics.average_order_value_micros
metrics.cost_of_goods_sold_micros
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.gross_profit_margin
metrics.gross_profit_micros
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
metrics.orders
metrics.revenue_micros
metrics.units_sold

Nota: Las métricas de datos del carrito no están disponibles hasta que se registran conversiones para los productos asociados. shopping_performance_view Las consultas pueden tardar más en ejecutarse para las cuentas con una gran cantidad de productos, incluso con filtros aplicados.

En el siguiente ejemplo, se muestra cómo se pueden usar las métricas de datos del carrito para analizar el rendimiento a nivel del producto en las campañas de Shopping durante los últimos 30 días.

SELECT
  segments.product_item_id,
  segments.product_title,
  metrics.average_cart_size,
  metrics.average_order_value_micros,
  metrics.conversions,
  metrics.conversions_value,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin,
  metrics.revenue_micros,
  metrics.units_sold,
  campaign.advertising_channel_type
FROM shopping_performance_view
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
  AND metrics.conversions > 0
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.revenue_micros DESC,
  metrics.conversions_value DESC

Rendimiento de la campaña con datos del carrito

Las métricas de datos del carrito se pueden utilizar a nivel de la campaña y se pueden combinar con otras métricas de rendimiento, como las impresiones, los clics y el costo.

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  metrics.average_order_value_micros,
  metrics.gross_profit_micros,
  metrics.gross_profit_margin
FROM campaign
WHERE campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS
ORDER BY
  metrics.gross_profit_margin DESC,
  metrics.average_order_value_micros DESC,
  metrics.cost_micros DESC,
  metrics.conversions DESC,
  metrics.clicks DESC,
  metrics.impressions DESC