Reporting

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

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

di Gemini Advanced.

Visualizzazione rendimento Shopping

La Visualizzazione rendimento degli acquisti fornisce statistiche aggregate sui report storici relativi ai prodotti in base ad attributi come product_item_id

La Visualizzazione rendimento di Shopping acquisisce lo stato del prodotto nel momento in cui sono state registrate metriche pertinenti. Sono inclusi segmenti come product_title, che potrebbe essere cambiato 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 in base a tutte le conversioni, poi alle conversioni e infine clic, quindi 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

Visualizzazione gruppo prodotti

La vista gruppo di prodotti fornisce dati aggregati generare report di statistiche per la scheda Shopping gruppi (indicati come prodotti gruppi nella UI). Consulta la guida ai report Performance Max per Visualizzazione gruppo di prodotti - Gruppo di asset esempi.

Ecco un esempio di query che recupera impressioni, clic, conversioni e tutte le conversioni per i gruppi di schede Shopping per campagna con impressioni nel ultimi 30 giorni (ordinata in ordine decrescente in base a tutte le conversioni, poi alle conversioni i clic e 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: e statistiche dei report per i prodotti presenti in Account Google Merchant Center collegati all'account Google Ads. Questo report può essere utilizzato per esaminare le statistiche relative a un cliente, una campagna a livello di gruppo di annunci.

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

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

Consulta la Guida ai report per ulteriori dettagli sui query.

Considerazioni sulle prestazioni

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

  • Le query a livello di campagna e gruppo di annunci di solito sono più veloci di quelle a livello di account, in quanto è probabile che contengano meno prodotti richiedono l'accesso a una quantità inferiore di dati.
  • Più campi e metriche sono nella clausola SELECT, più lenta sarà la risposta. nel tempo. 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 filtra per shopping_product.status in WHERE per capire quale è probabile che i prodotti restituiscano problemi che hanno causato lo stato pertinente.

Casi d'uso dei report sui prodotti Shopping

Il report Prodotto Shopping offre soluzioni flessibili accesso alle informazioni sui prodotti per le campagne che utilizzano i feed dei prodotti. Può offre approfondimenti sullo stato dei prodotti di Google Merchant Center account, ma anche informazioni specifiche sugli annunci come le metriche sul rendimento e problemi che impediscono ai prodotti di pubblicare annunci.

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

I "problemi" campo per Prodotto Shopping è simile a quello fornito da statodelprodotto nell'API Content for Shopping, con l'aggiunta di problemi specifici in Google Ads. Per verificare se il problema deve essere risolto in Google Merchant Center o Google Ads, verifica innanzitutto il campo shopping_product.issues.documentation della la risposta, che include un articolo del Centro assistenza.

Stati dei prodotti (a livello di account)

Se viene specificato il report senza filtri per la campagna o il gruppo di annunci, verrà restituito tutti i prodotti a livello di account.

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

  • Shopping
  • Performance Max

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

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)

Specificare il report con una risorsa campagna come parte della clausola WHERE restituirà tutti i prodotti inclusi nella campagna selezionata.

È supportata dai seguenti tipi di campagna che possono utilizzare 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 permette di controllare lo stato di ogni prodotto, inclusi i problemi che sono causando lo stato. Ad esempio, una campagna in pausa influirà sul prodotto stato:

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)

Specificare il report sia su una risorsa di gruppo di annunci sia su una campagna e, come parte della clausola WHERE restituirà tutti i prodotti inclusi 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 tale gruppo di annunci. Consente di verificare che i filtri dei gruppi di prodotti (a livello di gruppo di annunci) siano applicata correttamente e per 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 del prodotto, filtrate per data (a livello di account)

Se il report viene specificato con una data o un intervallo di date nella clausola WHERE, verrà restituito le 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, altrimenti verrà visualizzato un Errore UNSUPPORTED_DATE_SEGMENTATION.

Questa query consente di visualizzare il rendimento del prodotto corrente per un determinato giorno o un altro valore di data compatibile. Può essere usato per creare un riepilogo 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 del settore della vendita al dettaglio possono accedere a metriche pertinenti sulle vendite e sui profitti, Entrate, Profitto lordo, Margine di profitto lordo e Unità vendute. Queste metriche sono disponibili per tutti gli inserzionisti che implementano Conversioni con dati del carrello nelle campagne Shopping e sono compatibili con i seguenti report.

Le seguenti metriche dei dati del carrello possono essere utilizzate nei report, ad esempio shopping_performance_view, per Campagne Shopping.

L'esempio seguente mostra come utilizzare le metriche dei dati del carrello per analizzare il rendimento a livello di prodotto per le campagne Shopping nel 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