# 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…

- Pagina: <https://www.datafirefly.com/it/documentation/google-tag-pro-prestashop/>
- Lingua: it
- Aggiornato il: 2026-07-09
- Altre lingue: [fr](https://www.datafirefly.com/documentation/google-tag-pro-prestashop/index.md), [en](https://www.datafirefly.com/en/documentation/google-tag-pro-prestashop/index.md), [es](https://www.datafirefly.com/es/documentation/google-tag-pro-prestashop/index.md), [de](https://www.datafirefly.com/de/documentation/google-tag-pro-prestashop/index.md), [pl](https://www.datafirefly.com/pl/documentation/google-tag-pro-prestashop/index.md), [pt](https://www.datafirefly.com/pt/documentation/google-tag-pro-prestashop/index.md), [nl](https://www.datafirefly.com/nl/documentation/google-tag-pro-prestashop/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

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.

Il modulo è compatibile multinegozio: ogni negozio conserva il proprio container GTM, il proprio ID GA4, i propri pixel e le proprie impostazioni di consenso. Configura ogni contesto dal selettore del negozio in alto nella pagina.

## 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.

Dalla versione 1.2.0, l'evento `search` è emesso lato client per restare compatibile con PrestaShop 9.1, dove l'hook `displaySearch` è deprecato. Non è richiesta alcuna azione da parte tua.

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'
});
```

Se non chiami mai `updateConsent()`, il consenso resta sui valori di default (negato) e raccoglierai solo dati modellizzati. Collega assolutamente il tuo CMP.

## 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).

La sorgente dell'ID prodotto deve corrispondere **esattamente** all'ID utilizzato nel tuo feed Merchant Center, altrimenti le conversioni con dati del carrello non verranno riportate. In caso di dubbio, usa la stessa sorgente del tuo modulo di feed prodotti.

## 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.

Rigenera e reimporta l'export dopo aver modificato i tuoi ID (GA4, Google Ads, pixel) affinché il container rifletta le tue nuove impostazioni.

## 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.

Punta a un tasso di tracking > 95%. Sotto l'80%, attiva il Server-Side GTM per bypassare gli ad-blocker.

## 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.