Rapporti

Come per gli 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 hanno i seguenti report dedicati:

• Vista del rendimento di Shopping
• Vista del gruppo di prodotti
• Vista del gruppo di prodotti del gruppo di asset
• Prodotto Shopping

Nota: sia la "Vista del rendimento di Shopping" sia "Prodotto Shopping" sono in grado di restituire metriche a livello di prodotto. La "Vista del rendimento di Shopping" fornirà lo stato "storico" di un prodotto che ha pubblicato annunci, mentre "Prodotto Shopping" fornisce lo stato attuale di un prodotto, indipendentemente dal fatto che abbia pubblicato annunci o meno. Ti consigliamo di utilizzare "Prodotto Shopping" principalmente per valutare lo "stato" di un prodotto e gli eventuali problemi che ne impediscono l'utilizzo da parte di una campagna.

Vista del rendimento di Shopping

La vista del rendimento di Shopping fornisce statistiche di report storici aggregati per i prodotti in base ad attributi come product_item_id.

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

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

SELECT
  segments.product_item_id,
  metrics.clicks,
  metrics.cost_micros,
  metrics.impressions,
  metrics.search_budget_lost_impression_share,
  metrics.search_rank_lost_impression_share,
  metrics.search_budget_lost_absolute_top_impression_share,
  metrics.search_rank_lost_absolute_top_impression_share,
  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

Vista del gruppo di prodotti

La vista Gruppo di prodotti fornisce statistiche di report aggregate per i gruppi di schede Shopping (denominati gruppi di prodotti nell'interfaccia utente). Per esempi di vista del gruppo di prodotti del gruppo di asset, 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 (ordinati in ordine decrescente per tutte le conversioni, poi conversioni, poi clic, poi 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

Prodotto Shopping

Il report Prodotto Shopping fornisce gli attributi e le statistiche di report per i prodotti esistenti 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.

Ecco una query di esempio che recupera impressioni, clic, conversioni e tutte le conversioni negli ultimi 30 giorni (ordinati in ordine decrescente per tutte le conversioni, poi conversioni, poi clic, poi 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 Prodotto Shopping può restituire una quantità significativa di dati quando un account è collegato a un numero elevato di prodotti. I seguenti suggerimenti possono aiutarti a migliorare il rendimento delle query GAQL:

• Le query a livello di campagna e gruppo di annunci in genere sono 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 è il tempo di risposta. Ti consigliamo di selezionare solo i campi e le metriche di cui hai bisogno nella query.
• Tieni presente che i prodotti con uno o più problemi restituiranno 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 del report Prodotto 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, ma anche informazioni specifiche sugli annunci, come metriche sul rendimento e problemi che impediscono la pubblicazione degli annunci dei prodotti.

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

Il campo 'problemi' per Prodotto Shopping è simile a quello fornito da productstatuses in API Content for Shopping, 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 prima il campo shopping_product.issues.documentation della risposta, che include un articolo del Centro assistenza per aiutarti.

Stati dei prodotti (a livello di account)

Se specifichi il report senza filtri per campagna o gruppo di annunci, verranno 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 comportato 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, verranno 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

Questa query ti consente di visualizzare lo stato del prodotto incluso in una determinata campagna. Ti consente di controllare lo stato di ogni prodotto, inclusi i problemi che causano lo stato. Ad esempio, una campagna in pausa influirà 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, verranno restituiti tutti i prodotti inclusi nella campagna selezionata. Le metriche, lo stato e i problemi del prodotto rifletteranno se è incluso o escluso dal gruppo di annunci selezionato.

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: nella clausola WHERE devono essere specificati sia la campagna sia il gruppo di annunci. Se uno o l'altro non è presente, si verificherà uno dei seguenti errori: MISSING_CAMPAIGN_FILTER e MISSING_AD_GROUP_FILTER.

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

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

Non puoi selezionare segments.date, altrimenti si verificherà un errore UNSUPPORTED_DATE_SEGMENTATION.

Questa query ti consente di visualizzare il rendimento del prodotto corrente per un determinato giorno o un altro valore di data compatibile. Può essere utilizzata per creare un riepilogo per ogni prodotto restituito aggregato in 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 = '2024-01-01'

Rendimento dei prodotti con i dati del carrello

Gli inserzionisti del settore retail possono accedere a metriche pertinenti sulle vendite e sui 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 i dati del carrello nelle campagne Shopping e sono compatibili con i seguenti report.

• ad_group
• ad_group_ad
• campaign
• cart_data_sales_view
• customer (aggregato per tutte le campagne)
• product_group_view
• shopping_performance_view

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

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 potrebbero 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 le metriche dei dati del carrello possono essere utilizzate 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 delle campagne con i 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