Google Analytics 4 per PrestaShop: guida completa alla configurazione

Universal Analytics ha smesso di elaborare dati a luglio 2023 (GA4 è l'unica versione); Consent Mode v2 è richiesto per le funzionalità Google Ads nel SEE da marzo 2024. Il codice qui sotto è pensato per PrestaShop 1.7, 8 e 9.

Ecco l'errore in cui inciampa la maggior parte dei commercianti PrestaShop: installare un modulo Google Analytics 4 non equivale ad avere GA4 configurato correttamente. Inserisci un Measurement ID, vedi gli "utenti" aumentare nel report Realtime e sembra tutto pronto. Poi, sei settimane dopo, apri Monetization → Ecommerce purchases per capire quali prodotti vendono davvero, e il report è vuoto, o peggio, mostra metà del fatturato perché l'evento purchase si attiva solo a volte. Installare un contatore di visualizzazioni pagina è banale. Avere una proprietà GA4 che registra ogni visualizzazione prodotto, ogni aggiunta al carrello, ogni passaggio abbandonato della procedura di acquisto e ogni ordine completato con il totale transazione corretto. Quello richiede una configurazione intenzionale, ed è esattamente ciò di cui parla questa guida.

Questa è la procedura completa e specifica per PrestaShop: creare la proprietà, scegliere un metodo di installazione adatto al tuo negozio, collegare gli eventi e-commerce, gestire correttamente il consenso per l'UE e, la parte che tutti saltano, verificare che i dati arrivati in GA4 siano davvero corretti. Una volta che l'impianto è in ordine e affidabile, la domanda diventa quali numeri usare per decidere; è una disciplina a parte, che trattiamo in le metriche che contano davvero. Questo articolo ti dà prima di tutto una configurazione che valga la pena leggere.

Prima di iniziare: una proprietà, lo stream di dati giusto

GA4 è l'unica versione da quando Universal Analytics ha smesso di elaborare dati a luglio 2023, quindi se stai migrando da una configurazione UA, nulla della vecchia configurazione si trasferisce automaticamente, GA4 usa un modello di misurazione diverso (eventi, non sessioni) e va costruito da zero. Crea prima la proprietà, poi installa il tracciamento su PrestaShop. Fare il contrario è il modo in cui molti negozi finiscono con due proprietà configurate a metà e il tracciamento diviso tra loro.

Crea la proprietà GA4

• In Google Analytics, vai su Admin → Create → Property (l'icona a forma di ingranaggio, in basso a sinistra).
• Inserisci il nome del tuo negozio, poi imposta fuso orario e valuta dei report in modo che corrispondano al tuo negozio PrestaShop. È più importante di quanto sembri: la valuta della proprietà dovrebbe coincidere con quella del negozio, a meno che la tua integrazione invii la valuta corretta su ogni evento e-commerce; altrimenti i dati sul fatturato in GA4 possono essere sbagliati, e non esiste una correzione retroattiva, perché GA4 non rielabora i dati storici.
• All'interno della proprietà, crea uno stream di dati Web e inserisci l'URL completo del negozio (con o senza www, esattamente come si risolve il tuo dominio canonico).
• Copia il Measurement ID, inizia con G-. Dovrai anche configurare l'integrazione del consenso del modulo e verificarne gli eventi e-commerce.

La regola è uno stream di dati per piattaforma. Un normale negozio PrestaShop è un singolo sito web, quindi ti serve esattamente uno stream web. Resisti alla tentazione di creare un secondo stream "per i test", usa una proprietà separata, altrimenti mescolerai il traffico di staging nei report reali.

Tre modi per portare GA4 su PrestaShop

PrestaShop non include GA4 nel core, quindi devi scegliere come inserire il tag Google e come far arrivare i dati e-commerce. Le tre strade differiscono soprattutto per la profondità e-commerce disponibile subito rispetto a quanto devi costruire manualmente.

Opzione A, il modulo incluso ps_googleanalytics

PrestaShop fornisce un modulo Google Analytics ufficiale. Installalo da Modules → Module Manager (cerca "Google Analytics"), apri la configurazione e incolla il tuo Measurement ID G-. Il supporto a GA4 è arrivato in ps_googleanalytics v4 (le versioni più vecchie distribuite con PrestaShop 1.6 e le prime 1.7 parlavano solo Universal Analytics), quindi prima assicurati che il modulo sia aggiornato, usa una versione recente compatibile con GA4 e controlla la compatibilità del modulo con la tua versione di PrestaShop. Una volta aggiornato, inserisce il tag Google (gtag.js) e attiva eventi e-commerce di base tramite gli hook di PrestaShop. Dov'è il problema? La copertura e-commerce è parziale, a seconda del tema e della versione, eventi come view_item_list potrebbero non attivarsi, e gli oggetti prodotto possono arrivare senza categoria o marca. Va sinceramente bene per capire "il negozio riceve traffico e più o meno quanto fattura", ed è un punto di partenza ragionevole. Non basta se vuoi prendere decisioni su catalogo o procedura di acquisto basandoti sui dati.

Opzione B, Google Tag Manager

GTM ti offre un unico container per gestire ogni tag di marketing senza ridistribuire codice, ed è questo il suo vero vantaggio quando usi GA4 insieme a Google Ads e a un pixel Meta. Il compromesso è che GTM non fornisce nulla per l'e-commerce finché non costruisci un data layer e colleghi i trigger. Un lavoro che, su PrestaShop, significa portare dati strutturati su prodotti e ordini dentro window.dataLayer nei momenti giusti. Se vuoi seguire la strada GTM, nella guida a GTM per PrestaShop mostriamo come installare il container e configurare il tracciamento senza modifiche al codice, segui quella guida, poi punta un tag di configurazione GA4 al Measurement ID indicato qui.

Opzione C, un modulo GA4 dedicato

Un modulo progettato appositamente esiste proprio per eliminare il lavoro di assemblaggio del data layer. Il nostro modulo mprgoogleanalytics si collega direttamente agli eventi di catalogo, carrello e ordine di PrestaShop ed emette l'intero set consigliato di eventi e-commerce GA4 con parametri prodotto completi, oltre a Google Consent Mode v2 e a una vista di debug integrata. In pratica significa questo: i report Monetization qui sotto si popolano correttamente dal giorno in cui lo installi, senza scrivere a mano un solo dataLayer.push, lo configuri dal pannello di amministrazione, incolli il Measurement ID, imposti l'integrazione del consenso e il funnel e-commerce inizia semplicemente a riempirsi. Si installa in modo pulito da Module Manager e resiste agli aggiornamenti perché lavora tramite hook, non tramite modifiche al tema.

Gli eventi e-commerce che la tua configurazione deve inviare

È qui che la maggior parte delle installazioni GA4 su PrestaShop resta silenziosamente incompleta, quindi vale la pena sapere qual è l'obiettivo. I report e-commerce di GA4 si basano su un set specifico di eventi consigliati. Qualunque metodo tu abbia scelto sopra, una configurazione e-commerce solida dovrebbe inviare gli eventi consigliati pertinenti ai report che ti servono, ciascuno nel punto corretto del percorso cliente:

• view_item_list, nelle pagine categoria e nei risultati di ricerca (l'array dei prodotti mostrati).
• view_item, nella pagina prodotto.
• add_to_cart / remove_from_cart, quando cambia il carrello.
• view_cart, nella pagina carrello.
• begin_checkout, quando il cliente entra nel controller dell'ordine.
• add_shipping_info, quando viene selezionato un corriere.
• add_payment_info, quando viene scelto un metodo di pagamento.
• purchase, nella conferma d'ordine. L'evento più importante in assoluto, e quello che si rompe più spesso.

L'evento purchase deve contenere ID transazione, valore totale, imposte, costo di spedizione, valuta e un array di ogni articolo acquistato. Se uno di questi dati manca o è errato, il report sul fatturato è errato. E gli eventi sono utili solo quanto i dati prodotto al loro interno, ogni articolo dovrebbe includere item_id, item_name, price (dopo lo sconto), quantity, item_category, item_brand e item_variant (la combinazione selezionata). Una configurazione che invia solo ID e prezzi tecnicamente "funziona", ma elimina l'analisi per categoria, marca e variante che rende i report davvero utili.

L'esempio di push purchase qui sotto è incompleto: esegua l'escape di ogni stringa interpolata e aggiunga i campi categoria, marca e variante prima di utilizzarlo. I valori arrivano dall'oggetto ordine di PrestaShop, $order->reference per l'ID transazione, $order->total_paid, $order->total_paid_tax_incl/_tax_excl per le imposte, $order->total_shipping, il codice ISO della valuta dell'ordine e le righe prodotto, renderizzati nel template (esegui l'escape di ogni valore):

<!-- order-confirmation page, after the order is confirmed -->
<script>
  window.dataLayer = window.dataLayer || [];
  // Guard: fire purchase only once per order. Keyed on the order reference,
  // so reloading the confirmation page can't double-count the sale.
  var gaTxnKey = 'ga4_purchase_{$order.reference|escape:'javascript'}';
  if (!localStorage.getItem(gaTxnKey)) {ldelim}
    localStorage.setItem(gaTxnKey, '1');
    // Clear any previous ecommerce object so item data can't leak between events
    dataLayer.push({ ecommerce: null });
    dataLayer.push({
      event: 'purchase',
      ecommerce: {
        transaction_id: '{$order.reference}',          // e.g. "XKBKNABJK"
        value: {$order.total_paid|floatval},            // total incl. tax
        // No $order->total_tax property exists – derive tax from the
        // incl./excl. totals (or pass a precomputed, escaped variable).
        tax: {($order.total_paid_tax_incl - $order.total_paid_tax_excl)|floatval},
        shipping: {$order.total_shipping|floatval},
        currency: '{$currency.iso_code}',               // e.g. "EUR"
        items: [
          {foreach $products as $p}
          {ldelim}
            item_id: '{$p.reference}',
            item_name: '{$p.name|escape:'javascript'}',
            price: {$p.price_amount|floatval},
            quantity: {$p.quantity|intval}
          {rdelim}{if !$p@last},{/if}
          {/foreach}
        ]
      }
    });
  {rdelim}
</script>

In quel blocco ci sono due elementi non negoziabili: il reset dataLayer.push({ ecommerce: null }) sopra l'evento (senza, i dati articolo di un evento precedente passano a quello successivo) e una protezione che lo faccia attivare una sola volta per ordine, basata sul riferimento transazione, così un cliente che ricarica la pagina di conferma non può conteggiare due volte la vendita. Un modulo dedicato gestisce il tracciamento e-commerce tramite gli hook di PrestaShop, inclusi i dati prodotto completi e l'integrazione del consenso descritti sopra.

I due dettagli del data layer che fregano più spesso

Se stai costruendo da solo il data layer (Opzione B, o qualsiasi lavoro personalizzato), due aspetti causano la maggior parte delle configurazioni rotte che vediamo:

• Svuota l'oggetto ecommerce tra un evento e l'altro. Invia { ecommerce: null } prima di ogni nuovo evento e-commerce, altrimenti i dati prodotto dell'evento precedente passano nel successivo e gli array degli articoli diventano inutilizzabili.
• Collega l'aggiunta al carrello AJAX, non solo il caricamento pagina. La maggior parte dei temi PrestaShop aggiunge al carrello via AJAX senza ricaricare la pagina. Se il tracciamento ascolta solo il caricamento pagina, add_to_cart non si attiva mai, un classico vuoto silenzioso in cui il report non mostra semplicemente nulla e nessuno se ne accorge per settimane.

Consent Mode v2. Non è facoltativo nell'UE

Da marzo 2024, Google richiede Consent Mode v2 se usi funzionalità di remarketing o misurazione delle conversioni di Google Ads con visitatori nello Spazio Economico Europeo. Senza, perdi i segmenti di pubblico per il remarketing e la modellazione delle conversioni per quegli utenti. Consent Mode v2, però, non sostituisce di per sé la conformità al GDPR, il consenso ai cookie e una base giuridica corretta richiedono comunque una CMP dedicata. Per un negozio rivolto all'UE che usa funzionalità pubblicitarie Google, non c'è modo di evitarlo.

Il flusso corretto è questo: lo stato di consenso predefinito è denied per i segnali applicabili, analytics_storage, ad_storage e, per i casi d'uso pubblicitari, ad_user_data e ad_personalization; quando il visitatore accetta i cookie, aggiorni i segnali pertinenti a granted e GA4 avvia il tracciamento completo. In stato negato, GA4 non si spegne, invia ping senza cookie che Google usa per i dati modellati, senza archiviazione identificativa dell'utente.

L'ordine conta: il comando di consenso default deve essere eseguito prima della configurazione gtag e prima di qualsiasi tag che legga il consenso, così il primissimo hit lo rispetta già. In una configurazione manuale, lo snippet nell'head appare così (la tua CMP chiamerà poi gtag('consent', 'update', …) quando il visitatore accetta):

<!-- Google tag (gtag.js) – in <head>, before any other GA/Ads tag -->
<script async src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  // Consent Mode v2 – default denied until the CMP says otherwise (EEA)
  gtag('consent', 'default', {
    'ad_storage': 'denied',
    'ad_user_data': 'denied',
    'ad_personalization': 'denied',
    'analytics_storage': 'denied',
    'wait_for_update': 500
  });

  gtag('config', 'G-XXXXXXXXXX');
</script>

L'aggiornamento qui sotto si applica quando il visitatore accetta tutte le categorie elencate; altrimenti, conceda solo le categorie a cui ha acconsentito:

gtag('consent', 'update', {
  'analytics_storage': 'granted',
  'ad_storage': 'granted',
  'ad_user_data': 'granted',
  'ad_personalization': 'granted'
});

Un modulo con Consent Mode v2 nativo collega tutto questo per te, così non devi inserire manualmente lo snippet né rischiare di sbagliare l'ordine. La tua configurazione GA4 deve dialogare con il livello di consenso che usi, il tuo modulo cookie/GDPR o una CMP di terze parti come Cookiebot o Axeptio (il core di PrestaShop non include di default un sistema completo per il consenso ai cookie). Se il tuo modulo non può integrarsi con lo strumento di consenso, sei costretto a scegliere tra tracciare senza consenso (un problema GDPR) o bloccare completamente GA4 fino al consenso (perdendo gran parte dei dati). Un modulo con supporto nativo a Consent Mode v2, come mprgoogleanalytics, esiste proprio per evitarti questa scelta. Per un confronto più completo tra GA4 e un'alternativa centrata sul consenso, leggi Matomo vs Google Analytics.

Verifica la configurazione, non fidarti di "sembra funzionare"

Un'installazione GA4 può inviare dati incompleti o duplicati pur apparendo perfettamente sana nella scheda Realtime. La verifica è il passaggio che distingue una configurazione reale da una speranzosa, e richiede dieci minuti.

Realtime, poi DebugView

• Test rapido: apri il negozio, poi in GA4 vai su Reports → Realtime. La tua visita dovrebbe comparire entro pochi secondi. Se non succede, il tag non si sta caricando, ricontrolla il Measurement ID.
• Controllo di rete: apri DevTools del browser (F12) → Network, filtra per collect e conferma le richieste a google-analytics.com/g/collect mentre navighi.
• Il test vero, DebugView: apri Admin → DebugView in GA4 (per popolarlo, abilita la modalità debug, usa Google Tag Assistant, l'estensione Chrome Google Analytics Debugger, la modalità anteprima di GTM oppure invia esplicitamente debug_mode=true; aprire solo DevTools non la attiva). Ora percorri il negozio come farebbe un cliente: visualizza una categoria, apri un prodotto, aggiungi al carrello, avvia la procedura di acquisto, effettua un ordine di test. Guarda comparire ogni evento con i suoi parametri. view_item si attiva nella pagina prodotto? add_to_cart si attiva sull'aggiunta AJAX? purchase si attiva una sola volta nella pagina di conferma con totale e articoli corretti?

Tag Assistant di Google (tagassistant.google.com) è il secondo controllo, mostra ogni tag Google che si attiva e segnala problemi di configurazione che potresti non notare in DebugView.

I quattro errori da cercare in modo specifico

• Purchase si attiva due volte. Se un cliente ricarica la pagina di conferma ordine, l'evento può attivarsi di nuovo e gonfiare il fatturato. Una configurazione corretta lo impedisce controllando se quell'ID transazione è già stato inviato.
• Categorie o marche nulle. I prodotti compaiono negli eventi ma con item_category / item_brand vuoti, l'integrazione non sta recuperando i dati prodotto completi dal database PrestaShop.
• Valuta incoerente. L'evento invia un prezzo in EUR ma un parametro valuta USD (o viceversa), falsando ogni report sul fatturato. Di solito si risale alla mancata corrispondenza tra valuta della proprietà e valuta del negozio descritta nella prima sezione.
• Niente sul carrello AJAX. Come sopra. add_to_cart non si attiva silenziosamente perché il listener ha mancato il percorso AJAX.

Filtra il tuo traffico prima di fidarti dei numeri

Le tue visite e quelle del tuo team gonfiano il coinvolgimento e inquinano i dati di conversione, e durante la configurazione generi molto traffico di test. Definiscilo come interno in modo che GA4 possa escluderlo: vai su Admin → Data Streams → [your web stream] → Configure tag settings → Show all → Define internal traffic e aggiungi gli indirizzi IP dell'ufficio e di casa. Poi, in Admin → Data Settings → Data Filters, conferma che il filtro "Internal Traffic" sia impostato su Active (di default è in modalità Testing e non fa nulla finché non lo attivi, un passaggio che quasi tutti dimenticano). GA4 esclude già automaticamente bot e spider noti, ma se continui a vedere pattern strani, il traffico sospetto va investigato, magari con controlli lato server, CMP o tagging, non con un singolo interruttore; per il caso specifico del crawler di Google che aggiunge articoli ai carrelli, leggi Google Storebot fa acquisti nel tuo negozio.

Dove guardare quando i dati iniziano ad arrivare

Con gli eventi che si attivano correttamente, i report specifici per l'e-commerce diventano utili. I tre che giustificano tutta la configurazione si trovano sotto Reports → Monetization:

• Ecommerce purchases, fatturato e unità per prodotto, categoria e marca. Se qui è vuoto, l'evento purchase o i dati prodotto sono rotti.
• Purchase journey, il funnel da view_item fino a purchase, con gli abbandoni in ogni fase.
• Checkout journey, il funnel dettagliato attraverso begin_checkout, add_shipping_info e add_payment_info. Un begin_checkout mancante lascia questo funnel senza punto di partenza, ed è la ragione più comune per cui appare vuoto.

Questi report funzionano solo perché gli eventi sottostanti si attivano correttamente, ed è il motivo per cui la verifica è venuta prima. Leggerli bene, capire quali numeri indicano un problema reale e quali sono rumore, è una competenza a sé; trattiamo l'interpretazione di GA4 in le metriche che contano davvero, e la domanda più ampia su cosa valga la pena tracciare in assoluto in cosa tracciare e cosa ignorare.

Collega GA4 al resto dell'ecosistema Google

Una volta che GA4 è solido, alcuni collegamenti aprono nuove possibilità. Da Admin → Product Links puoi collegare Google Ads (importare conversioni GA4, creare segmenti di pubblico per il remarketing), Search Console (termini di ricerca organica accanto al comportamento), Merchant Center (performance a livello prodotto) e BigQuery (esportazione degli eventi grezzi, con piano gratuito disponibile) per analisi che l'interfaccia di GA4 non può fare.

Un limite onesto: GA4 non è la tua fonte definitiva per il fatturato

Configura GA4 correttamente ed è eccellente per capire il comportamento, il percorso dei clienti, dove abbandonano, quali prodotti attirano visualizzazioni ma non convertono. Però GA4 può essere influenzato dal campionamento in Explorations e da soglie e limiti di cardinalità, perde dati quando il consenso viene negato ed elabora con ritardo; per questo non è lo strumento giusto per essere l'ultima parola sul fatturato. La verità sui ricavi resta in PrestaShop e negli ordini. Usa i dati ordine di PrestaShop e i report del tuo gestore dei pagamenti come fonte ufficiale per il denaro, e GA4 per capire il perché dietro quei numeri. Se vuoi report costruiti sul database reale del negozio invece che su analytics campionati, il nostro modulo di reportistica Financial Revolution legge direttamente da PrestaShop e riconcilia fino al centesimo.

Oltre i numeri: guarda cosa fanno davvero le persone

GA4 ti dice cosa è successo e quante volte, non ti mostra un cliente che esita davanti a un selettore di spedizione poco chiaro o clicca ripetutamente un pulsante che non risponde. Per quel livello qualitativo, affianca a GA4 registrazioni di sessione e mappe di calore: Microsoft Clarity (gratis) o Hotjar trasformano un abbandono del funnel di acquisto in GA4 in un video del perché è successo.

Domande frequenti

Perdo lo storico di Universal Analytics quando passo a GA4?

Di fatto sì. Universal Analytics ha smesso di elaborare nuovi dati a luglio 2023 e Google sta disattivando l'accesso ai vecchi report, quindi GA4 parte da zero il giorno in cui lo installi, non c'è migrazione delle sessioni storiche, perché GA4 usa un modello diverso, basato sugli eventi. Configura GA4 prima possibile, così accumula lo storico che ti servirà l'anno prossimo, ed esporta da UA tutto ciò che ti serve ancora finché puoi.

Posso usare ps_googleanalytics e un tag GA4 basato su GTM nello stesso momento?

No, conteresti due volte ogni visualizzazione pagina e ogni acquisto nella stessa proprietà, gonfiando il fatturato e rompendo i tassi di conversione. Scegli una sola strada: o GA4 è gestito dal modulo, o da GTM. Se passi a GTM, disattiva il modulo GA da Module Manager e verifica in DebugView che ogni azione compaia esattamente una volta.

Perché in GA4 il valore dell'acquisto è corretto ma la valuta è sbagliata?

Quasi sempre dipende dalla mancata corrispondenza tra valuta della proprietà e valuta del negozio descritta nella prima sezione, oppure da un push purchase che codifica una valuta fissa invece di leggere $currency.iso_code dall'ordine. GA4 non rielabora i dati storici, quindi un periodo con valuta sbagliata non può essere corretto retroattivamente, imposta la valuta della proprietà in modo che corrisponda al negozio e invia il vero codice ISO dell'ordine su ogni evento.

Consent Mode v2 è la stessa cosa di un banner cookie conforme al GDPR?

No. Consent Mode v2 è il meccanismo che i tag Google usano per leggere i segnali di consenso; è richiesto da marzo 2024 per le funzionalità Google Ads nello SEE, ma non è una piattaforma di gestione del consenso. Ti serve comunque una CMP reale (un modulo cookie o un banner certificato Google) per raccogliere e conservare la base giuridica, il core di PrestaShop non ne include una. Consent Mode dice a Google cosa ha scelto il visitatore; la CMP è ciò che glielo chiede davvero.

Il mio add_to_cart non si attiva mai, cosa c'è che non va?

La maggior parte dei temi PrestaShop aggiunge al carrello via AJAX senza ricaricare la pagina, quindi un tracciamento che ascolta solo il caricamento pagina non lo vede mai. L'evento deve agganciarsi alla risposta AJAX di aggiunta al carrello (la stessa chiamata gestita dal controller cart). È uno di quei vuoti silenziosi che lasciano un funnel vuoto nel mezzo, confermalo in DebugView aggiungendo al carrello e osservando l'evento; se preferisci non cablarlo a mano, un modulo come mprgoogleanalytics lo attiva dall'hook del carrello.

La versione breve

Una configurazione GA4 completa su PrestaShop richiede quattro lavori, in ordine: creare una sola proprietà con valuta e fuso orario corretti; scegliere un metodo di installazione che invii l'intero set di eventi e-commerce; integrare Consent Mode v2 per tracciare legalmente nell'UE; e verificare in DebugView che ogni evento arrivi con dati corretti e completi prima di fidarti di qualsiasi report. Salta la verifica e avrai un contatore di visualizzazioni pagina travestito da analytics. Fallo bene, oppure installa un modulo che gestisce per te l'impianto e-commerce e il consenso, come mprgoogleanalytics, e ottieni il funnel, il fatturato a livello prodotto e il quadro comportamentale che aiuta davvero a prendere decisioni.