Report sui prodotti per gli annunci Shopping

Come per altri tipi di annunci, puoi utilizzare GoogleAdsService.SearchStream per recuperare i dati sul rendimento e sullo stato dei prodotti Shopping.

Le campagne che supportano i prodotti di un feed di Google Merchant Center hanno i seguenti report dedicati:

• Visualizzazione del rendimento di Shopping
• Visualizzazione Gruppo di prodotti
• Asset Group Product Group View
• Prodotto Shopping
• Cart Data Sales View (disponibile nella versione 24 e successive)
• Visualizzazione degli asset di espansione dell'URL finale (disponibile per le campagne Shopping nella versione 26 e successive)

Inoltre, a partire dalla versione 26, nelle campagne Shopping, final_url_expansion_asset_view genera report sugli asset di personalizzazione del testo pubblicati quando sono attivati AI Max (campaign.ai_max_setting.enable_ai_max = true) e l'espansione dell'URL finale (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN). Per i requisiti delle query e un esempio, consulta la sezione Visualizzazione degli asset di espansione dell'URL finale.

Nota: sia shopping_performance_view che shopping_product restituiscono metriche a livello di prodotto. shopping_performance_view fornisce lo stato storico di un prodotto che ha pubblicato annunci, mentre shopping_product fornisce lo stato attuale di un prodotto, indipendentemente dal fatto che abbia pubblicato annunci o meno. Utilizza shopping_product principalmente per valutare lo stato attuale di un prodotto e gli eventuali problemi che ne impediscono l'utilizzo in una campagna.

La visualizzazione Rendimento di Shopping

La visualizzazione del rendimento di Shopping fornisce statistiche aggregate dei report storici per i prodotti in base ad attributi quali product_item_id.

Supporta tutti i tipi di campagne che utilizzano i feed dei prodotti di Google Merchant Center, tra cui le campagne Shopping, Performance Max, Demand Gen, video, per app e display.

Nota: a partire dal 15 giugno 2026, la visualizzazione del rendimento di Shopping include i dati di tutte le reti Performance Max. Potresti notare un aumento una tantum delle metriche dei report per le campagne Performance Max, poiché vengono incorporati i dati delle reti precedentemente escluse (come YouTube).

La visualizzazione del rendimento di Shopping acquisisce lo stato del prodotto al momento della registrazione delle metriche pertinenti. Sono inclusi segmenti come product_title, che potrebbero essere cambiati da quando è stata registrata la metrica.

shopping_performance_view supporta anche i seguenti segmenti e metriche:

• segments.ad_sub_network_type (supportato anche in product_group_view e asset_group_product_group_view).
• Metriche segmentate per data di conversione: 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.
• Metriche della quota impressioni della concorrenza: 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.
• Disponibile nella versione 24 e successive: il segmento segments.conversion_attribution_event_type e le metriche dei dati del carrello metrics.all_* (che registrano i dati del carrello per tutte le conversioni, incluse quelle non disponibili per le offerte).

Ecco una query di esempio che recupera impressioni, clic, costo, conversioni e tutte le conversioni per i prodotti per product_item_id con clic negli ultimi 30 giorni (ordinati in ordine decrescente per tutte le conversioni, poi per conversioni, clic, costo e impressioni):

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

Logica di attribuzione per i report sui prodotti

I report a livello di prodotto utilizzano un framework di attribuzione specifico per assegnare il merito del rendimento ai singoli prodotti quando più prodotti vengono visualizzati in un singolo annuncio.

Metriche finanziarie

Le metriche finanziarie, come metrics.cost_micros e metrics.conversions, vengono calcolate per garantire che la loro somma per tutti i prodotti non superi i report a livello di campagna.

Interazioni dirette

Quando l'intenzione dell'utente è chiara e legata a un singolo prodotto (ad esempio un clic direttamente su un prodotto), il 100% del costo e del merito di conversione associati viene attribuito a quel prodotto specifico.

Interazioni indirette

Quando l'user intent è indirizzato all'annuncio nel suo complesso (ad esempio, se l'utente fa clic su un titolo, un pulsante call to action o un video), il costo e il merito della conversione associati vengono distribuiti in modo uniforme tra tutti i prodotti pubblicati in quell'annuncio specifico.

Metriche di interazione

Le metriche di interazione, come metrics.impressions e metrics.clicks, misurano il coinvolgimento specifico del prodotto.

Per le impressioni, il conteggio viene incrementato per ogni prodotto incluso nell'annuncio quando si verifica l'evento, indipendentemente dal fatto che il prodotto fosse visibile nell'area visibile dell'utente. Per questo motivo, la somma delle impressioni di tutti i prodotti in un report potrebbe essere notevolmente superiore ai totali corrispondenti a livello di campagna.

Al contrario, metrics.clicks misura solo i clic che si sono verificati su quel prodotto specifico. Nella UI di Google Ads, il campo metrics.clicks è etichettato esplicitamente come Clic sul prodotto.

Visualizzazione Gruppo di prodotti

La visualizzazione Gruppo di prodotti fornisce statistiche dei report aggregate per i gruppi di schede di prodotto Shopping (indicati come gruppi di prodotti nell'interfaccia utente). Per esempi di Asset Group Product Group View, consulta la guida ai report di Performance Max.

Ecco una query di esempio che recupera impressioni, clic, conversioni e tutte le conversioni per i gruppi di schede Shopping per campagna con impressioni negli ultimi 30 giorni (ordinate in ordine decrescente in base a tutte le conversioni, poi alle conversioni, ai clic e alle impressioni):

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

Report sui prodotti Shopping

Il report Prodotto Shopping fornisce gli attributi e le statistiche dei report per i prodotti presenti negli account Google Merchant Center collegati all'account Google Ads. Questo report può essere utilizzato per esaminare le statistiche a livello di cliente, campagna e gruppo di annunci. Supporta le campagne Shopping, Performance Max, Demand Gen, video e (nella versione 24 e successive) per app. Puoi anche eseguire query su shopping_product.product_image_uri per recuperare l'URI dell'immagine del prodotto fornita dal commerciante.

Ecco un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni degli ultimi 30 giorni (ordinate in ordine decrescente in base a tutte le conversioni, poi alle conversioni, ai clic e alle impressioni) per tutti i prodotti Shopping di tutti gli account Google Merchant Center collegati:

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

Per ulteriori dettagli sulle query, consulta la guida ai report.

Considerazioni sulle prestazioni

Il report sui prodotti Shopping può restituire una quantità significativa di dati quando un account è collegato a un numero elevato di prodotti. I seguenti consigli possono aiutarti a migliorare il rendimento delle query GAQL:

• Le query a livello di campagna e gruppo di annunci sono in genere più veloci di quelle a livello di account, in quanto è probabile che contengano meno prodotti e richiedano l'accesso a meno dati.
• Più campi e metriche sono presenti nella clausola SELECT, più lento sarà il tempo di risposta. Seleziona solo i campi e le metriche che ti servono nella query.
• I prodotti con uno o più problemi restituiscono più dati. Puoi filtrare in base a shopping_product.status nella clausola WHERE per capire quali prodotti potrebbero restituire problemi che hanno causato lo stato pertinente.

Casi d'uso comuni per il report sui prodotti di Shopping

Il report Prodotto Shopping fornisce un accesso flessibile alle informazioni sui prodotti per le campagne che utilizzano i feed dei prodotti. Può fornirti informazioni sullo stato dei prodotti degli account Google Merchant Center, nonché informazioni specifiche sugli annunci, come le metriche sul rendimento e i problemi che impediscono la pubblicazione degli annunci per i prodotti.

Questa sezione illustra alcuni casi d'uso tipici simili a quelli possibili nella visualizzazione Prodotti nell'interfaccia utente di Google Ads.

Il campo issues per shopping_product è simile a ProductStatus nell'API Merchant, con l'aggiunta di problemi specifici di Google Ads. Per verificare se il problema deve essere risolto in Google Merchant Center o Google Ads, controlla innanzitutto il campo shopping_product.issues.documentation della risposta, che include un articolo del Centro assistenza per aiutarti.

Stati del prodotto (livello di account)

Se specifichi il report senza filtri per campagna o gruppo di annunci, vengono restituiti tutti i prodotti a livello di account.

Supporta metriche, stato e problemi di tutte le campagne nell'account di tipo:

• Shopping
• Performance Max

Questa query ti consente di visualizzare lo stato del prodotto, ad esempio NOT_ELIGIBLE, e un elenco di problemi specifici del prodotto che hanno generato lo stato indicato:

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

Stati dei prodotti (a livello di campagna)

Se specifichi il report con una risorsa campagna come parte della clausola WHERE, vengono restituiti tutti i prodotti inclusi nella campagna selezionata.

È supportato dai seguenti tipi di campagne che possono utilizzare i feed dei prodotti:

• Shopping
• Performance Max
• Demand Gen
• Video
• App (disponibile nella versione 24 e successive)

Nota: per le campagne Demand Gen, video e (nella versione 24 e successive) per app, sono supportate solo le metriche impressions, clicks e ctr. Inoltre, shopping_product.status e shopping_product.issues non sono supportati per le campagne per app.

Questa query ti consente di visualizzare lo stato di ogni prodotto incluso in una determinata campagna, inclusi i problemi che causano lo stato. Ad esempio, una campagna in pausa influisce sullo stato del prodotto:

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

Stati dei prodotti (a livello di gruppo di annunci)

Se specifichi il report con sia una risorsa gruppo di annunci sia una risorsa campagna come parte della clausola WHERE, vengono restituiti tutti i prodotti inclusi nella campagna selezionata. Le metriche, lo stato e i problemi del prodotto indicano se è incluso o escluso dal gruppo di annunci selezionato.

È supportato dai seguenti tipi di campagne:

• Shopping
• Demand Gen
• Video
• App (disponibile nella versione 24 e successive; supporta solo le metriche impressions, clicks e ctr e non supporta status o issues)

Questa query ti consente di visualizzare lo stato del prodotto rispetto a quel gruppo di annunci. Ti consente di verificare che i filtri dei gruppi di prodotti (a livello di gruppo di annunci) vengano applicati correttamente e di controllare lo stato di ogni prodotto:

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

Nota: sia la campagna sia il gruppo di annunci devono essere specificati nella clausola WHERE. Se uno o l'altro non è presente, la query genera uno dei seguenti errori: MISSING_CAMPAIGN_FILTER o MISSING_AD_GROUP_FILTER.

Metriche dei prodotti, filtrate per data (livello di account)

Se specifichi il report con una data o un intervallo di date nella clausola WHERE, vengono restituite le metriche per tutti i prodotti a livello di account per il periodo di tempo specificato, indipendentemente dal fatto che le metriche siano diverse da zero.

Non puoi selezionare segments.date; se lo fai, viene generato un errore UNSUPPORTED_DATE_SEGMENTATION.

Questa query ti consente di visualizzare il rendimento di ogni prodotto per un determinato giorno o un altro intervallo di date compatibile, aggregato per tutte le campagne:

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

Rendimento dei prodotti con dati del carrello

Gli inserzionisti nel settore della vendita al dettaglio possono accedere a metriche pertinenti su vendite e profitti, come Entrate, Profitto lordo, Margine di profitto lordo e Unità vendute. Queste metriche sono disponibili per tutti gli inserzionisti che implementano le conversioni con dati del carrello nelle campagne Shopping e sono compatibili con i seguenti report:

• ad_group
• ad_group_ad
• campaign
• cart_data_sales_view (disponibile nella versione 24 e successive)
• customer (aggregato per tutte le campagne)
• product_group_view
• shopping_performance_view
• shopping_product (per le metriche dei dati del carrello metrics.all_* nella versione 24 e successive)

Le seguenti metriche dei dati del carrello possono essere utilizzate nei report, ad esempio shopping_performance_view, per le campagne 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

Nella versione 24 e successive, sono disponibili anche le seguenti metriche dei dati del carrello per i report su tutte le conversioni (incluse quelle non disponibili per le offerte):

metrics.all_average_cart_size
metrics.all_average_order_value_micros
metrics.all_cost_of_goods_sold_micros
metrics.all_cross_sell_cost_of_goods_sold_micros
metrics.all_cross_sell_gross_profit_micros
metrics.all_cross_sell_revenue_micros
metrics.all_cross_sell_units_sold
metrics.all_gross_profit_margin
metrics.all_gross_profit_micros
metrics.all_lead_cost_of_goods_sold_micros
metrics.all_lead_gross_profit_micros
metrics.all_lead_revenue_micros
metrics.all_lead_units_sold
metrics.all_orders
metrics.all_revenue_micros
metrics.all_units_sold

Nota: le metriche dei dati del carrello non sono disponibili finché non vengono registrate le conversioni per i prodotti associati. Le query su shopping_performance_view possono richiedere più tempo per l'esecuzione per gli account con un numero elevato di prodotti, anche con i filtri applicati.

L'esempio seguente mostra come utilizzare le metriche dei dati del carrello per analizzare il rendimento a livello di prodotto per le campagne Shopping negli ultimi 30 giorni:

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

Rendimento della campagna con dati del carrello

Le metriche dei dati del carrello possono essere utilizzate a livello di campagna e possono essere combinate con altre metriche sul rendimento, come impressioni, clic e costo:

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

Visualizzazione degli asset di espansione dell'URL finale

A partire dalla versione 26, puoi utilizzare final_url_expansion_asset_view per misurare il rendimento a livello di asset per gli asset di personalizzazione del testo pubblicati nelle campagne Shopping quando AI Max (campaign.ai_max_setting.enable_ai_max = true) e l'espansione dell'URL finale (FINAL_URL_EXPANSION_TEXT_ASSET_AUTOMATION = OPTED_IN) sono attivati.

Quando esegui query su final_url_expansion_asset_view, segui queste regole di filtro e selezione dei campi:

• Le query su final_url_expansion_asset_view devono filtrare in base ad almeno uno dei seguenti elementi: campaign.advertising_channel_type, campaign (campaign.id, campaign.resource_name o final_url_expansion_asset_view.campaign) o ad_group (ad_group.id, ad_group.resource_name o final_url_expansion_asset_view.ad_group); se li ometti tutti, viene restituito FinalUrlExpansionAssetViewError.MISSING_REQUIRED_FILTER.
• Quando esegui una query su final_url_expansion_asset_view per le campagne Shopping a livello di account o campagna, devi filtrare in base a campaign.advertising_channel_type = 'SHOPPING' (o filtrare in base a un singolo gruppo di annunci utilizzando =). Il filtro in base a una campagna (campaign.id, campaign.resource_name o final_url_expansion_asset_view.campaign) richiede anche campaign.advertising_channel_type = 'SHOPPING'; se lo ometti, viene restituito FinalUrlExpansionAssetViewError.REQUIRES_ADVERTISING_CHANNEL_TYPE_FILTER, mentre il filtro in base a un singolo ad_group soddisfa il requisito del filtro da solo.
• I filtri su campaign.advertising_channel_type, campaign o ad_group devono utilizzare l'operatore = su un singolo valore; l'utilizzo di IN o di più condizioni per lo stesso tipo di risorsa restituisce FinalUrlExpansionAssetViewError.REQUIRES_FILTER_BY_SINGLE_RESOURCE.
• Per le campagne Shopping, puoi selezionare e filtrare in base ai campi ad_group, ma non puoi selezionare i campi asset_group. Se selezioni i campi asset_group nelle campagne Shopping (o quando filtri per ad_group), viene restituito FinalUrlExpansionAssetViewError.CANNOT_SELECT_ASSET_GROUP (o CANNOT_SELECT_BOTH_AD_GROUP_AND_ASSET_GROUP quando vengono selezionati anche i campi ad_group). Se filtri per asset_group e selezioni i campi ad_group, vengono restituiti CANNOT_SELECT_AD_GROUP, mentre se filtri sia per ad_group sia per asset_group, vengono restituiti CANNOT_FILTER_BY_BOTH_AD_GROUP_AND_ASSET_GROUP.

La seguente query recupera le metriche sul rendimento a livello di asset per le campagne Shopping negli ultimi 30 giorni:

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