Avete installato Google Analytics 4 sul vostro negozio online, vedete arrivare sessioni e pagine viste, ma il report delle vendite è vuoto o mostra cifre che non tornano con il gestionale? È uno dei problemi più frequenti che incontriamo: l’ecommerce GA4 non si attiva da solo con il tag di base. Gli eventi di acquisto, carrello e checkout vanno inviati in modo esplicito, con una struttura precisa, altrimenti i report di monetizzazione restano muti.
In questa guida vediamo come configurare l’ecommerce in GA4 dall’inizio alla fine: quali eventi ecommerce GA4 servono e quando attivarli, come scrivere il push nel Data Layer, come impostare il tag in Google Tag Manager, come validare i dati e come leggere i report di monetizzazione. Non ripetiamo le basi sugli eventi generici, che trovate nella guida a eventi e conversioni in GA4: qui ci concentriamo solo su ciò che riguarda prodotti, carrelli e ordini. L’articolo fa parte della categoria Web Analytics.
Come funziona l’e-commerce in GA4: eventi, parametri e array items
In GA4 tutto è un evento, e l’e-commerce non fa eccezione. Google definisce una serie di eventi consigliati dedicati al commercio elettronico, con nomi e parametri prestabiliti. La documentazione ufficiale è chiara su un punto che molti sottovalutano: gli eventi di e-commerce non vengono raccolti automaticamente. Quando però li inviate con i nomi e i parametri corretti, Analytics li interpreta e popola da solo dimensioni, metriche e report dedicati.
Ogni evento e-commerce è composto da due livelli di informazioni:
- parametri a livello di evento, che descrivono l’azione nel suo complesso:
currency(la valuta),value(il valore economico), e per gli acquisti anchetransaction_id,tax,shippingecoupon; - parametri a livello di articolo, contenuti nell’array
items: un elenco di prodotti, ciascuno con il proprioitem_id,item_name,price,quantity, brand, variante e fino a cinque livelli di categoria (item_category…item_category5).
Per ogni articolo dell’array è obbligatorio almeno uno tra item_id e item_name, ma Google raccomanda di inviarli entrambi. Se non specificate la quantità, GA4 la considera pari a 1. L’array può contenere fino a 200 elementi, un limite che nella pratica riguarda solo carrelli molto grandi o elenchi di prodotti lunghissimi.
Pensate all’array items come allo scontrino del supermercato: l’evento dice “è avvenuto un acquisto da 72 euro”, le righe dello scontrino dicono quali prodotti, in che quantità e a che prezzo. Senza le righe, GA4 sa che avete venduto qualcosa ma non sa cosa, e i report sui prodotti restano vuoti.
C’è poi un dettaglio che fa perdere ore di debug: se a un evento e-commerce mancano parametri obbligatori, Analytics lo tratta come un evento personalizzato e non lo mostra nei report di e-commerce. L’evento compare nella lista eventi, ma non alimenta le metriche di vendita. Per questo la regola d’oro, ripetuta anche da Google, è valorizzare ogni parametro per cui avete un dato, anche quando è facoltativo.
Gli eventi ecommerce GA4 da configurare, fase per fase

Il modo più semplice per capire quali eventi servono è seguire il percorso di un cliente, dalla pagina di categoria alla conferma d’ordine. Ogni passaggio corrisponde a un evento consigliato.
| Fase del percorso | Evento GA4 | Quando inviarlo |
|---|---|---|
| Elenco prodotti | view_item_list |
Quando l’utente vede una categoria, i risultati di ricerca o un blocco di prodotti correlati |
| Clic su un prodotto | select_item |
Quando l’utente seleziona un articolo da un elenco |
| Scheda prodotto | view_item |
Al caricamento della pagina di dettaglio del prodotto |
| Carrello | add_to_cart, remove_from_cart, view_cart |
Quando si aggiunge o rimuove un articolo e quando si apre il carrello |
| Inizio checkout | begin_checkout |
Al clic su “Procedi all’acquisto” o all’apertura del checkout |
| Spedizione | add_shipping_info |
Quando l’utente conferma indirizzo e metodo di spedizione |
| Pagamento | add_payment_info |
Quando l’utente inserisce o sceglie il metodo di pagamento |
| Ordine completato | purchase |
Sulla pagina di conferma, una sola volta per ordine |
| Reso | refund |
Quando un ordine viene rimborsato, in tutto o in parte |
A questi si aggiungono gli eventi delle promozioni interne, view_promotion e select_promotion, utili se usate banner in home page o nelle categorie, e add_to_wishlist per la lista dei desideri.
Da dove partire se avete poco tempo
Non serve implementare tutto in un giorno. Se dovete scegliere, partite dall’evento purchase GA4: è quello che alimenta entrate e transazioni, e senza di lui nessun altro dato ha senso. Subito dopo aggiungete view_item, add_to_cart e begin_checkout, che vi danno l’ossatura del funnel. Infine completate con add_shipping_info e add_payment_info, indispensabili per il report sul percorso di pagamento, e con gli eventi di elenco e promozione.
Le piattaforme che fanno parte del lavoro
Alcune piattaforme inviano già una parte degli eventi. Secondo la guida di Analytics, se avete collegato Google Analytics a un negozio Shopify vengono raccolti automaticamente eventi come add_to_cart, begin_checkout e purchase; gli altri eventi consigliati vanno configurati a parte. Per WooCommerce, PrestaShop e Magento esistono plugin e moduli dedicati, ma il consiglio è lo stesso: verificate sempre quali eventi inviano davvero e con quali parametri, prima di fidarvi dei report.
Il dataLayer: come strutturare il push e-commerce

Se usate Google Tag Manager, il ponte tra il vostro negozio e GA4 è il dataLayer: un array JavaScript in cui il sito “deposita” le informazioni sull’evento appena avvenuto, che Tag Manager legge e inoltra ad Analytics. Il compito di scrivere questi push spetta di solito allo sviluppatore o al plugin della piattaforma; il vostro compito è definire con precisione cosa deve contenere.
Ecco la struttura di un push per l’evento purchase, sul modello di quello pubblicato nella documentazione per sviluppatori di Google:
dataLayer.push({ ecommerce: null }); // svuota l'oggetto ecommerce precedente
dataLayer.push({
event: "purchase",
ecommerce: {
transaction_id: "T_12345",
value: 72.05,
tax: 3.60,
shipping: 5.99,
currency: "EUR",
coupon: "SALDI_INVERNO",
items: [
{
item_id: "SKU_12345",
item_name: "Maglietta in cotone",
item_brand: "Marchio",
item_category: "Abbigliamento",
item_variant: "verde",
price: 10.01,
quantity: 3
}
]
}
});
Tre dettagli meritano attenzione:
- Lo svuotamento dell’oggetto
ecommerce. La prima riga,dataLayer.push({ ecommerce: null }), cancella i dati dell’evento precedente. Senza questa riga, su pagine in cui avvengono più eventi (per esempio un elenco prodotti e poi un’aggiunta al carrello) i parametri di un evento possono “sporcare” quelli del successivo. Google la inserisce in tutti i suoi esempi. - Il nome dell’evento deve corrispondere esattamente a quello consigliato:
purchase, nonPurchasenéacquisto. Un nome diverso crea un evento personalizzato che i report di e-commerce ignorano. - I valori numerici vanno passati come numeri con il punto decimale (
72.05), non come stringhe formattate all’italiana con la virgola o con il simbolo dell’euro.
Lo stesso schema vale per tutti gli altri eventi: cambia il valore di event e cambiano i parametri a livello di evento (per esempio item_list_name per view_item_list, shipping_tier per add_shipping_info, payment_type per add_payment_info), mentre l’array items mantiene sempre la stessa struttura. Mantenere coerenti item_id e item_name tra un evento e l’altro è fondamentale: se la scheda prodotto invia lo SKU e il carrello invia l’ID interno del database, GA4 vedrà due prodotti diversi.
Se il vostro sito non può scrivere nel dataLayer, Google documenta un’alternativa: una variabile JavaScript personalizzata di Tag Manager che restituisce un oggetto con la stessa sintassi. È una soluzione di ripiego, più fragile, perché legge i dati dalla pagina e si rompe facilmente quando cambia il template.
Configurare gli eventi e-commerce con Google Tag Manager

Una volta che il dataLayer è pronto, la configurazione in Tag Manager è sorprendentemente rapida. Se non avete mai usato lo strumento, partite dalla nostra guida a Google Tag Manager e tornate qui. Google descrive il metodo più veloce in pochi passaggi:
- nel vostro contenitore, aprite Tag e create un nuovo tag di tipo Google Analytics: evento GA4;
- come nome dell’evento usate la variabile integrata
{{Event}}, che riprende il nome inviato nel push (purchase,add_to_carte così via); - in Altre impostazioni > E-commerce selezionate Invia dati e-commerce e scegliete come origine dati il Data Layer;
- associate un attivatore di tipo Evento personalizzato che scatti sugli eventi e-commerce;
- salvate, testate in Anteprima e pubblicate.
Con l’opzione “Invia dati e-commerce” il tag legge da solo l’oggetto ecommerce del dataLayer, items compresi, senza dover creare una variabile per ogni parametro. In alternativa potete creare variabili del livello dati come ecommerce.items, ecommerce.value, ecommerce.currency e ecommerce.transaction_id e mapparle una per una come parametri dell’evento: è più laborioso, ma utile se dovete trasformare qualche valore prima dell’invio.
Un tag unico o un tag per evento?
Con il metodo {{Event}} basta un solo tag per tutti gli eventi e-commerce. L’attivatore può essere un evento personalizzato con l’opzione “Usa corrispondenza con espressioni regolari” e un elenco come view_item_list|select_item|view_item|add_to_cart|remove_from_cart|view_cart|begin_checkout|add_shipping_info|add_payment_info|purchase|refund. È una soluzione ordinata e facile da mantenere. Se però volete regole diverse per alcuni eventi, per esempio inviare purchase anche a un endpoint GTM server-side, conviene separare almeno il tag di acquisto.
Consenso e qualità dei dati
Ricordate che i tag e-commerce rispettano le stesse regole di consenso del resto della misurazione. Se avete configurato il Consent Mode v2, una parte degli acquisti degli utenti che rifiutano i cookie non arriverà in GA4 come evento completo. È normale che le transazioni in Analytics siano meno di quelle del gestionale: l’obiettivo è che lo scarto sia stabile e spiegabile, non che sia zero.
Validare i dati: Anteprima di GTM, DebugView e Tempo reale

Un’implementazione e-commerce non è finita finché non l’avete verificata evento per evento. Lavoriamo sempre su tre livelli.
1. L’Anteprima di Tag Manager
Avviate la modalità Anteprima del contenitore e percorrete il sito come un cliente: categoria, prodotto, carrello, checkout, ordine di prova. Per ogni evento controllate nella scheda Livello dati che il push contenga tutti i parametri attesi e nella scheda Tag che il tag GA4 sia stato attivato. Se il push c’è ma il tag non parte, il problema è l’attivatore; se il tag parte ma mancano i dati, il problema è nel dataLayer.
2. DebugView in GA4
Il report DebugView, che si trova nella sezione Amministrazione di GA4, mostra in tempo reale gli eventi dei dispositivi in modalità debug. Quando usate l’Anteprima di Tag Manager la modalità debug si attiva automaticamente; con gtag.js potete abilitarla aggiungendo il parametro debug_mode: true alla configurazione. Cliccando su un evento vedete parametri, proprietà utente e articoli associati: è il punto giusto per verificare che transaction_id, value e currency siano valorizzati e che l’array items contenga i prodotti giusti.
3. Tempo reale e report standard
Il report In tempo reale conferma che GA4 ha ricevuto gli eventi negli ultimi 30 minuti. I report standard, invece, possono impiegare fino a 24 ore per mostrare i nuovi dati: non allarmatevi se subito dopo il test il report Acquisti e-commerce è ancora vuoto.
Una buona abitudine è preparare un piccolo foglio di collaudo con una riga per evento e tre colonne: “push presente”, “tag attivato”, “parametri corretti in DebugView”. Il giorno dopo il primo ordine reale, confrontate il numero di transazioni e il fatturato di GA4 con quelli del gestionale per la stessa giornata.
Leggere i report di monetizzazione in GA4

Quando i dati arrivano correttamente, la sezione Report > Monetizzazione si popola. Se non trovate uno dei report descritti qui sotto, può essere stato rimosso dalla navigazione: chi ha il ruolo di editor o amministratore può aggiungerlo di nuovo dalla Libreria. Vediamo i tre report più utili per un e-commerce.
Acquisti e-commerce
È il report dedicato ai prodotti. Le dimensioni sono quelle degli articoli (nome, ID, brand, categoria da 1 a 5), le metriche raccontano la vita di ogni prodotto: articoli visualizzati (da view_item), articoli aggiunti al carrello (da add_to_cart), articoli acquistati e entrate a livello di articolo (da purchase). Queste ultime sono calcolate come prezzo per quantità e escludono tasse e spedizione, per questo non coincidono con le entrate totali.
L’uso più pratico è incrociare visualizzazioni e acquisti: un prodotto molto visto ma poco aggiunto al carrello ha un problema di scheda prodotto (prezzo, foto, descrizione); uno molto aggiunto ma poco acquistato potrebbe avere costi di spedizione o disponibilità che emergono solo al checkout.
Percorso di acquisto
Il report Percorso di acquisto mostra quanti utenti passano da una fase all’altra: avvio della sessione, visualizzazione del prodotto, aggiunta al carrello, inizio del pagamento e acquisto. Per ogni passaggio vedete il tasso di abbandono e potete suddividere i dati per dispositivo, Paese o altre dimensioni. Se il passaggio dal carrello al checkout crolla solo da mobile, avete già trovato dove lavorare.
Percorso di pagamento
Il report Percorso di pagamento fa lo stesso lavoro, ma solo all’interno del checkout: inizio del pagamento, aggiunta delle informazioni di spedizione, aggiunta del metodo di pagamento, acquisto. Funziona solo se inviate begin_checkout, add_shipping_info, add_payment_info e purchase: se manca anche un solo evento, il funnel mostrerà un abbandono falso proprio in quel punto.
Questi report rispondono alla domanda “dove perdo clienti?”. Per trasformare i numeri in obiettivi, abbinateli ai KPI e-commerce che contano davvero, come valore medio dell’ordine e tasso di abbandono del carrello, e al calcolo del tasso di conversione. Se dovete condividere i risultati con il cliente o con la direzione, potete portare le stesse metriche in una dashboard su Looker Studio. Il purchase, infine, può essere contrassegnato come Key Event per usarlo nell’attribuzione e nelle campagne.
Errori comuni nell’ecommerce GA4 e checklist finale

Dopo decine di verifiche su negozi online, gli errori che troviamo sono quasi sempre gli stessi. La buona notizia è che si correggono tutti con poche righe di codice.
Acquisti duplicati
Il classico: l’utente ricarica la pagina di conferma, o ci torna dall’email, e l’evento purchase parte una seconda volta. GA4 deduplica gli acquisti con lo stesso transaction_id, ma solo se l’ID c’è ed è davvero unico per ogni ordine. Per maggiore sicurezza, fate in modo che il push venga generato una sola volta lato server, ad esempio con un flag sull’ordine che indica se l’evento è già stato inviato.
transaction_id sbagliato o vuoto
Google avverte esplicitamente di non inviare una stringa vuota come ID transazione: tutti gli acquisti con transaction_id vuoto vengono deduplicati tra loro, e il risultato è un crollo delle transazioni registrate. Lo stesso accade se il codice invia un valore fisso, per esempio il testo di un segnaposto mai sostituito. Usate il numero d’ordine reale e non inserite nell’ID dati che possano identificare il cliente, come email o nome.
Valuta mancante o errata
Quando inviate un value dovete inviare anche currency a livello di evento, nel formato ISO a tre lettere (EUR). È la valuta usata per i report standard dell’interfaccia: senza, le metriche di entrate non vengono calcolate correttamente. Attenzione anche ai negozi multivaluta: la valuta deve essere quella effettiva dell’ordine, non quella predefinita del sito.
Valori incoerenti
Nell’esempio di Google il value del purchase corrisponde alla somma di prezzo per quantità degli articoli, mentre tasse e spedizione viaggiano nei parametri tax e shipping. Decidete una regola (valore con o senza IVA, con o senza spedizione), documentatela e applicatela allo stesso modo su tutti gli eventi, altrimenti il confronto con il gestionale diventerà impossibile.
Rimborsi dimenticati
Se non inviate l’evento refund, le entrate di GA4 restano gonfiate dai resi. Il rimborso va inviato con lo stesso transaction_id dell’ordine originale; per i rimborsi parziali indicate gli articoli resi con item_id e quantity, che Google consiglia di includere comunque per avere le metriche di rimborso a livello di articolo. Poiché il reso avviene spesso giorni dopo e senza che il cliente torni sul sito, la strada più pratica è inviarlo dal backend con il Measurement Protocol o tramite un’integrazione server-side.
La checklist da tenere a portata di mano
- Nomi degli eventi identici a quelli consigliati da Google, in minuscolo.
dataLayer.push({ ecommerce: null })prima di ogni push e-commerce.item_ideitem_namepresenti e coerenti in tutti gli eventi.currencysempre presente quando c’è unvalue.transaction_idunico, dinamico, mai vuoto, nelpurchasee nelrefund.- Eventi di checkout completi per non falsare il Percorso di pagamento.
- Collaudo in Anteprima e DebugView, poi confronto con il gestionale dopo 24-48 ore.
Configurare l’ecommerce in GA4 richiede qualche ora di lavoro tra marketing e sviluppo, ma ripaga subito: per la prima volta potete vedere quali prodotti attirano, dove il funnel perde clienti e quanto vale davvero ogni canale. Trovate gli altri approfondimenti sullo strumento nell’archivio del tag Google Analytics 4 e le guide dedicate ai negozi online sotto il tag E-commerce, insieme ai contenuti sulla monetizzazione.



