Relatórios

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

As campanhas compatíveis com produtos têm os seguintes relatórios dedicados:

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

Observação: tanto "Performance View" quanto "Produto do Shopping" podem retornar métricas no nível do produto. A "Visualização de desempenho do Shopping" fornece o estado "histórico" de um produto que veiculou anúncios, enquanto "Produto do Shopping" fornece o estado atual de um produto, independentemente de ele ter 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 por uma campanha.

Visualização de desempenho do Shopping

A Visualização de desempenho do Shopping fornece estatísticas históricas de relatórios agregados para produtos por atributos como product_item_id.

A Visualização de desempenho 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 do grupo de produtos

A visualização de grupo de produtos fornece estatísticas de relatórios agregados para grupos de produtos anunciados 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 do grupo de produtos do grupo de recursos.

Veja um exemplo de consulta que recupera impressões, cliques, conversões e todas as conversões de grupos de produtos anunciados do Shopping por campanha com impressões nos últimos 30 dias (classificadas em ordem decrescente por todas as conversões, depois conversões, depois cliques e 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 de produtos do Shopping fornece os atributos e as estatísticas de relatórios para produtos que existem em 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.

Veja 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) de 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 performance

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 o desempenho 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 da conta, já que provavelmente contêm menos produtos e exigem acesso a menos dados.
• Quanto mais campos e métricas na cláusula SELECT, mais lento é o tempo de resposta. Recomendamos selecionar apenas os campos e as métricas necessários na consulta.
• 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 retornarão problemas que causaram o status relevante.

Casos de uso do relatório de produtos do Shopping

O Relatório de produtos do Shopping oferece acesso flexível às informações dos produtos 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 sobre informações específicas dos anúncios, como métricas de desempenho e problemas que estão impedindo 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, mas com 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 campanha ou grupo de anúncios retornará todos os produtos no nível da conta.

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

• Compras
• Performance Max

Essa consulta permite ver o status do produto, por exemplo, NOT_ELIGIBLE, e uma lista de problemas específicos do produto que resultaram no status 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

Status dos produtos (nível da campanha)

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

Ela é compatível com os seguintes tipos de campanha que podem utilizar feeds de produtos:

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

Essa consulta permite que você veja o status do produto incluído em uma determinada campanha. Ele permite verificar o status de cada produto, incluindo os problemas que estão causando o status. Por exemplo, uma campanha pausada 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 dos produtos (nível do grupo de anúncios)

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

Essa consulta permite ver o status do produto em relação àquele grupo de anúncios. Ele permite confirmar que os filtros do 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 devem 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 período na cláusula WHERE retornará as métricas de todos os produtos no nível da conta que estiverem no período especificado, independentemente de serem diferentes de zero.

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

Essa consulta permite ver o desempenho 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 devolvido 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 lucros, 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 em campanhas do Shopping e são compatíveis com os relatórios a seguir.

• 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 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ó estarão disponíveis depois que as conversões forem registradas para os produtos associados. As consultas no 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 das 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