Relatórios

Assim como em outros tipos de anúncios, é possível usar GoogleAdsService.SearchStream para extrair o status do produto e os dados de performance dos itens do Shopping.

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

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

Observação: a "Visualização de performance do Shopping" e o "Produto do Shopping" podem retornar métricas no nível do produto. A "Visualização de desempenho do Shopping" mostra o estado "histórico" de um produto que veiculou anúncios, enquanto a opção "Produto do Shopping" mostra o estado atual de um produto, independentemente de ele ter veiculado anúncios ou não. É recomendável usar "Produto do Shopping" principalmente para avaliar o "estado" de um produto e os problemas que impedem que ele seja usado por uma campanha.

Visualização de performance do Shopping

A Visualização de performance do Shopping oferece estatísticas históricas agregadas de relatórios de produtos por atributos, como product_item_id.

A visualização de desempenho da compra 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 (ordenados em ordem decrescente por todas as conversões, depois conversões, depois cliques, depois custo e depois 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 grupos de produtos oferece estatísticas de relatórios agregados para grupos de listagens do Shopping (chamados de grupos de produtos na interface). Consulte o guia de relatórios das campanhas Performance Max para conferir 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 de grupos de fichas do Shopping por campanha com impressões nos últimos 30 dias (ordenadas em ordem decrescente por todas as conversões, depois conversões, depois cliques e depois 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 mostra os atributos e as estatísticas de relatórios dos produtos que estão 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 (ordenadas em ordem decrescente por todas as conversões, depois conversões, depois cliques e depois 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 consultas no nível da conta, porque tendem a conter menos produtos e a exigir 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 métricas necessários na consulta.
• Os produtos com um ou mais problemas vão retornar mais dados. É possível filtrar por shopping_product.status no WHERE para entender quais produtos provavelmente vão retornar problemas que causaram o status relevante.

Casos de uso do relatório de produtos do Shopping

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

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

O campo "issues" 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 verifique o campo shopping_product.issues.documentation da resposta, que inclui um artigo da Central de Ajuda.

Status dos produtos (nível da conta)

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

Ele aceita métricas, status e problemas de todas as campanhas na conta do tipo:

• Shopping
• Performance Max

Essa consulta permite que você veja o status do produto, por exemplo, NOT_ELIGIBLE, e uma lista de problemas específicos do produto que resultaram no status especificado:

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:

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

Essa consulta mostra o status do produto incluído em uma determinada campanha. Ela permite verificar o status de cada produto, incluindo os problemas que causam esse status. Por exemplo, uma campanha pausada vai afetar 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 ambos, um recurso de grupo de anúncios e um recurso de campanha, e 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.

Essa consulta permite que você veja o status do produto em relação a esse grupo de anúncios. Ele permite confirmar se os filtros de grupos 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 resultará nos seguintes erros: MISSING_CAMPAIGN_FILTER e MISSING_AD_GROUP_FILTER.

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

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

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

Essa consulta permite que você veja 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'

Desempenho 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 métricas de dados do carrinho a seguir 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 dos dados do carrinho não estão disponíveis até que as conversões sejam registradas para os produtos associados. As consultas no shopping_performance_view podem levar mais tempo para ser 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 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

Desempenho 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