Rapporti

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

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

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

Nota: sia "Visualizzazione del rendimento di Shopping" sia "Prodotto Shopping" sono in grado di restituire metriche a livello di prodotto. La "Visualizzazione del rendimento di Shopping" fornisce 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 principalmente "Prodotto Shopping" per valutare lo "stato" di un prodotto e qualsiasi problema che ne impedisca l'utilizzo da parte di una campagna.

Visualizzazione del rendimento di Shopping

La visualizzazione del rendimento di Shopping 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 potrebbe essere cambiato da quando è stata registrata la metrica.

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, poi per clic, poi per costo e infine 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 per i gruppi di schede Shopping (denominati gruppi di prodotti nell'interfaccia utente). Consulta la guida ai report Performance Max per esempi di visualizzazione dei gruppi di prodotti dei gruppi di asset.

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 e infine 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 reporting 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 (ordinate 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 sul 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 tue query GAQL:

• Le query a livello di campagna e gruppo di annunci in genere sono più rapide di quelle a livello di account, in quanto è probabile che contengano meno prodotti e richiedano l'accesso a meno dati.
• Più campi e metriche ci sono nella clausola SELECT, più lento sarà il tempo di risposta. Ti consigliamo di selezionare solo i campi e le metriche che ti servono 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 del report sui prodotti 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 del rendimento e problemi che impediscono la pubblicazione degli annunci dei prodotti.

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

Il campo "Problemi" per il prodotto Shopping è simile a quello fornito da productstatuses in Content API 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.

Stati del prodotto (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 determinato 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 della 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 e 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: sia la campagna che il gruppo di annunci devono essere specificati nella clausola WHERE. Se uno dei due non è presente, si verificherà uno dei seguenti errori: MISSING_CAMPAIGN_FILTER e MISSING_AD_GROUP_FILTER.

Metriche del prodotto, filtrate per data (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 sono (indipendentemente dal fatto che le metriche siano diverse da zero) per il 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. Questi dati possono essere utilizzati 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 su vendite e profitti, ad esempio 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 (aggregato per tutte le campagne)
• product_group_view
• shopping_performance_view

Le seguenti metriche sui dati del carrello possono essere utilizzate nei report, ad esempio in 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 rispetto a shopping_performance_view potrebbero richiedere più tempo per l'esecuzione per gli account con un numero elevato di prodotti, anche con i filtri applicati.

Il seguente esempio 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 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 costi.

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