Segnalazione

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

Le campagne che supportano i prodotti dispongono dei seguenti report dedicati:

• Visualizzazione rendimento Shopping
• Visualizzazione gruppo di prodotti
• Visualizzazione gruppo di prodotti - Gruppo di asset
• Prodotto Shopping

Nota: sia "Visualizzazione del rendimento di Shopping" che "Prodotto Shopping" sono in grado di restituire metriche a livello di prodotto. "Visualizzazione rendimento Shopping" fornirà lo stato "storico" di un prodotto che ha pubblicato annunci, mentre "Prodotto Shopping" indica lo stato attuale di un prodotto indipendentemente dal fatto che abbia pubblicato o meno annunci. È consigliabile 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.

Visualizzazione rendimento Shopping

La visualizzazione del rendimento degli acquisti fornisce statistiche aggregate sui report storici per i prodotti in base ad attributi quali product_item_id.

La Visualizzazione 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.

Ecco un esempio di query che recupera impressioni, clic, costo, conversioni e tutte le conversioni per i prodotti per product_item_id con clic negli ultimi 30 giorni (ordinata in ordine decrescente per tutte le conversioni, poi per le conversioni, poi per i clic e per il costo e infine per le 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

Visualizzazione gruppo prodotti

La vista gruppo di prodotti fornisce statistiche di report aggregate per gruppi di schede Shopping (indicati come gruppi di prodotti nell'interfaccia utente). Consulta la guida ai report Performance Max per consultare alcuni esempi di vista gruppo di prodotti Gruppo di asset.

Ecco un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni per i gruppi di schede Shopping in base alla campagna con le impressioni negli ultimi 30 giorni (ordinata in ordine decrescente per tutte le conversioni, poi per le conversioni, poi per i clic e infine per le 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 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.

Ecco un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni degli ultimi 30 giorni (ordinata in ordine decrescente in base a tutte le conversioni, poi alle conversioni, ai clic e alle impressioni) per tutti i prodotti Shopping da 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 suggerimenti possono aiutarti a migliorare le prestazioni delle tue query GAQL:

• Le query a livello di campagna e gruppo di annunci saranno in genere più rapide rispetto a quelle a livello di account, in quanto è probabile che contengano meno prodotti e richiedono accesso a meno dati.
• Maggiore è il numero di campi e metriche nella clausola SELECT, più lento sarà il tempo di risposta. Ti consigliamo di selezionare solo i campi e le metriche richiesti nella query.
• Tieni presente che i prodotti con uno o più problemi restituiranno più dati. Puoi filtrare per shopping_product.status in WHERE per capire quali prodotti potrebbero restituire problemi che hanno causato lo stato pertinente.

Casi d'uso dei report sui prodotti Shopping

Il report Prodotto Shopping consente di accedere in modo flessibile alle informazioni sul prodotto per le campagne che utilizzano i feed dei prodotti. Può fornire informazioni approfondite sullo stato dei prodotti dagli account Google Merchant Center, ma anche informazioni specifiche sugli annunci, come metriche di rendimento e problemi che impediscono ai prodotti di pubblicare annunci.

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

Il campo "Problemi" per i prodotti Shopping è simile a quello fornito dagli stato del prodotto nell'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 innanzitutto il campo shopping_product.issues.documentation della risposta, che include un articolo del Centro assistenza come aiuto.

Stati dei prodotti (a livello di account)

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

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

• Shopping
• Performance Max

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

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 del prodotto (a livello di campagna)

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

È supportata 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. Consente di controllare lo stato di ciascun prodotto, inclusi i problemi che lo causano. 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 sia una risorsa gruppo di annunci sia una risorsa campagna e come parte della clausola WHERE, verranno restituiti tutti i prodotti inclusi nella campagna selezionata. Le metriche, lo stato e i problemi del prodotto indicano se il prodotto è incluso o escluso dal gruppo di annunci selezionato.

Questa query ti consente di visualizzare lo stato del prodotto rispetto a tale gruppo di annunci. Consente di verificare che i filtri dei gruppi di prodotti (a livello di gruppo di annunci) siano stati applicati correttamente e di controllare lo stato di ciascun 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 che il gruppo di annunci devono essere specificati nella clausola WHERE. Se una o l'altra opzione non è presente, si verificherà uno dei seguenti errori: MISSING_CAMPAIGN_FILTER e MISSING_AD_GROUP_FILTER.

Metriche del prodotto, filtrate per data (a livello di account)

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

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

Questa query consente di visualizzare le prestazioni del prodotto corrente per un determinato giorno o un altro valore di data compatibile. Puoi utilizzare questa funzionalità per creare un riepilogo per ciascun 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 del prodotto con dati del carrello

Gli inserzionisti 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
• customer (aggregata per tutte le campagne)
• product_group_view
• shopping_performance_view

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

Nota: le metriche dei dati del carrello non sono disponibili finché non vengono registrate le conversioni per i prodotti associati. L'esecuzione delle query su shopping_performance_view potrebbe richiedere più tempo 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