Relatórios de produtos para anúncios do Shopping

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 de um feed do Google Merchant Center têm os seguintes relatórios dedicados:

A visualização da performance no Shopping

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

Ele é compatível com todos os tipos de campanhas que usam feeds de produtos do Google Merchant Center, incluindo campanhas do Shopping, Performance Max, Geração de Demanda, de vídeo, para apps e de display.

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 product_title, que podem ter mudado desde que a métrica foi registrada.

O shopping_performance_view também é compatível com os seguintes segmentos e métricas:

  • segments.ad_sub_network_type (também compatível com product_group_view e asset_group_product_group_view).
  • Métricas segmentadas por data de conversão: 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_date e metrics.value_per_all_conversions_by_conversion_date.
  • Métricas de parcela de impressões competitivas: metrics.search_budget_lost_impression_share, metrics.search_rank_lost_impression_share, metrics.search_budget_lost_absolute_top_impression_share e metrics.search_rank_lost_absolute_top_impression_share.
  • Disponível na v24 e em versões mais recentes:o segmento segments.conversion_attribution_event_type e as métricas de dados do carrinho metrics.all_*, que informam dados do carrinho em todas as conversões, incluindo as que não recebem lances.

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

Lógica de atribuição para relatórios de produtos

Os relatórios no nível do produto usam uma estrutura de atribuição específica para creditar a performance a produtos individuais quando vários deles aparecem em um único anúncio.

Métricas financeiras

As métricas financeiras, como metrics.cost_micros e metrics.conversions, são calculadas para garantir que a soma delas em todos os produtos não exceda os relatórios no nível da campanha.

Interações diretas
Quando a intenção do usuário é clara e está vinculada a um único produto (como um clique diretamente em um produto), 100% do custo associado e do crédito pela conversão são atribuídos a esse produto específico.
Interações indiretas
Quando a intenção do usuário é direcionada ao anúncio como um todo (por exemplo, se ele clica em um título, um botão de call-to-action ou um vídeo), o custo associado e o crédito pela conversão são distribuídos uniformemente entre todos os produtos veiculados naquele anúncio específico.

Métricas de interação

As métricas de interação, como metrics.impressions e metrics.clicks, medem o engajamento específico do produto.

Para impressões, a contagem é incrementada para cada produto incluído no anúncio quando o evento ocorre, independente de o produto estar visível na janela de visualização do usuário. Por isso, a soma das impressões em todos os produtos de um relatório pode ser significativamente maior do que os totais correspondentes no nível da campanha.

Por outro lado, metrics.clicks mede apenas os cliques que ocorreram nesse produto específico. Na interface do Google Ads, o campo metrics.clicks é explicitamente rotulado como Cliques no produto.

Visualização de grupo de produtos

A visualização de grupo de produtos oferece estatísticas de relatórios agregados para grupos de produtos do Shopping (chamados de grupos de produtos na interface). Consulte o guia de relatórios das campanhas Performance Max para ver exemplos da 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

O relatório de produtos 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. Ele pode ser usado para inspecionar estatísticas no nível do cliente, da campanha e do grupo de anúncios. Ele é compatível com campanhas do Shopping, Performance Max, Geração de demanda, de vídeo e (na v24 e versões mais recentes) para apps. Você também pode consultar shopping_product.product_image_uri para recuperar o URI da imagem do produto fornecida pelo comerciante.

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, 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 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. Selecione apenas os campos e as métricas necessários na consulta.
  • Os produtos com um ou mais problemas retornam mais dados. Você pode filtrar por shopping_product.status na cláusula WHERE para entender quais produtos podem retornar problemas que causaram o status relevante.

Casos de uso comuns para o relatório de produtos do Shopping

O relatório Produto do Shopping oferece acesso flexível a 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, além de informações específicas dos anúncios, como métricas de performance e problemas que impedem a veiculação de anúncios de produtos.

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 para shopping_product é semelhante a ProductStatus na API Merchant, 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 retorna todos os produtos no nível da conta.

Ela oferece suporte a métricas, status e problemas de todas as campanhas na conta do tipo:

  • Shopping
  • Performance Max

Essa consulta permite 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 dos produtos (nível da campanha)

Especificar o relatório com um recurso de campanha como parte da cláusula WHERE retorna 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
  • App (disponível na v24 e em versões mais recentes)

Com essa consulta, é possível conferir o status de cada produto incluído em uma campanha específica, 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 retorna todos os produtos incluídos na campanha selecionada. As métricas, o status e os problemas do produto refletem se ele está incluído ou excluído do grupo de anúncios selecionado.

Ele é compatível com os seguintes tipos de campanha:

  • Shopping
  • Geração de demanda
  • Vídeo
  • App (disponível na v24 e em versões mais recentes; aceita apenas métricas impressions, clicks e ctr e não aceita status nem issues)

Com essa consulta, você pode conferir o status do produto em relação ao grupo de anúncios. Com ele, é possível 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>'

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

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

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

Com essa consulta, você pode conferir a performance de cada produto em um determinado dia ou outro período compatível, agregada 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 DURING LAST_30_DAYS

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:

As seguintes métricas de dados do carrinho podem ser usadas em relatórios, como o shopping_performance_view, para campanhas do Shopping:

Na v24 e em versões mais recentes, as seguintes métricas de dados do carrinho também estão disponíveis para gerar relatórios em todas as conversões (incluindo as que não recebem lances):

O exemplo a seguir mostra 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