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

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

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.

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.

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.<id>). Meta e GA4 lo usano per contare ogni conversione una sola volta.

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.