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
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
inWHERE
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>"
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
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