Google Tag Pro (GTM & GA4) — Guida completa

Google Tag Pro (il modulo dfgtagmanager) installa un tracking e-commerce completo e affidabile sul tuo negozio: 16 eventi GA4 Enhanced Ecommerce, Consent Mode v2, Enhanced Conversions, tracciamento delle conversioni Google Ads, pixel pubblicitari, Server-side GTM e un sistema di Conversion Recovery che riproduce le conversioni perse. Questa guida copre l’installazione, ogni sezione di configurazione e la risoluzione dei problemi.

Requisiti

• PrestaShop 8.0 a 9.0 (PHP 8.1 a 8.4 raccomandato).
• Un account Google Tag Manager con un container Web (ID nel formato GTM-XXXXXXX).
• Una proprietà Google Analytics 4 (ID di misurazione nel formato G-XXXXXXXXXX).
• Facoltativo: un account Google Ads (ID di conversione AW-XXXXXXXXX), Google Merchant Center e/o un server sGTM.

Installazione

1. Nel back-office, vai in Moduli > Gestore dei moduli, clicca su Carica un modulo e seleziona il file dfgtagmanager.zip.
2. Una volta installato, clicca su Configura.
3. Il modulo crea le sue tabelle (registro delle conversioni e degli eventi) e registra i suoi hook automaticamente.

1. Configurazione di Google Tag Manager

Nella sezione Google Tag Manager – Configurazione:

• Attiva GTM: attiva l’iniezione del container nel front-office.
• ID container GTM: il tuo identificativo GTM-XXXXXXX. Finché è vuoto, il modulo non inietta nulla.
• ID di misurazione GA4: il tuo identificativo G-XXXXXXXXXX. Viene usato per pre-compilare il tag GA4 nell’export del container.

Il modulo invia i dati nel dataLayer prima del caricamento di GTM, così che tutti i tuoi tag dispongano immediatamente dei dati di pagina ed e-commerce.

2. Eventi di tracking (GA4 Enhanced Ecommerce)

Una volta attivato, il modulo invia automaticamente fino a 16 eventi conformi allo schema GA4 ufficiale:

• Scoperta: view_item, view_item_list, select_item
• Carrello e checkout: add_to_cart, remove_from_cart, view_cart, begin_checkout, add_shipping_info, add_payment_info
• Conversione: purchase (con items[], value, tax, shipping, coupon, transaction_id)
• Utente e marketing: login, sign_up, search, add_to_wishlist, view_promotion, select_promotion

Gli eventi di carrello, checkout, promozioni e ricerca sono attivati lato client (intercettazione AJAX e IntersectionObserver); l’evento purchase è costruito lato server alla conferma dell’ordine.

Impostazioni associate nella sezione Eventi di tracking: attiva/disattiva GA4 Enhanced Ecommerce, i dati utente (user_data), la ricerca interna, login, registrazione, promozioni, wishlist e il remarketing dinamico.

3. Consent Mode v2 (GDPR / DMA)

Il Consent Mode v2 è obbligatorio dal marzo 2024 per misurare le conversioni Google nel SEE. Nella sezione Consent Mode v2:

• Attiva Consent Mode v2: inietta i valori di consenso di default prima di GTM.
• analytics_storage / ad_storage di default: lascia su Negato (raccomandato GDPR); il consenso sarà aggiornato dal tuo banner.

Il modulo attiva anche url_passthrough e ads_data_redaction per massimizzare la modellazione delle conversioni in assenza di consenso.

Collegare il tuo banner cookie (CMP)

Quando il visitatore accetta o rifiuta, chiama la funzione fornita dal modulo dal tuo CMP (Tarteaucitron, Axeptio, Cookiebot, ecc.):

DFGTM.updateConsent({
  analytics_storage: 'granted',
  ad_storage: 'granted',
  ad_user_data: 'granted',
  ad_personalization: 'granted'
});

4. Enhanced Conversions

Quando sono attivati, gli Enhanced Conversions migliorano l’attribuzione Google Ads. Il modulo effettua l’hash lato server in SHA-256 dei dati del cliente (email, nome, telefono, città) e li trasmette tramite il dataLayer. I dati non vengono mai trasmessi in chiaro; il codice postale e il paese vengono inviati senza hash, conformemente alle specifiche di Google.

5. Conversioni Google Ads e Merchant Center

Nella sezione Google Ads – Tracciamento delle conversioni:

• Attiva Google Ads Conversion: aggiunge il Conversion Linker, il tag di conversione d’acquisto e il remarketing dinamico all’export GTM.
• Conversion ID: il tuo identificativo AW-XXXXXXXXX.
• Conversion Label (Acquisto): il label della conversione «Acquisto» (stringa alfanumerica).
• Merchant Center ID + paese e lingua del feed: richiesti per le «conversioni con dati del carrello».
• Sorgente dell’ID prodotto: scegli il formato corrispondente al campo id del tuo feed Merchant Center (ID + separatore + combinazione, riferimento/SKU, solo ID, EAN13, UPC o MPN).

6. Pixel pubblicitari (Meta, TikTok, Pinterest)

Nella sezione Pixel pubblicitari, inserisci i tuoi identificativi Facebook/Meta, TikTok e Pinterest. Sono integrati nell’export del container GTM con gli eventi e-commerce mappati automaticamente (Purchase, AddToCart, ViewContent, InitiateCheckout, Search / CompletePayment / checkout secondo la piattaforma).

7. Export del container GTM

Invece di creare manualmente decine di tag, il modulo genera un container pronto da importare:

1. Nella sezione Export container GTM, clicca su Esporta il container GTM (JSON).
2. In Google Tag Manager, vai in Admin > Importa container.
3. Seleziona il file JSON, scegli uno spazio di lavoro e l’opzione Unisci (o Sovrascrivi su un container vuoto).
4. Verifica l’anteprima e poi Pubblica il tuo container.

L’export contiene il tag GA4 Configuration e tutti gli eventi Enhanced Ecommerce, le variabili DataLayer, gli attivatori Custom Event, il Consent Mode v2, oltre ai tag Google Ads e ai pixel attivati.

8. Server-Side GTM (sGTM)

Nella sezione Server-Side GTM, attiva l’opzione e inserisci l’URL del tuo server (per es. https://sgtm.tuo-dominio.com). Il modulo carica allora lo script GTM e il noscript dal tuo server invece che da googletagmanager.com, ciò che bypassa gli ad-blocker e migliora l’affidabilità del tracking.

9. Conversion Recovery

È la funzionalità chiave del modulo. Alla conferma di ogni ordine, la conversione viene salvata in database. Un controllo asincrono verifica che GTM abbia ricevuto l’evento purchase; in caso contrario (ad-blocker, reindirizzamento di pagamento, errore di rete), l’evento viene riprodotto automaticamente alla prossima visita del cliente. Non è richiesta alcuna configurazione; lascia l’opzione attivata nelle Opzioni avanzate.

10. Opzioni avanzate

• Cross-domain tracking: elenca i domini interessati (separati da virgole).
• Escludi imposte / spese di spedizione dal ricavo: regola il calcolo di value per purchase.
• Modalità debug: mostra ogni push dataLayer nella console del browser (prefisso colorato «DataFirefly GTM»). Da disattivare in produzione.

11. Dashboard di monitoraggio

In alto nella pagina di configurazione, una dashboard mostra su 30 giorni: il numero di conversioni tracciate, quelle inviate con successo, quelle in attesa di recovery, il ricavo tracciato, il tasso di successo del tracking e i top eventi su 7 giorni. Un pulsante Riproduci permette di ri-marcare le conversioni fallite per un nuovo tentativo.

Compatibilità PrestaShop 9

Dalla versione 1.2.0, il modulo è compatibile con PrestaShop 8 e 9 (Symfony 6.4, PHP 8.1 a 8.4). La formattazione dei prezzi passa dalla Locale (il vecchio metodo Tools::displayPrice è stato rimosso da PS9), il tracciamento della ricerca è lato client, e sia le sessioni sia il download dell’export sono stati rafforzati per il kernel Symfony. Non è richiesta alcuna azione durante l’aggiornamento; lo script di upgrade pulisce automaticamente gli hook obsoleti.

Risoluzione dei problemi

Nessun dato arriva a GTM / GA4

Verifica che Attiva GTM sia spuntato e che l’ID del container sia compilato. Il modulo non inietta nulla finché entrambe le condizioni non sono soddisfatte. Usa l’anteprima di GTM (Preview) e la modalità debug del modulo per vedere i push dataLayer.

Le conversioni Google Ads non si attivano

Assicurati di aver importato e pubblicato il container esportato dopo aver inserito l’ID di conversione e il label. Verifica il formato AW-XXXXXXXXX e il label d’acquisto.

Mancano i dati del carrello (Merchant Center)

Compila il Merchant Center ID, il paese e la lingua del feed, e verifica che la sorgente dell’ID prodotto corrisponda al campo id del tuo feed.

Il consenso resta «negato»

Collega il tuo CMP chiamando DFGTM.updateConsent() all’accettazione. Senza questa chiamata, vengono raccolti solo dati modellizzati.

Il file di export è vuoto o corrotto

Disattiva temporaneamente i moduli di cache/ottimizzazione HTML e riprova; l’export pulisce i buffer di output ma un modulo di terze parti può iniettare contenuto prima del download.