Nel container server di Google Tag Manager i dati si trasformano in tre punti: con le variabili (che leggono e rielaborano i parametri in arrivo), con le Trasformazioni (che modificano, aggiungono o escludono parametri prima che l’evento raggiunga uno o più tag) e dentro i template personalizzati. Il flusso è sempre lo stesso: il client riceve la richiesta HTTP, la converte in un oggetto Event Data, tu lo manipoli, i tag lo leggono nella versione modificata.
Qui sotto trovi il percorso completo: cosa arriva davvero al container, quali strumenti hai a disposizione, come normalizzare valute e nomi evento, come arricchire e anonimizzare i parametri, un esempio end-to-end su un purchase e la checklist di troubleshooting quando una trasformazione non si applica.
Piccola precisazione, perché la parola "container" è ambigua: non stiamo parlando di immagini Docker, volumi o docker commit. Il container server di GTM è un’applicazione che gira dentro un container Docker su Cloud Run o su un hosting gestito, ma quello che modifichi qui è la configurazione di tag, trigger e variabili, non l’infrastruttura.
Perché serve trasformare i dati prima dei tag
Il problema concreto lo conosci già se hai aperto una DebugView dopo una migrazione: currency che arriva come eur minuscolo e Google Ads la scarta, value come stringa "129,90" invece che numero, page_location pieno di parametri interni, email in chiaro nella query string di una thank you page, nomi evento GA4 che Meta non riconosce.
Finché tracci solo lato client puoi correggere a monte nel Data Layer o nel container web. Lato server hai un vantaggio in più: un solo punto di intervento alimenta tutte le destinazioni. Normalizzi una volta e GA4, Google Ads e Meta CAPI (Conversions API, l’endpoint server-to-server di Meta) ricevono lo stesso valore pulito.
Il server-side tagging è l’architettura in cui gli eventi del sito vengono inviati a un tuo endpoint su dominio di primo livello, e da lì ridistribuiti alle piattaforme. Se il concetto ti è ancora nebuloso, parti dalla differenza tra tracciamento client-side e server-side e torna qui.
Cosa ti serve prima di iniziare
Non mettere mano alle trasformazioni se manca uno di questi pezzi. Rischi di sistemare a valle un problema che hai a monte.
- Un container server attivo e raggiungibile su un dominio personalizzato di primo livello, non su un sottodominio di terze parti.
- Il client GA4 attivo nel container server e il tag GA4 web che punta al
server_container_url. La procedura completa è in come collegare GA4 al container server. - Un Data Layer documentato: sapere quali eventi e quali chiavi arrivano, con che tipo di dato. Se parti da un e-commerce, la struttura del Data Layer è il prerequisito reale di tutto il resto.
- Accesso alla Modalità Anteprima del container server e a GA4 DebugView.
- Una decisione presa sul consenso: sapere quale segnale di Consent Mode v2 arriva al server e cosa deve succedere quando manca.
Il percorso del dato, in chiaro
Browser → tag GA4 web (configurato con server_container_url) → richiesta HTTPS verso https://sgtm.tuodominio.it/g/collect → client GA4 nel container server → oggetto Event Data → variabili e trasformazioni → tag in uscita (GA4, Google Ads, Meta CAPI, BigQuery).
Il client è il traduttore: prende una richiesta HTTP con decine di parametri criptici (en, cid, ep.*, epn.*) e la trasforma in un oggetto con chiavi leggibili (event_name, client_id, items, value). Tutto quello che fai dopo lavora su quell’oggetto.
Dove conviene trasformare: Data Layer, GTM web o server?
Questa è la domanda che decide metà del lavoro. La mia posizione è netta: se puoi correggere il Data Layer alla fonte, fallo e non discutere. Le trasformazioni server sono una toppa elegante, ma restano una toppa — e tra sei mesi nessuno si ricorderà perché value nel codice del sito è una stringa.
| Punto di intervento | Quando conviene | Limiti |
|---|---|---|
| Data Layer del sito | Dato sbagliato alla fonte, serve a tutti i canali, hai accesso agli sviluppatori | Richiede deploy, tempi lunghi su CMS gestiti da terzi |
| GTM web | Correzione veloce, serve solo al tracciamento client | Lo vede l’ad-blocker, duplichi la logica per ogni tag |
| Client nel container server | Normalizzazione che deve valere per ogni evento in ingresso | Richiede un client personalizzato, più complesso |
| Variabili server | Rielaborazione del valore per uno o più tag | Devi ricordarti di usarle in ogni tag |
| Trasformazioni | Modifica trasversale su più tag senza toccarli uno a uno | Meno visibile: si dimentica che esistono |
Su WooCommerce e PrestaShop hai quasi sempre modo di sistemare il Data Layer via plugin o hook. Su Shopify, soprattutto fuori da Shopify Plus, il controllo sul checkout è limitato: lì il server diventa la sede naturale della normalizzazione.
Criterio pratico: se il dato è sbagliato, correggilo a monte; se il dato è corretto ma va adattato a una destinazione specifica, trasformalo nel server. eur minuscolo è un dato sbagliato. Il nome evento purchase che deve diventare Purchase per Meta è un adattamento di destinazione.
Quali strumenti di trasformazione hai in sGTM
Le variabili
Sono il mattone base. Quelle che userai davvero:
- Event Data: legge una chiave dall’evento. Supporta i percorsi puntati, quindi
items.0.item_idfunziona. - Tabella di ricerca (Lookup Table): mappatura uno a uno. Perfetta per convertire nomi evento GA4 in eventi standard Meta.
- Tabella RegEx: come sopra, ma con espressioni regolari. Utile per raggruppare URL o categorie.
- JavaScript personalizzato (sandboxed): la trasformazione vera. Attenzione: è JavaScript limitato, niente
fetch, niente oggetti del browser. Importi le API conrequire(). - Template di variabile personalizzati: quando la stessa logica serve in più container o in più account. La Galleria dei template ne contiene molti già pronti, compresi quelli per hashing e formattazione.
Le Trasformazioni
Sono un oggetto a sé nel container server, nella sezione omonima. Una Trasformazione fa tre cose: modifica un parametro, aggiunge parametri, esclude parametri. Poi la colleghi a tutti i tag, a tag specifici o a un gruppo.
La differenza con le variabili è sostanziale. Una variabile la devi inserire manualmente nel campo del tag. Una Trasformazione agisce sull’Event Data che il tag riceve, senza che tu tocchi il tag. È lo strumento giusto quando devi rimuovere un parametro sensibile da tutti i tag di terze parti, lasciandolo solo a GA4.
Come normalizzare i parametri più problematici
Partiamo da un Data Layer realistico, con i difetti che si vedono in produzione:
dataLayer.push({
event: 'purchase',
ecommerce: {
transaction_id: ' ORD-10422 ',
value: '129,90',
currency: 'eur',
items: [{ item_id: 'SKU-1', item_name: 'Giacca', price: '129,90', quantity: 1 }]
},
user_data: { email: ' Mario.Rossi@Example.IT ' }
});
Tre problemi: valuta minuscola, valore numerico come stringa con virgola, email con spazi e maiuscole.
Valuta e valore
Variabile JavaScript personalizzato lato server per il valore:
const getEventData = require('getEventData');
const makeNumber = require('makeNumber');
const raw = getEventData('value');
if (raw === undefined || raw === null) return undefined;
const cleaned = (raw + '').replace(',', '.').replace(' ', '');
const n = makeNumber(cleaned);
return (n === n) ? n : undefined; // esclude NaN
Per la valuta basta una variabile analoga con toUpperCase() sul risultato di getEventData('currency'). Niente Lookup Table: le valute sono troppe.
Nome evento verso gli standard Meta
Tabella di ricerca, variabile in input Event Name:
| In ingresso | In uscita |
|---|---|
purchase |
Purchase |
add_to_cart |
AddToCart |
begin_checkout |
InitiateCheckout |
view_item |
ViewContent |
generate_lead |
Lead |
Imposta un valore predefinito vuoto e usa quella variabile come condizione di attivazione: se la mappatura non esiste, il tag Meta non parte. Eviti eventi custom inutili nel Business Manager.
page_location pulito
Rimuovi i parametri interni (?debug=1, ID sessione, token) con una variabile che ricostruisce l’URL tenendo solo i parametri UTM e gclid. Il motivo non è estetico: ogni variante di URL frammenta i report di pagina in GA4.
Errori comuni in questa fase
valuecome stringa: Google Ads registra la conversione ma con valore 0 o nullo.- Array
itemsvuoto o conpricestringa: GA4 non popola i report di monetizzazione. - Trim dimenticato su
transaction_id: nascono due ordini distinti e la deduplicazione salta. - Variabile che restituisce
undefinedinvece di omettere il parametro: alcuni endpoint ricevono la stringa letterale "undefined".
Come arricchire gli eventi senza pagare il conto in latenza
Arricchire significa aggiungere al server dati che il browser non ha o non deve avere: margine di prodotto, categoria cliente dal CRM, ID ordine del gestionale, costo del venduto.
Tre modi, in ordine di costo crescente:
- Calcolo locale: derivi il dato da ciò che hai già (ad esempio un
value_netcalcolato davaluee dall’aliquota IVA). Costo zero, nessuna latenza. - Lookup statica: una Tabella di ricerca o una RegEx Table nel container. Va bene per mappature stabili (categoria → margine medio). Si aggiorna a mano.
- Chiamata esterna (Firestore, un’API tua): dato sempre aggiornato, ma ogni richiesta aggiunge tempo di esecuzione e quindi consumo dell’istanza.
Sul punto 3 sii prudente. Il container server fattura in base al tempo di calcolo e alle istanze attive: una chiamata sincrona su ogni page_view cambia la bolletta, una chiamata sul solo purchase no. Se vuoi capire come si muovono i numeri, l’analisi dettagliata è in quanto costa un container server side.
Due accortezze che evitano problemi dopo:
- Coerenza tra destinazioni: se arricchisci con
customer_type, mandalo a GA4 come parametro evento e a BigQuery nello stesso flusso. Altrimenti ti ritrovi con due verità. - Non toccare
event_id: deve restare identico tra browser e server, altrimenti Meta conta due volte lo stesso acquisto. Il meccanismo è spiegato in come deduplicare gli eventi tra browser e server.
Come anonimizzare e trattare i dati personali
Qui si gioca la parte delicata. Il principio operativo: al server possono arrivare dati personali, alle destinazioni arriva solo ciò che serve e nella forma giusta.
Rimuovere ciò che non deve uscire
Crea una Trasformazione di tipo Escludi parametri applicata ai tag GA4, che rimuova user_data.email_address, user_data.phone_number e qualsiasi parametro custom con dati identificativi. GA4 ha regole chiare contro l’invio di dati personali nei parametri evento, e un page_location con ?email=mario@... è una violazione silenziosa che nessuno nota per mesi.
Hash per Enhanced Conversions e Meta CAPI
Enhanced Conversions di Google Ads e Meta CAPI accettano dati di contatto solo in forma hashata con SHA-256. L’ordine delle operazioni conta:
- Trim degli spazi iniziali e finali.
- Minuscolo per l’intera stringa dell’email.
- Per il telefono: formato E.164 (
+393331234567), solo cifre e prefisso. - Solo a questo punto applichi SHA-256, output esadecimale minuscolo.
Se hashi prima di normalizzare, l’hash sarà diverso da quello calcolato dalla piattaforma sui propri dati e il match non avviene. È l’errore numero uno su Enhanced Conversions.
Nota pratica: il tag ufficiale Google Ads Conversion Tracking nel container server può gestire l’hashing autonomamente se gli passi i valori in chiaro nei campi corretti. Non hashare due volte.
Consenso: nessuna scorciatoia
Il tracciamento lato server non aggira il GDPR. Se l’utente non ha dato il consenso per finalità di marketing, i dati non devono raggiungere Google Ads o Meta — punto. Le trasformazioni servono a ridurre ciò che esce, non a mascherare una raccolta non autorizzata.
In pratica: fai arrivare lo stato del consenso al container (Consent Mode v2 lo trasmette nella richiesta), e usa quello stato come condizione di attivazione dei tag pubblicitari. La configurazione passo-passo è in come configurare Consent Mode v2 lato server, e l’inquadramento normativo in tracciamento server-side conforme al GDPR.
Esempio completo: un purchase verso tre destinazioni
Riprendiamo il Data Layer sporco di prima. Sequenza operativa:
- Client GA4 riceve l’evento e produce l’Event Data con
event_name: purchase. - Variabili:
sv - value numerico,sv - currency upper,sv - transaction_id trim,sv - email normalizzata,lt - meta event name. - Trasformazione "Normalizza ecommerce": tipo Modifica parametri, sovrascrive
value,currency,transaction_idcon le variabili sopra. Applicata a tutti i tag. - Trasformazione "Rimuovi PII da GA4": tipo Escludi parametri, applicata al solo tag GA4.
- Tag GA4 con il client ID corretto e i parametri già puliti.
- Tag Google Ads Conversion Tracking con Enhanced Conversions: email normalizzata nel campo dedicato,
transaction_idcome ID ordine per la deduplicazione. - Tag Meta CAPI:
event_namedalla Lookup Table,event_idpreso dall’Event Data,emephhashati.
Risultato sui parametri chiave:
| Parametro | Prima | Dopo |
|---|---|---|
value |
"129,90" (stringa) |
129.9 (numero) |
currency |
eur |
EUR |
transaction_id |
" ORD-10422 " |
ORD-10422 |
| email verso GA4 | presente in chiaro | assente |
| email verso Ads/Meta | Mario.Rossi@Example.IT |
SHA-256 di mario.rossi@example.it |
| nome evento Meta | purchase |
Purchase |
Verifica su tre fronti: Anteprima del container server (scheda richieste in uscita), GA4 DebugView per i parametri effettivi, Test Events di Meta per event_id e qualità del match. La stessa logica vale per la configurazione di Facebook CAPI nel container server.
Troubleshooting: perché la trasformazione non si applica
Checklist in ordine di frequenza, dalla causa più banale alla più seria.
- La variabile restituisce
undefined: hai sbagliato il percorso della chiave. In Anteprima apri la scheda Event Data e copia il nome esatto, inclusi eventuali prefissi. - Tipo di dato errato: la variabile restituisce
"129.9"invece di129.9. Guarda le virgolette nel riquadro delle variabili in Anteprima: se ci sono, è una stringa. - Trasformazione legata al tag sbagliato: nella scheda della Trasformazione controlla la sezione di associazione. È l’errore più frequente quando si usa Tag specifici.
- Stai guardando la richiesta in entrata invece di quella in uscita: le trasformazioni agiscono a valle. Nella richiesta in entrata vedrai sempre i dati originali, ed è corretto così.
- Modifiche non pubblicate: l’Anteprima lavora sull’area di lavoro, ma se stai testando dal sito in produzione senza debug attivo vedi la versione pubblicata.
- Errori nei template JavaScript: le eccezioni finiscono nei log dell’ambiente di esecuzione. Su Cloud Run li trovi in Cloud Logging; su un hosting gestito dovresti avere accesso a un pannello log. Un
require()di un’API non autorizzata blocca l’intera variabile in silenzio.
Dopo ogni modifica alle trasformazioni, verifica che il consenso continui a essere rispettato: una Trasformazione applicata "a tutti i tag" può reintrodurre un parametro che avevi escluso. Il metodo di controllo è in come verificare che il consenso venga rispettato.
Fin dove puoi arrivare da solo
Normalizzazione di valute, nomi evento e URL: procedi in autonomia, sono variabili semplici e l’errore è reversibile in due minuti.
Hashing per Enhanced Conversions, logica di consenso applicata ai tag pubblicitari, arricchimento con chiamate esterne e flussi verso BigQuery: qui un errore produce dati sbagliati che non ti accorgi di avere, oppure un problema di conformità. Se non hai già fatto questi passaggi almeno una volta, meglio farsi affiancare durante l’implementazione che scoprire tra due mesi che le conversioni avanzate non hanno mai fatto match.
Domande frequenti
Posso modificare i dati senza toccare il codice del sito?
Sì. Le variabili e le Trasformazioni del container server agiscono sull’Event Data già ricevuto, quindi puoi normalizzare valute, convertire tipi, rinominare eventi o rimuovere parametri senza alcun deploy sul sito. L’unico limite è che non puoi creare dati che non ti sono mai arrivati: se il Data Layer non invia il transaction_id, nessuna trasformazione può inventarlo. In quel caso devi intervenire alla fonte.
Le trasformazioni nel container server fanno aumentare i costi di hosting?
Dipende dal tipo. Variabili con Lookup Table, conversioni di tipo e manipolazioni di stringhe hanno un impatto trascurabile sul tempo di esecuzione. Le chiamate esterne sincrone — Firestore, API del tuo gestionale — sono un’altra cosa: aggiungono latenza a ogni richiesta e, su volumi alti, si traducono in più tempo di calcolo fatturato. La regola pratica è limitare le chiamate esterne agli eventi rari e di valore, come il purchase, e mai alle page_view.
Devo applicare l'hash a email e telefono prima di inviarli a Google Ads?
Se usi il tag ufficiale Google Ads Conversion Tracking nel container server, puoi passare i valori in chiaro nei campi dedicati alle Enhanced Conversions: l’hashing SHA-256 viene gestito dal tag. Quello che devi fare tu è la normalizzazione preventiva — trim degli spazi, email in minuscolo, telefono in formato E.164. Se invece costruisci la chiamata manualmente, l’hash lo applichi tu, sempre dopo la normalizzazione e con output esadecimale minuscolo.
Il server-side permette di raccogliere dati senza consenso?
No, e chi lo afferma ti sta vendendo un rischio legale. Il GDPR si applica al trattamento dei dati personali, indipendentemente dal punto tecnico in cui avviene. Il server-side ti dà più controllo su cosa esce verso i fornitori terzi e ti permette di implementare il consenso in modo più rigoroso, ma se manca il consenso per finalità di marketing i tag pubblicitari non devono attivarsi. Consent Mode v2 va configurato anche lato server.