Come creare un container server-side GTM e inviare eventi GA4 dal web container al server container
Segui questa procedura per creare un container server-side GTM e inviare eventi GA4 dal web container al server container. Parti dal primo passaggio, cioe crea o apri il server container, poi completa la configurazione e chiudi il lavoro solo dopo il test finale.
Il controllo principale e richiesta arriva al server. Se questo punto non torna, la configurazione non va considerata completata.
Prerequisiti. Servono container web, container server, ambiente server-side attivo, dominio o endpoint di tagging e property GA4.
- server container creato
- endpoint raggiungibile
- client GA4 attivo
- tag GA4 server configurato
- transport_url nel web container
Prepara una pagina o un percorso su cui ripetere la prova dall inizio alla fine. Se il test riguarda una conversione, usa una conversione di prova e annota ora, pagina e azione eseguita.
Passaggi da eseguire. Mantieni aperto il debug durante la configurazione e conferma ogni punto prima di pubblicare.
Passo 1: crea o apri il server container
Apri GA4 > Amministrazione e GTM > Area di lavoro e confronta property GA4, Data stream web e container GTM del sito prima di fare modifiche: se parti da account, property, stream, dataset o container sbagliato, il test non vale.
Clicca sul selettore principale, apri la voce corretta e confronta dominio, nome property, ID stream o container con il sito da misurare. Se uno di questi dati non coincide, fermati e cambia risorsa.
A questo punto devi avere la risorsa giusta aperta, i permessi necessari e la schermata da cui prenderai i valori gia identificata.
Se account, property o container non sono quelli corretti, torna al selettore principale e cambiali prima di modificare qualsiasi cosa.
Passo 2: configura il client GA4
Entra in GTM Workspace > Tags > New > Tag Configuration > Google Analytics: GA4 Event, poi riquadro Triggering e crea o modifica evento GA4, parametri, stream web e report, usando un nome che descriva azione, strumento e pagina coinvolta.
Clicca il pulsante di creazione o modifica, scegli il tipo richiesto dalla guida, apri il riquadro di configurazione e collega il trigger, l evento o la regola che deve far partire il dato.
Il risultato da ottenere e una configurazione salvata, leggibile e agganciata alla condizione che deve far partire evento GA4, parametri, stream web e report.
Se il trigger o la regola e troppo generica, apri la condizione e restringila a URL, evento dataLayer, consenso, form riuscito, checkout o acquisto completato.
Passo 3: imposta transport_url nel tag GA4 web
Compila Measurement ID dello stream web, Event Name, Event Parameters, User Properties se servono e trigger evento o pagina copiando i valori da GA4 Admin > Data streams > Web stream e schema eventi/parametri della guida. Non accorciare ID, label o nomi evento e non cambiare mai formato mentre li incolli.
Clicca dentro ogni campo obbligatorio, incolla il valore esatto, rileggilo nel riepilogo e usa Salva solo quando ogni campo ha una provenienza chiara.
Quando rileggi il riepilogo, nessun campo obbligatorio deve essere vuoto: il controllo minimo e vedere Measurement ID dello stream web, Event Name, Event Parameters, User Properties se servono e trigger evento o pagina nel posto corretto.
Se un valore non torna, non riscriverlo a memoria: riapri il tag GA4 Event, correggi Measurement ID, Event Name o parametro, salva e rilancia Preview.
Passo 4: crea tag GA4 nel server container
Apri GTM Preview > Connect, evento nella timeline e GA4 Admin > DebugView, completa l azione richiesta sulla pagina di test e segui la sequenza finche vedi cosa parte, quando parte e con quali parametri.
Clicca il pulsante di anteprima o test, inserisci l URL della pagina se richiesto, conferma con Connect o Avvia test e poi esegui una sola volta l azione utente prevista.
Nel debug devi vedere evento presente in DebugView con parametri leggibili e senza duplicati; se vedi solo un tag attivo ma mancano parametri o momento corretto, il test non e chiuso.
Se non compare nulla nel debug, controlla prima collegamento Preview/Connect, poi trigger, consenso e pagina usata per generare il test.
Passo 5: testa evento web e ricezione server
Apri GA4 > Report o Esplora e usa GA4 DebugView, Event name, parametro pagina, device e minuto del test per isolare il test appena fatto, invece di cercarlo dentro tutto il traffico della giornata.
Clicca sul report o pannello finale, applica il filtro piu stretto disponibile e verifica che il dato compaia una sola volta con ora, pagina o nome evento coerenti.
Nel report finale devi ritrovare il test con GA4 DebugView, Event name, parametro pagina, device e minuto del test, oppure riconoscere chiaramente che lo strumento richiede qualche minuto di elaborazione.
Se il dato non arriva nel report, ripeti il test annotando ora, pagina e azione; poi controlla ritardi di elaborazione, filtro sbagliato o property non corretta.
Il browser deve inviare al server container, non direttamente solo a GA4, quando vuoi usare il percorso server-side.
Debug e validazione. Usa preview del web container e del server container insieme: il primo mostra invio, il secondo ricezione e inoltro.
- richiesta arriva al server: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- client GA4 reclama evento: confronta il valore atteso con quello ricevuto. Se non coincidono, correggi prima di pubblicare.
- tag server parte: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
- parametri principali restano presenti: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
- nessun doppio invio involontario: controlla che sia presente nel momento corretto. Se arriva in ritardo, duplicato o vuoto, riapri trigger e parametri.
Errori frequenti e come risolverli
Se il tag o l evento non compare nel debug, di solito la preview non e collegata alla pagina giusta, il trigger e troppo stretto oppure il consenso non si aggiorna. Riapri GA4 DebugView e GTM Preview, ricollega la pagina e ripeti il test.
Se il dato compare due volte, controlla se hai un doppio tag, un doppio percorso browser/server o un reload della pagina finale. Disattiva il duplicato, ripeti l azione e verifica che nel report resti un solo invio.
Se il report finale resta vuoto, ricontrolla ID, label, stream, dataset o property. Copia di nuovo i valori dalla piattaforma sorgente, salva e ripeti il test annotando ora, URL e azione eseguita.
Se trovi un errore, correggi una sola impostazione alla volta e ripeti il test. In questo modo puoi capire quale modifica ha risolto il problema.
Checklist finale prima di considerare chiuso il lavoro.
- endpoint stabile
- debug web ok
- debug server ok
- GA4 riceve evento
- documentazione modifiche
Prima di usare la configurazione su traffico reale, salva uno screenshot del debug e uno del report in cui il test risulta visibile.
Lunedì – Sabato : 9:30 am – 21:00 pm
Lunedì – Sabato : 9:30 am – 21:00 pm
Studierò la strategia più adeguata per le tue esigenze e insieme al mio staff individueremo la Buyer Personas migliore per trasformare il tuo processo commerciale offline nella più efficace macchina di vendita online, e la strategia di comunicazione più convincente per convincere il pubblico che il tuo prodotto è quello che stanno cercando, anche se costa di più della concorrenza.
Lunedì – Sabato : 9:30 am – 21:00 pm
