Al igual que con otros tipos de anuncios, puedes usar GoogleAdsService.SearchStream para recuperar los datos de rendimiento y el estado de los productos de Shopping.
Las campañas que admiten productos de un feed de Google Merchant Center tienen los siguientes informes exclusivos:
- Vista de rendimiento de Shopping
- Vista de grupos de productos
- Vista de grupos de productos de los grupos de recursos
- Producto de Shopping
- Vista de ventas de datos del carrito (disponible en la versión 24 y posteriores)
- Vista de recursos de expansión de la URL final (disponible para las campañas de Shopping en la versión 26 y posteriores)
Además, a partir de la versión 26, en las campañas de Shopping, final_url_expansion_asset_view informa los recursos de personalización de texto que se publicaron cuando se habilitaron IA Max (campaign.ai_max_setting.enable_ai_max = true) y la expansión de la URL final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN).
Consulta la sección Vista de recursos de expansión de la URL final para conocer los requisitos de la consulta y ver un ejemplo.
Vista de rendimiento de Shopping
La vista de rendimiento de Shopping proporciona estadísticas de informes históricos agregados para los productos por atributos, como product_item_id.
Admite todos los tipos de campañas que utilizan feeds de productos de Google Merchant Center, incluidas las campañas de Shopping, de máximo rendimiento, de generación de demanda, de video, de aplicaciones y de Display.
La vista de 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ían haber cambiado desde que se registró la métrica.
shopping_performance_view también admite los siguientes segmentos y métricas:
segments.ad_sub_network_type(también se admite enproduct_group_viewyasset_group_product_group_view).- Métricas segmentadas por fecha de conversión:
metrics.conversions_by_conversion_date,metrics.all_conversions_by_conversion_date,metrics.conversions_value_by_conversion_date,metrics.all_conversions_value_by_conversion_date,metrics.value_per_conversions_by_conversion_dateymetrics.value_per_all_conversions_by_conversion_date. - Métricas competitivas del porcentaje de impresiones:
metrics.search_budget_lost_impression_share,metrics.search_rank_lost_impression_share,metrics.search_budget_lost_absolute_top_impression_shareymetrics.search_rank_lost_absolute_top_impression_share. - Disponible en la versión 24 y posteriores: El segmento
segments.conversion_attribution_event_typey las métricas de datos del carrito demetrics.all_*(que informan los datos del carrito en todas las conversiones, incluidas las conversiones no aptas para ofertas).
A continuación, se muestra una consulta de ejemplo 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
Lógica de atribución para los informes de productos
Los informes a nivel del producto usan un marco de atribución específico para asignar el crédito por el rendimiento a los productos individuales cuando aparecen varios productos en un solo anuncio.
Métricas financieras
Las métricas financieras, como metrics.cost_micros y metrics.conversions, se calculan para garantizar que su suma en todos los productos no supere los informes a nivel de la campaña.
- Interacciones directas
- Cuando la intención del usuario es clara y está vinculada a un solo producto (como un clic directo en un producto), el 100% del costo y el crédito de conversión asociados se atribuyen a ese producto específico.
- Interacciones indirectas
- Cuando la intención del usuario se dirige al anuncio en su totalidad (por ejemplo, si el usuario hace clic en un título, un botón de llamado a la acción o un video), el costo y el crédito de conversión asociados se distribuyen de manera uniforme entre todos los productos que se publican en ese anuncio en particular.
Métricas de interacción
Las métricas de interacción, como metrics.impressions y metrics.clicks, miden
la participación específica del producto.
En el caso de las impresiones, el recuento se incrementa para cada producto incluido en el anuncio cuando se produce el evento, independientemente de si el producto era visible en el viewport del usuario. Por este motivo, la suma de las impresiones de todos los productos de un informe puede ser significativamente más alta que los totales correspondientes a nivel de la campaña.
Por el contrario, metrics.clicks solo mide los clics que se produjeron en ese producto específico. En la IU de Google Ads, el campo metrics.clicks se etiqueta explícitamente como Clics en productos.
Vista de grupo de productos
La vista de grupo de productos proporciona estadísticas de informes agregadas para los grupos de fichas de producto de Shopping (denominados grupos de productos en la IU). Consulta la guía de informes de campañas de máximo rendimiento para ver ejemplos de la vista de grupos de productos de grupos de recursos.
A continuación, se muestra una consulta de ejemplo 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 las conversiones, luego por los clics y, por último, por las 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
Informe de productos de Shopping
El informe Shopping Product 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. Admite campañas de Shopping, de máximo rendimiento, de generación de demanda, de video y de aplicaciones (en la versión 24 y posteriores). También puedes consultar
shopping_product.product_image_uri para recuperar el URI de la imagen del producto
que proporcionó el comercio.
A continuación, se incluye una consulta de ejemplo 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 de Google Merchant Center vinculadas:
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. Selecciona solo los campos y las métricas que necesitas en la consulta. - Los productos con uno o más problemas devuelven más datos. Puedes filtrar por
shopping_product.statusen la cláusulaWHEREpara comprender qué productos pueden devolver problemas que causaron el estado correspondiente.
Casos de uso comunes del informe de productos de Shopping
El informe Shopping Product proporciona acceso flexible a la información del producto para las campañas que utilizan feeds de productos. Puede brindarte estadísticas sobre el estado de los productos de las cuentas de Google Merchant Center, así como 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 de shopping_product es similar a ProductStatus en
la API de Merchant, con la adición de problemas específicos de Google Ads.
Para verificar si el problema se debe resolver en Google Merchant Center o Google
Ads, primero revisa el campo shopping_product.issues.documentation de la
respuesta, que incluye un artículo del Centro de ayuda para obtener asistencia.
Estados de los productos (nivel de la cuenta)
Si especificas el informe sin filtros para la campaña o el grupo de anuncios, se devuelven 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:
- Shopping
- 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)
Especificar el informe con un recurso de campaña como parte de la cláusula WHERE
devuelve todos los productos incluidos en la campaña seleccionada.
Se admite en los siguientes tipos de campañas que pueden utilizar feeds de productos:
- Shopping
- Máximo rendimiento
- Generación de demanda
- Video
- App (disponible en la versión 24 y posteriores)
Esta consulta te permite ver el estado de cada producto incluido en una campaña determinada, incluidos los problemas que causan el estado. Por ejemplo, una campaña detenida afecta el estado del producto:
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)
Especificar el informe con un recurso de grupo de anuncios y un recurso de campaña
como parte de la cláusula WHERE devuelve todos los productos incluidos en la campaña
seleccionada. Las métricas, el estado y los problemas del producto reflejan si se incluye o excluye del grupo de anuncios seleccionado.
Es compatible con los siguientes tipos de campañas:
- Shopping
- Generación de demanda
- Video
- Aplicación (disponible en la versión 24 y posteriores; solo admite las métricas
impressions,clicksyctr, y no admitestatusniissues)
Esta consulta te permite ver el estado del producto con respecto a ese grupo de anuncios. Te permite confirmar que los filtros de los grupos de productos (a nivel del grupo de anuncios) se apliquen 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>'
Métricas de productos, filtradas por fecha (nivel de la cuenta)
Especificar el informe con una fecha o un período en la cláusula WHERE devuelve
las métricas de todos los productos a nivel de la cuenta para el período especificado,
independientemente de si las métricas son distintas de cero.
No puedes seleccionar segments.date, ya que, si lo haces, se producirá un error UNSUPPORTED_DATE_SEGMENTATION.
Esta consulta te permite ver el rendimiento de cada producto para un día determinado o algún otro período compatible, 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 DURING LAST_30_DAYS
Rendimiento de los productos con datos del carrito
Los anunciantes minoristas pueden acceder a métricas relevantes de ventas y ganancias, como los ingresos, las ganancias brutas, el margen de ganancias brutas y las 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_groupad_group_adcampaigncart_data_sales_view(disponible en la versión 24 y posteriores)customer(datos agregados de todas las campañas)product_group_viewshopping_performance_viewshopping_product(para las métricas de datos del carrito demetrics.all_*en la versión 24 y posteriores)
Las siguientes métricas de datos del carrito se pueden usar en los informes, como el de shopping_performance_view, para las campañas de Shopping:
metrics.average_cart_sizemetrics.average_order_value_microsmetrics.cost_of_goods_sold_microsmetrics.cross_sell_cost_of_goods_sold_microsmetrics.cross_sell_gross_profit_microsmetrics.cross_sell_revenue_microsmetrics.cross_sell_units_soldmetrics.gross_profit_marginmetrics.gross_profit_microsmetrics.lead_cost_of_goods_sold_microsmetrics.lead_gross_profit_microsmetrics.lead_revenue_microsmetrics.lead_units_soldmetrics.ordersmetrics.revenue_microsmetrics.units_sold
En la versión 24 y posteriores, las siguientes métricas de datos del carrito también están disponibles para generar informes de todas las conversiones (incluidas las conversiones no aptas para ofertas):
metrics.all_average_cart_sizemetrics.all_average_order_value_microsmetrics.all_cost_of_goods_sold_microsmetrics.all_cross_sell_cost_of_goods_sold_microsmetrics.all_cross_sell_gross_profit_microsmetrics.all_cross_sell_revenue_microsmetrics.all_cross_sell_units_soldmetrics.all_gross_profit_marginmetrics.all_gross_profit_microsmetrics.all_lead_cost_of_goods_sold_microsmetrics.all_lead_gross_profit_microsmetrics.all_lead_revenue_microsmetrics.all_lead_units_soldmetrics.all_ordersmetrics.all_revenue_microsmetrics.all_units_sold
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 de las campañas de Shopping en 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
Vista de recursos de expansión de la URL final
A partir de la versión 26, puedes usar final_url_expansion_asset_view para medir el rendimiento a nivel del recurso de los recursos de personalización de texto que se publican en las campañas de Shopping cuando IA Max (campaign.ai_max_setting.enable_ai_max = true) y la expansión de la URL final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) están habilitadas.
Cuando consultes final_url_expansion_asset_view, sigue estas reglas de filtrado y selección de campos:
- Las consultas en
final_url_expansion_asset_viewdeben filtrar al menos uno de los siguientes elementos:campaign.advertising_channel_type,campaign(campaign.id,campaign.resource_nameofinal_url_expansion_asset_view.campaign) oad_group(ad_group.id,ad_group.resource_nameofinal_url_expansion_asset_view.ad_group). Si se omiten todos, se muestraFinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER. - Cuando consultes
final_url_expansion_asset_viewpara las campañas de Shopping a nivel de la cuenta o de la campaña, debes filtrar porcampaign.advertising_channel_type = 'SHOPPING'(o filtrar por un solo grupo de anuncios con=). El filtrado por campaña (campaign.id,campaign.resource_nameofinal_url_expansion_asset_view.campaign) también requierecampaign.advertising_channel_type = 'SHOPPING'; si se omite, se devuelveFinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER, mientras que el filtrado por un soload_groupcumple con el requisito de filtro por sí solo. - Los filtros en
campaign.advertising_channel_type,campaignoad_groupdeben usar el operador=en un solo valor. El uso deINo varias condiciones para el mismo tipo de recurso devuelveFinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE. - En el caso de las campañas de Shopping, puedes seleccionar y filtrar por campos
ad_group, pero no puedes seleccionar camposasset_group. Si seleccionas campos deasset_groupen las campañas de Shopping (o cuando filtras porad_group), se devuelveFinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP(oCANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUPcuando también se seleccionan campos dead_group). Filtrar porasset_groupmientras seleccionas camposad_groupdevuelveCANNOT_SELECT_AD_GROUP, y filtrar porad_groupyasset_groupdevuelveCANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.
La siguiente consulta recupera las métricas de rendimiento a nivel del recurso para las campañas de Shopping de los últimos 30 días:
SELECT
campaign.id,
campaign.name,
campaign.advertising_channel_type,
ad_group.id,
final_url_expansion_asset_view.asset,
final_url_expansion_asset_view.field_type,
final_url_expansion_asset_view.final_url,
final_url_expansion_asset_view.status,
metrics.impressions,
metrics.clicks,
metrics.conversions
FROM final_url_expansion_asset_view
WHERE
campaign.advertising_channel_type = 'SHOPPING'
AND segments.date DURING LAST_30_DAYS