# DataFirefly Google Tag Manager Pro — Guida completa > Panoramica e requisiti DataFirefly Google Tag Manager Pro invia un dataLayer ecommerce GA4 completo per il tuo negozio WooCommerce e ti permette di generare con un clic un contenitore Google… - Pagina: - Lingua: it - Aggiornato il: 2026-06-27 - Altre lingue: [fr](https://www.datafirefly.com/documentation/datafirefly-google-tag-manager-pro/index.md), [en](https://www.datafirefly.com/en/documentation/datafirefly-google-tag-manager-pro/index.md), [es](https://www.datafirefly.com/es/documentation/datafirefly-google-tag-manager-pro/index.md), [de](https://www.datafirefly.com/de/documentation/datafirefly-google-tag-manager-pro/index.md), [pl](https://www.datafirefly.com/pl/documentation/datafirefly-google-tag-manager-pro/index.md), [nl](https://www.datafirefly.com/nl/documentation/datafirefly-google-tag-manager-pro/index.md), [pt](https://www.datafirefly.com/pt/documentation/datafirefly-google-tag-manager-pro/index.md) - Indice: ## Panoramica e requisiti DataFirefly Google Tag Manager Pro invia un dataLayer ecommerce GA4 completo per il tuo negozio WooCommerce e ti permette di generare con un clic un contenitore Google Tag Manager pronto da importare, già collegato a questo dataLayer. Il plugin gestisce anche il tracciamento server-side (Meta Conversions API, GA4 Measurement Protocol) con deduplica automatica, il Consent Mode v2 e una modalità di iniezione diretta dei pixel per i negozi che non usano GTM. - WordPress 5.8 e superiore, testato fino a 7.0. - WooCommerce 7.0 e superiore, testato fino a 9.6, compatibile con HPOS e Cart/Checkout Blocks. - PHP 7.4 e superiore. - Multilingua (FR/EN/ES/DE/IT), compatibile con Polylang e WPML. - Nessun tracciamento emesso in admin, nei feed o nel customizer. Il plugin separa due ruoli: **produce i dati** (il dataLayer GA4) e **ti aiuta a distribuirli** (contenitore GTM generato, pixel diretti, eventi server-side). Scegli la modalità di distribuzione che preferisci. ## Installazione 1. Scarica l'archivio `datafirefly-gtm-pro-1.1.0.zip` dal tuo account cliente. 2. Nell'admin di WordPress, vai su **Plugin > Aggiungi nuovo > Carica plugin** e rilascia l'archivio. 3. Fai clic su **Attiva**. 4. Apri **Tag Manager Pro** dal menu di amministrazione per accedere alle impostazioni. All'attivazione, il plugin registra le sue impostazioni predefinite. Puoi poi inserire il contenitore, le connessioni e attivare il server-side scheda per scheda. ## Scheda Generale — contenitore e dataLayer Questa scheda governa l'iniezione del contenitore e la forma del dataLayer: - **ID del contenitore**: il tuo ID GTM nel formato `GTM-XXXXXXX`. Finché è vuoto, non viene iniettato nulla lato GTM (il dataLayer e la modalità diretta restano disponibili). - **Nome del dataLayer**: `dataLayer` per impostazione predefinita. Modificalo solo se la tua installazione lo richiede. - **Posizionamento**: head + body (noscript), solo head o solo body. - **Priorità di output**: standard o alta (il contenitore viene scritto presto nell'`head`). Il tracciamento non viene mai emesso per amministratori e staff in base ai ruoli esclusi (scheda Avanzate), né in admin, nei feed RSS o nel customizer. ## Scheda Connessioni — le tue piattaforme Inserisci qui gli identificativi delle piattaforme che usi. Questa base alimenta allo stesso tempo il contenitore GTM generato, i pixel diretti e gli eventi server-side. Lascia vuoto ciò che non usi. - **Google Analytics 4**: Measurement ID (`G-XXXXXXXXXX`). - **Google Ads**: Conversion ID (`AW-XXXXXXXXX`), etichetta di conversione di acquisto, remarketing dinamico (opzione). - **Meta**: Pixel ID, token Conversions API, codice di test CAPI (opzione). - **TikTok**: Pixel ID, token Events API (opzione). - **Pinterest**: Tag ID — **Snapchat**: Pixel ID — **LinkedIn**: Partner ID. - **Microsoft Advertising (UET)**: Tag ID — **X**: Pixel ID. - **Hotjar**: Site ID — **Microsoft Clarity**: Project ID. In fondo alla scheda, l'impostazione **Distribuzione dei pixel** seleziona la modalità: **tramite Google Tag Manager** (consigliato, importi il contenitore generato) o **iniezione diretta** (il plugin carica i pixel da solo). ## Tag Pilot — generare e importare il contenitore GTM La scheda **Tag Pilot** costruisce un contenitore Google Tag Manager completo a partire dalle tue connessioni e lo offre per il download. Genera in particolare: - il tag di configurazione Google di GA4 e un tag evento GA4 per ogni evento attivato (con invio dei dati ecommerce dal dataLayer); - il Conversion Linker, la conversione di acquisto e il remarketing dinamico di Google Ads; - il pixel di Meta e i suoi eventi standard (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase, Search); - tag Custom HTML per TikTok, Pinterest, Snapchat, LinkedIn, Microsoft UET, X, Hotjar e Clarity; - le Data Layer Variables e i trigger di eventi personalizzati corrispondenti. Per importarlo: 1. Fai clic su **Scarica contenitore GTM (.json)**. 2. In Google Tag Manager, apri **Amministrazione > Importa contenitore**. 3. Seleziona il file JSON, scegli il tuo spazio di lavoro, poi **Unisci** (mantiene i tag esistenti) o **Sovrascrivi**. 4. Anteprima, poi **Invia e pubblica**. Su un contenitore esistente, preferisci **Unisci** per non rimuovere i tuoi altri tag. ## Modalità pixel diretta (senza GTM) Se preferisci non dipendere da GTM, imposta la distribuzione su **iniezione diretta** nella scheda Connessioni. Il plugin inietta allora i pixel di base da solo (GA4, Meta e le altre piattaforme configurate) e ripropone gli eventi ecommerce del dataLayer verso Meta, TikTok, Pinterest, Snapchat e GA4. Lo stesso dataLayer alimenta entrambi gli approcci. Non attivare lo stesso pixel contemporaneamente tramite GTM _e_ tramite iniezione diretta: rischieresti un doppio conteggio. Scegli un'unica modalità di distribuzione per piattaforma. ## Server-side — Meta CAPI e GA4 Measurement Protocol Nella scheda **Server-side**, attiva l'invio degli acquisti direttamente dal tuo server: - **Meta Conversions API**: richiede il Pixel ID e un token CAPI (scheda Connessioni). L'evento Purchase viene inviato con dati cliente con hash SHA-256, i cookie `_fbp`/`_fbc`, l'indirizzo IP e lo user-agent. - **GA4 Measurement Protocol**: richiede il Measurement ID (Connessioni) e un **secret API** (GA4 > Amministrazione > Flussi di dati > Measurement Protocol). Il browser e il server condividono lo stesso `event_id` deterministico per ordine (`dfgtm.purchase.`). Meta e GA4 lo usano per contare ogni conversione una sola volta. Le richieste server-side vengono inviate in modo non bloccante dopo il pagamento, sugli stati «in lavorazione», «completato» o «pagamento completato», una sola volta per ordine. ## Consent Mode v2 ed Enhanced Conversions La scheda **Consent** attiva il Consent Mode v2: stati di consenso _denied_ vengono impostati per impostazione predefinita prima del caricamento del contenitore, con scoping EEA/UK, `wait_for_update`, URL passthrough e redaction dei dati pubblicitari. Per aggiornare il consenso in base alla scelta dell'utente, collega il tuo banner cookie all'API JavaScript fornita: ``` // Accetta tutto window.dfgtmConsent.grantAll(); // Rifiuta tutto window.dfgtmConsent.denyAll(); // Aggiornamento granulare window.dfgtmConsent.update({ ad_storage: 'granted', analytics_storage: 'granted' }); ``` Le **Enhanced Conversions** di Google Ads (scheda GA4 Ecommerce) aggiungono dati cliente con hash SHA-256 all'evento di acquisto per migliorare l'attribuzione. ## Eventi ecommerce GA4 Il plugin invia i seguenti eventi ecommerce GA4, ciascuno attivabile singolarmente, con oggetti `items` completi (item_id da SKU o ID, marca, categorie fino a 5 livelli, variante, prezzo, sconto): - `view_item_list`, `view_item`, `select_item` - `add_to_cart`, `remove_from_cart`, `view_cart` - `begin_checkout`, `add_shipping_info`, `add_payment_info` - `purchase` (deduplicato: attivato una sola volta per ordine, anche al ricaricamento), `search` ## Hook per sviluppatori Il plugin espone filtri nei punti chiave per estendere il comportamento senza modificare il core: - `dfgtm_export_container`: modificare il contenitore GTM generato prima della codifica. - `dfgtm_meta_capi_payload` e `dfgtm_ga4_mp_payload`: regolare i payload server-side. - `dfgtm_connections_registry`: aggiungere o modificare destinazioni. - `dfgtm_purchase_push` e `dfgtm_build_item`: personalizzare i dati di acquisto e la costruzione degli items. ## FAQ e risoluzione dei problemi ### Non viene iniettato nulla lato GTM Verifica che l'ID del contenitore (`GTM-XXXXXXX`) sia inserito nella scheda Generale e che tu non abbia effettuato l'accesso con un ruolo escluso. Il dataLayer e la modalità diretta funzionano anche senza contenitore GTM. ### Le conversioni vengono conteggiate due volte su Meta Assicurati di non caricare lo stesso pixel contemporaneamente tramite il contenitore GTM e tramite iniezione diretta. Il server-side e il browser vengono deduplicati automaticamente tramite `event_id`: non è una fonte di doppio conteggio. ### L'evento di acquisto non viene inviato server-side Verifica che l'opzione corrispondente sia attivata nella scheda Server-side e che gli identificativi richiesti siano inseriti: Pixel ID + token CAPI per Meta, Measurement ID + secret API per GA4. L'invio avviene una volta per ordine. ### Il tag GA4 non invia i dati ecommerce Nel contenitore generato, i tag evento GA4 leggono i dati ecommerce dal dataLayer. Se hai costruito i tuoi tag manualmente, attiva «Invia dati Ecommerce» e scegli «dataLayer» come origine. ### Cosa succede alla disinstallazione? Se l'opzione corrispondente è attivata nella scheda Avanzate, le impostazioni e i meta di tracciamento degli ordini vengono rimossi. In caso contrario, vengono conservati per un'eventuale reinstallazione.