Relatórios

Assim como em outros tipos de anúncios, você pode usar GoogleAdsService.SearchStream para recuperar o status do produto e os dados de performance dos produtos do Shopping.

As campanhas que oferecem suporte a produtos têm os seguintes relatórios dedicados:

• Visualização do desempenho do Shopping
• Visualização do grupo de produtos
• Visualização de grupo de produtos do grupo de recursos
• Produto do Shopping

Observação: tanto a "Visualização de performance do Shopping" quanto o "Produto do Shopping" podem retornar métricas no nível do produto. A "Visualização de performance do Shopping" fornece o estado "histórico" de um produto que veiculou anúncios, enquanto o "Produto do Shopping" fornece o estado atual de um produto, tenha ele veiculado anúncios ou não. Recomendamos que "Produto do Shopping" seja usado principalmente para avaliar o "estado" de um produto e quaisquer problemas que impeçam o uso dele em uma campanha.

Visualização da performance do Shopping

A visão de performance do Shopping fornece estatísticas agregadas de relatórios históricos para produtos por atributos, como product_item_id.

A visualização de performance do Shopping captura o estado do produto no momento em que as métricas relevantes foram registradas. Isso inclui segmentos como o product_title, que pode ter mudado desde que a métrica foi registrada.

Confira um exemplo de consulta que recupera impressões, cliques, custo, conversões e todas as conversões de produtos por product_item_id com cliques nos últimos 30 dias (classificados em ordem decrescente por todas as conversões, depois conversões, cliques, custo e impressões):

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

Visualização de grupo de produtos

A visualização de grupo de produtos fornece estatísticas de relatórios agregados para grupos de informações de produtos do Shopping (chamados de grupos de produtos na interface). Consulte o guia de relatórios das campanhas Performance Max para exemplos de Visualização de grupo de produtos do grupo de recursos.

Confira um exemplo de consulta que recupera impressões, cliques, conversões e todas as conversões para grupos de anúncios do Shopping por campanha com impressões nos últimos 30 dias (classificados em ordem decrescente por todas as conversões, depois conversões, depois cliques e, por fim, impressões):

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

Produto do Shopping

O relatório Produto do Shopping fornece os atributos e as estatísticas de relatórios dos produtos que existem nas contas do Google Merchant Center vinculadas à conta do Google Ads. Esse relatório pode ser usado para inspecionar estatísticas no nível do cliente, da campanha e do grupo de anúncios.

Confira um exemplo de consulta que recupera impressões, cliques, conversões e todas as conversões dos últimos 30 dias (classificadas em ordem decrescente por todas as conversões, depois conversões, cliques e impressões) para todos os produtos do Shopping de todas as contas vinculadas do 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

Consulte o guia de relatórios para mais detalhes sobre consultas.

Considerações sobre desempenho

O relatório de produtos do Shopping pode retornar uma quantidade significativa de dados quando uma conta está vinculada a um grande número de produtos. As recomendações a seguir podem ajudar a melhorar a performance das suas consultas GAQL:

• As consultas no nível da campanha e do grupo de anúncios geralmente são mais rápidas do que as no nível da conta, porque provavelmente contêm menos produtos e exigem acesso a menos dados.
• Quanto mais campos e métricas na cláusula SELECT, mais lento será o tempo de resposta. Recomendamos selecionar apenas os campos e as métricas necessários na consulta.
• Considere que produtos com um ou mais problemas vão retornar mais dados. Você pode filtrar por shopping_product.status no WHERE para entender quais produtos provavelmente vão retornar problemas que causaram o status relevante.

Casos de uso de relatórios de produtos do Shopping

O relatório Produto do Shopping oferece acesso flexível às informações de produtos para campanhas que usam feeds de produtos. Ele pode fornecer insights sobre o status dos produtos das contas do Google Merchant Center, além de informações específicas sobre anúncios, como métricas de performance e problemas que impedem a veiculação de anúncios.

Esta seção aborda alguns casos de uso típicos semelhantes aos possíveis na visualização Produtos da interface do Google Ads.

O campo "problemas" do produto do Shopping é semelhante ao fornecido por productstatuses na API Content for Shopping, com a adição de problemas específicos do Google Ads. Para verificar se o problema precisa ser resolvido no Google Merchant Center ou no Google Ads, primeiro confira o campo shopping_product.issues.documentation da resposta, que inclui um artigo da Central de Ajuda para ajudar.

Status dos produtos (nível da conta)

Especificar o relatório sem filtros para campanha ou grupo de anúncios vai retornar todos os produtos no nível da conta.

Ela é compatível com métricas, status e problemas de todas as campanhas na conta do tipo:

• Compras
• Performance Max

Com essa consulta, você pode conferir o status do produto, por exemplo, NOT_ELIGIBLE, e uma lista de problemas específicos do produto que resultaram no status informado:

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

Status do produto (nível da campanha)

Especificar o relatório com um recurso de campanha como parte da cláusula WHERE vai retornar todos os produtos incluídos na campanha selecionada.

Ele é compatível com os seguintes tipos de campanha que podem usar feeds de produtos:

• Compras
• Performance Max
• Geração de demanda
• Vídeo

Com essa consulta, você pode conferir o status do produto incluído em uma campanha específica. Com ela, é possível verificar o status de cada produto, incluindo os problemas que estão causando o status. Por exemplo, uma campanha pausada afeta o status do produto:

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>"

Status do produto (nível do grupo de anúncios)

Especificar o relatório com um recurso de grupo de anúncios e um recurso de campanha como parte da cláusula WHERE vai retornar todos os produtos incluídos na campanha selecionada. As métricas, o status e os problemas do produto vão refletir se ele está incluído ou excluído do grupo de anúncios selecionado.

Com essa consulta, você pode conferir o status do produto em relação ao grupo de anúncios. Com ele, você pode confirmar se os filtros de grupo de produtos (no nível do grupo de anúncios) estão sendo aplicados corretamente e verificar o status de cada produto:

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>"

Observação: a campanha e o grupo de anúncios precisam ser especificados na cláusula WHERE. Se um ou outro não estiver presente, isso vai resultar em um dos seguintes erros: MISSING_CAMPAIGN_FILTER e MISSING_AD_GROUP_FILTER.

Métricas de produto, filtradas por data (nível da conta)

Especificar o relatório com uma data ou período na cláusula WHERE vai retornar métricas de todos os produtos no nível da conta (independente de serem diferentes de zero) para o período especificado.

Não é possível selecionar segments.date. Isso resultaria em um erro UNSUPPORTED_DATE_SEGMENTATION.

Com essa consulta, você pode conferir a performance do produto atual em um determinado dia ou outro valor de data compatível. Isso pode ser usado para criar um resumo de cada produto retornado agregado em todas as campanhas:

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'

Performance do produto com dados do carrinho

Os anunciantes de varejo podem acessar métricas relevantes de vendas e lucro, como receita, lucro bruto, margem de lucro bruto e unidades vendidas. Essas métricas estão disponíveis para todos os anunciantes que implementam Conversões com dados do carrinho nas campanhas do Shopping e são compatíveis com os seguintes relatórios:

• ad_group
• ad_group_ad
• campaign
• customer (agregado para todas as campanhas)
• product_group_view
• shopping_performance_view

As seguintes métricas de dados do carrinho podem ser usadas em relatórios, como o shopping_performance_view, para campanhas do 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

Observação: as métricas de dados do carrinho só ficam disponíveis depois que as conversões dos produtos associados são registradas. As consultas em shopping_performance_view podem levar mais tempo para serem executadas em contas com um grande número de produtos, mesmo com filtros aplicados.

O exemplo a seguir demonstra como as métricas de dados do carrinho podem ser usadas para analisar a performance no nível do produto nas campanhas do Shopping nos últimos 30 dias.

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

Performance da campanha com dados do carrinho

As métricas de dados do carrinho podem ser usadas no nível da campanha e combinadas com outras métricas de performance, como impressões, cliques e custo.

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