Rapporti

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

Le campagne che supportano i prodotti hanno i seguenti report dedicati:

Visualizzazione del rendimento di Shopping

La Visualizzazione del rendimento di Shopping fornisce statistiche sui report storici aggregati per i prodotti in base ad attributi come 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 dal momento in cui è stata registrata la metrica.

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

La visualizzazione Gruppo di prodotti fornisce statistiche aggregate dei report per i gruppi di schede Shopping (chiamati gruppi di prodotti nell'interfaccia utente). Consulta la guida ai report Performance Max per esempi di visualizzazione del gruppo di prodotti del gruppo di asset.

Ecco un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni per gruppi di schede Shopping per campagna con impressioni negli ultimi 30 giorni (ordinate in ordine decrescente per tutte le conversioni, poi per conversioni, poi per clic e poi per 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 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 un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni negli ultimi 30 giorni (ordinate in ordine decrescente per tutte le conversioni, poi per conversioni, poi per clic e poi per 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 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 hanno maggiori probabilità di contenere meno prodotti e di richiedere l'accesso a meno dati.
  • Più campi e metriche sono presenti nella clausola SELECT, più lento sarà il tempo di risposta. Ti consigliamo di selezionare solo i campi e le metriche necessari nella query.
  • Tieni presente che i prodotti con uno o più problemi restituiranno più dati. Puoi filtrare in base a shopping_product.status in WHERE per capire quali prodotti potrebbero restituire problemi che hanno causato lo stato pertinente.

Casi d'uso del report sui prodotti Shopping

Il report Prodotto Shopping offre accesso flessibile alle informazioni sui prodotti per le campagne che utilizzano i feed dei prodotti. Può fornire informazioni sullo stato dei prodotti degli account Google Merchant Center, ma anche 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" dell'interfaccia utente di Google Ads.

Il campo "problemi" per il prodotto Shopping è simile a quello fornito da productstatuses nell'API Content for Shopping, con l'aggiunta di problemi specifici per 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 del prodotto (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 dell'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 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 dei prodotti (a livello di campagna)

Se specifichi il report con una risorsa della campagna all'interno 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 lo causano. 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 entrambe una risorsa gruppo di annunci e una risorsa campagna e la includi nella 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 al 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 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>"

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 (indipendentemente dal fatto che siano diverse da zero) per il periodo di tempo specificato.

Non puoi selezionare segments.date, altrimenti verrà visualizzato un errore UNSUPPORTED_DATE_SEGMENTATION.

Questa query ti consente di visualizzare il rendimento del prodotto corrente per un determinato giorno o per un altro valore di data compatibile. Questo valore può essere utilizzato 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 dati del carrello

Gli inserzionisti nel settore della vendita al dettaglio 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 dati del carrello nelle campagne Shopping e sono compatibili con i seguenti report.

Le seguenti metriche relative ai dati del carrello possono essere utilizzate nei report, ad esempio shopping_performance_view, per le campagne Shopping.

L'esempio seguente mostra come le metriche relative ai 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 dati del carrello

Le metriche relative ai dati del carrello possono essere utilizzate a livello di campagna e 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