Relatórios

Assim como em outros tipos de anúncios, você pode usar GoogleAdsService.SearchStream para recuperar o status e os dados de desempenho dos produtos do Google 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

Visualização de desempenho do Shopping

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

A Visualização de desempenho do Google Shopping captura o estado do produto no momento métricas relevantes forem registradas. Isso inclui segmentos como o product_title (título do produto) o que pode ter mudado desde que a métrica foi registrada.

Este é um exemplo de consulta que recupera impressões, cliques, custo e 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, depois 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 do grupo de produtos fornece relatórios estatísticas de relatórios das informações de produtos no Shopping grupos (chamados de produtos grupos na IU). Consulte o guia de relatórios das campanhas Performance Max para: Visualização do grupo de produtos do grupo de recursos exemplos.

Este é um exemplo de consulta que recupera impressões, cliques, conversões e todas as conversões dos grupos de produtos anunciados do Shopping por campanha com impressões no últimos 30 dias (classificados em ordem decrescente por todas as conversões, depois conversões, depois em cliques e depois em 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 produto do Shopping oferece atributos e estatísticas de relatórios para produtos que existem em Contas do Google Merchant Center vinculadas à conta do Google Ads. Este relatório pode ser usada para inspecionar estatísticas de uma campanha, nível do grupo de anúncios.

Este é 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 contas:

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 produto do Shopping pode retornar uma quantidade significativa de dados quando um está vinculada a um grande número de produtos. As recomendações a seguir podem ajudar a melhorar o desempenho de seus Consultas GAQL:

• As consultas nos níveis da campanha e do grupo de anúncios normalmente são mais rápidas do que as no nível da conta, já que eles provavelmente contêm menos produtos e exigem acesso a menos dados.
• Quanto mais campos e métricas na cláusula SELECT, mais lenta é a resposta 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. Você pode filtrar por shopping_product.status na WHERE para entender quais produtos têm probabilidade de retornar 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 às informações do produto em campanhas que utilizam feeds de produtos. Ela pode fornecer insights sobre o status dos produtos do Google Merchant Center contas, mas também informações específicas de anúncios, como métricas de desempenho e os problemas que impedem os produtos de veicular anúncios.

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

Os "problemas" do produto do Shopping é semelhante ao fornecido pelo productstatuses (link em inglês) na API Content for Shopping, com a adição de problemas específicos 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 do a 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 oferece suporte a métricas, status e problemas de todas as campanhas na conta de type

• 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 na Status:

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)

Especificação do relatório com um recurso de campanha como parte da cláusula WHERE 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

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 geram o status. Por exemplo, uma campanha pausada vai afetar o produto Status:

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)

Especificação do relatório com um recurso de grupo de anúncios e uma campanha e, como parte da cláusula WHERE, retornará todos os produtos incluídos no campanha selecionada. As métricas, o status e os problemas do produto serão refletidos se ele está 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. Ela permite confirmar que os filtros de grupos de produtos (no nível do grupo de anúncios) estão sendo aplicadas corretamente e para 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>"

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á para todos os produtos no nível da conta que estão (independentemente de as métricas serem diferentes de zero) para o período especificado.

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

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 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 em 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 shopping_performance_view para Campanhas do Shopping.

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 para campanhas do Shopping na 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 desempenho, 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