Relatórios de produtos para anúncios do Shopping

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

As campanhas que aceitam produtos de um feed do Google Merchant Center 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 vendas de dados do carrinho (disponível na v24 e em versões mais recentes)
• Visualização de recursos de expansão de URL final (disponível para campanhas do Shopping na v26 e versões mais recentes)

Além disso, a partir da v26, nas campanhas do Shopping, final_url_expansion_asset_view informa os recursos de personalização de texto veiculados quando a IA Max (campaign.ai_max_setting.enable_ai_max = true) e a expansão de URL final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) estão ativadas. Consulte a seção Visualização de recursos de expansão de URL final para ver os requisitos de consulta e um exemplo.

A visualização de performance do Shopping

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

Ele é compatível com todos os tipos de campanha 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.

shopping_performance_view também aceita 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 metrics.all_* métricas de dados do carrinho (que informam dados do carrinho em todas as conversões, incluindo as que não recebem lances).

Veja 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 produtos 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 de 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 direto em um produto), 100% do custo e do crédito de conversão associados 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 o usuário clica em um título, botão de call-to-action ou vídeo), o custo associado e o crédito de conversão são distribuídos de maneira uniforme entre todos os produtos veiculados nesse 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, independentemente de o produto estar visível na janela de visualização do usuário. Por isso, a soma das impressões de todos os produtos em 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 grupos de produtos

A visualização do grupo de produtos fornece estatísticas de relatórios agregadas para grupos de informações de produtos do Shopping (chamados de grupos de produtos na interface). Consulte o guia de relatórios de campanhas Performance Max para ver exemplos de visualização de grupos 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, 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

Relatório de produtos do Shopping

O relatório Produto 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. Ele é compatível com campanhas do Shopping, Performance Max, Geração de Demanda, de vídeo e para apps (na v24 e versões mais recentes). Também é possível consultar shopping_product.product_image_uri para recuperar o URI da imagem do produto fornecida pelo comerciante.

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) 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 as 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 o desempenho das suas consultas da GAQL:

• As consultas no nível da campanha e do grupo de anúncios costumam ser mais rápidas do que aquelas no nível 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 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. É possível 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 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, além de informações específicas de anúncios, como métricas de performance e problemas que impedem a veiculação de anúncios dos 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 verifique 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.

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

• Shopping
• 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 fornecido:

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)

Essa consulta permite ver o status de cada produto incluído em uma determinada campanha, 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 dos produtos (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 as métricas impressions, clicks e ctr, mas não status ou issues)

Essa consulta permite ver o status do produto em relação a esse grupo de anúncios. Ele permite confirmar se os filtros dos 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>'

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

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

Essa consulta permite ver 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:

• ad_group
• ad_group_ad
• campaign
• cart_data_sales_view (disponível na v24 e mais recentes)
• customer (agregado para todas as campanhas)
• product_group_view
• shopping_performance_view
• shopping_product (para métricas de dados do carrinho de metrics.all_* na v24 e em versões mais recentes)

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

Visualização de recursos da expansão de URL final

A partir da v26, você pode usar final_url_expansion_asset_view para medir a performance no nível do recurso para recursos de personalização de texto veiculados em campanhas do Shopping quando a IA Max (campaign.ai_max_setting.enable_ai_max = true) e a expansão de URL final (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) estão ativadas.

Ao consultar final_url_expansion_asset_view, siga estas regras de filtragem e seleção de campos:

• As consultas em final_url_expansion_asset_view precisam filtrar pelo menos um entre campaign.advertising_channel_type, campaign (campaign.id, campaign.resource_name ou final_url_expansion_asset_view.campaign) ou ad_group (ad_group.id, ad_group.resource_name ou final_url_expansion_asset_view.ad_group). Se todos forem omitidos, o retorno será FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER.
• Ao consultar final_url_expansion_asset_view para campanhas do Shopping no nível da conta ou da campanha, é necessário filtrar por campaign.advertising_channel_type = 'SHOPPING' (ou filtrar por um único grupo de anúncios usando =). A filtragem por uma campanha (campaign.id, campaign.resource_name ou final_url_expansion_asset_view.campaign) também requer campaign.advertising_channel_type = 'SHOPPING'. Se você omitir esse filtro, vai receber FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER, enquanto a filtragem por um único ad_group atende ao requisito de filtro por conta própria.
• Os filtros em campaign.advertising_channel_type, campaign ou ad_group precisam usar o operador = em um único valor. O uso de IN ou de várias condições para o mesmo tipo de recurso retorna FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE.
• Nas campanhas do Shopping, é possível selecionar e filtrar por campos ad_group, mas não é possível selecionar campos asset_group. Selecionar campos asset_group em campanhas do Shopping (ou ao filtrar por ad_group) retorna FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP (ou CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP quando os campos ad_group também são selecionados). Filtrar por asset_group ao selecionar campos ad_group retorna CANNOT_SELECT_AD_GROUP, e filtrar por ad_group e asset_group retorna CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.

A consulta a seguir recupera as métricas de performance no nível do recurso para campanhas do Shopping nos últimos 30 dias:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  final_url_expansion_asset_view.asset,
  final_url_expansion_asset_view.field_type,
  final_url_expansion_asset_view.final_url,
  final_url_expansion_asset_view.status,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions
FROM final_url_expansion_asset_view
WHERE
  campaign.advertising_channel_type = 'SHOPPING'
  AND segments.date DURING LAST_30_DAYS