E-commerce in GA4: configurare gli eventi e leggere i report

Laptop con la scritta online shopping sullo schermo, carrello in miniatura e pacchi di cartone sulla scrivania

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 anche transaction_id, tax, shipping e coupon;
  • parametri a livello di articolo, contenuti nell’array items: un elenco di prodotti, ciascuno con il proprio item_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

Mano che tiene una carta di credito davanti a un laptop aperto su un negozio online di abbigliamento
Foto di Mikhail Nilov su Pexels

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

Codice JavaScript colorato su uno schermo con chiamate di funzione e listener di eventi
Foto di Rashed Paykary su Pexels

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:

  1. 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.
  2. Il nome dell’evento deve corrispondere esattamente a quello consigliato: purchase, non Purchase né acquisto. Un nome diverso crea un evento personalizzato che i report di e-commerce ignorano.
  3. 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

Titolare di un negozio online alla scrivania con laptop, scarpe e scatole pronte per la spedizione
Foto di Kampus Production su Pexels

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:

  1. nel vostro contenitore, aprite Tag e create un nuovo tag di tipo Google Analytics: evento GA4;
  2. come nome dell’evento usate la variabile integrata {{Event}}, che riprende il nome inviato nel push (purchase, add_to_cart e così via);
  3. in Altre impostazioni > E-commerce selezionate Invia dati e-commerce e scegliete come origine dati il Data Layer;
  4. associate un attivatore di tipo Evento personalizzato che scatti sugli eventi e-commerce;
  5. 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

Monitor in un ufficio poco illuminato con grafici e indicatori di dati in tempo reale
Foto di Ron Lach su Pexels

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

Mano sul touchpad di un laptop che mostra grafici a barre e a linee di un report di vendita
Foto di Kaboompics su Pexels

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

Uomo in camicia e cravatta con le mani nei capelli, frustrato davanti al laptop
Foto di Nicola Barts su Pexels

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_id e item_name presenti e coerenti in tutti gli eventi.
  • currency sempre presente quando c’è un value.
  • transaction_id unico, dinamico, mai vuoto, nel purchase e nel refund.
  • 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.

Condividi :

CRO

Trasforma il traffico in conversioni, migliora l'esperienza utente e ottimizza le performance del tuo sito.
Ultimi Articoli

Data Tracking

Guide su Google Tag Manager, GA4 e server-side tracking per monitorare le performance digitali.

Funnel

Progetta funnel di vendita efficaci, analizza il percorso degli utenti e individua le opportunità di conversione.

MarTech

Scopri software, piattaforme e soluzioni per integrare dati, automazioni e strumenti di marketing digitale.