Come aggiungere un dominio personalizzato al contenitore del server di Google Tag Manager
In questo articolo, racconterò come configurare il sottodominio personalizzato all’interno del tuo contenitore del server di Google Tag Manager. Il beneficio principale del sottodominio personalizzato all’interno del contenitore del server di Google Tag Manager è che aiuta a bypassare gli Intelligent Tracking Prevention, gli AdBlocker e aumentare la durata dei cookie per gli utenti che navigano in Safari. I pixel saranno caricati dal tuo sottodominio e verranno eseguiti come le prime parti.
Perché dovresti usare il sottodominio personalizzato all’interno del contenitore del server di Google Tag Manager?
Il vantaggio essenziale del tagging lato server consiste nell'impostazione dei cookie di prima parte, anche se non è abilitato per impostazione predefinita. Per sfruttare questa funzionalità, è necessario implementare un dominio personalizzato nel GTM lato server.
Poiché Chrome è l'ultimo browser che supporta i cookie di terze parti e li eliminerà gradualmente all'inizio del 2025, è il momento di iniziare a utilizzare i cookie di prima parte anziché quelli di terze parti.
⚠️UPDATE: Google ha annunciato che non porterà avanti il suo piano di eliminazione graduale dei cookie di terze parti. Al contrario, l'azienda introdurrà una nuova soluzione: un messaggio unico che consentirà agli utenti di impostare le proprie preferenze, che saranno applicate a tutte le esperienze di navigazione di Google.
La stabilità e la longevità dei cookie impostati da sGTM dipendono da come viene implementato un dominio personalizzato. Esistono tre tipi di configurazioni di domini personalizzati in sGTM.
È possibile utilizzare un URL del server di tagging personalizzato per impostare i cookie di prima parte. L'URL del server di tagging personalizzato o il dominio personalizzato devono condividere lo stesso dominio del sito web. Ad esempio, se il dominio del vostro sito web è example.com, l'URL del server di tagging dovrebbe essere ss.example.com.
Esistono tre modi per impostare un dominio personalizzato:
- Stessa origine
- Sottodominio
- Dominio predefinito
Come aggiungere il sottodominio personalizzato all’interno del contenitore del server di Google Tag Manager?
Prima di tutto, devi creare e configurare un contenitore del server di Google Tag Manager. Se non hai un contenitore del server, segui queste istruzioni.
Mostreremo due modi per mappare un dominio personalizzato per il contenitore del server di Google Tag Manager:
- Utilizzando un sottodominio.
- Utilizzando la stessa origine.
Utilizzo di un sottodominio
Passo 1. Aggiungere il dominio personalizzato
Selezionate il vostro container in Stape, scorrete verso il basso e fate clic su Add custom domain.
Aggiungete il Subdomain name: può essere qualsiasi nome che preferite, ma assicuratevi di evitare termini specifici per la pubblicità o il tracciamento: ad, gtm, stgm, tracking, analytics, metrics, stape, gtag, ecc.
Passo 2. Aggiungere una CDN
Un Content Delivery Network (CDN) distribuisce le risorse del vostro sito web su una rete globale di server per ridurre la latenza e migliorare i tempi di caricamento per gli utenti in diverse aree geografiche. È utile se il vostro pubblico è distribuito geograficamente o se desiderate migliorare il tracciamento dei cookie e l'accuratezza dei dati.
Per impostazione predefinita, la CDN è disabilitata, il che significa che i file JavaScript (come gtm.js, gtag.js e analytics.js) vengono serviti direttamente dalla posizione del server in cui è ospitato il vostro container sGTM. In pratica, vengono escluse sia Stape Global CDN che Own CDN, stabilendo una connessione diretta e senza proxy tra il vostro sito e il container sGTM.
| Importante: si prega di considerare le normative sulla privacy del proprio paese prima di configurare una CDN. |
Per abilitare la CDN, fate clic sull'interruttore Add CDN e selezionate una delle seguenti opzioni:
- Stape Global CDN: carica gli script dal server più vicino alla posizione del visitatore del vostro sito web, riducendo la latenza e migliorando i tempi di caricamento delle pagine per i pubblici distribuiti geograficamente. Nel nostro setup utilizzeremo Stape Global CDN. Questa funzione è gratuita e disponibile per tutti i container sGTM di Stape.
- Own CDN (incompatibile con l'opzione di connessione Automatically (via Entri)): aiuta a instradare il dominio personalizzato sGTM e a fare da proxy per il traffico sGTM attraverso il provider DNS del vostro sito web. In questo caso, gli indirizzi IP del vostro sito web e del dominio personalizzato sGTM coincideranno, e i cookie lato server saranno considerati di prima parte. Di conseguenza, offre la possibilità di aumentare la durata dei cookie.
Passo 3. Selezionare il metodo di connessione
In seguito, nella sezione How to connect, esistono due modi per connettere un dominio personalizzato al vostro container:
- Automatically (via Entri)
Il modo più semplice per connettere i domini. Accedete con i dati del vostro provider DNS tramite Entri e concedete un'autorizzazione una tantum per connettere il vostro dominio. Dopodiché, potete procedere direttamente al Passo 5 per verificare il dominio; non è richiesta alcuna configurazione manuale.
- Manually
Con questa opzione, è necessario aggiungere manualmente i record DNS al provider di hosting per connettere il sottodominio a Stape.
Dopo aver aggiunto un sottodominio personalizzato al container, vedrete i record DNS che devono essere creati per verificare il dominio personalizzato. Il record DNS dipende dalla posizione del server e dall'opzione CDN scelta. Nel passo successivo viene illustrato come aggiungere i record DNS.
Passo 4. Aggiungere i record DNS (per il metodo di connessione manuale)
Per impostazione predefinita, la verifica del sottodominio viene eseguita con record CNAME, ma è possibile verificare il sottodominio anche con record A e AAAA se necessario (generalmente nei casi in cui è necessario evitare l'aggiunta di record duplicati).
Di seguito illustriamo entrambe le opzioni con una guida passo passo su come creare record utilizzando Cloudflare. È possibile utilizzare qualsiasi altro provider.
Aggiungere un dominio personalizzato con un record CNAME
È necessario creare un record CNAME se non si utilizza Stape Global CDN, e due record se la si utilizza.
1. Accedete al vostro servizio di nomi di dominio e create un nuovo record DNS per il sottodominio che desiderate utilizzare. Per farlo, fate clic sui tre punti e scegliete Configure DNS accanto al nome del dominio nella pagina principale dell'account.
2. Fate clic su Add record.
3. Tornate al vostro account Stape e inserite il record visualizzato nell'account. Assicuratevi che lo stato del proxy (Proxy status) sia disattivato (off).
Utilizziamo Stape Global CDN, quindi creiamo due record CNAME:
Aggiungere un sottodominio personalizzato con record A e AAAA
| Si noti che i record A/AAAA sono incompatibili con la CDN abilitata. |
1. Se è necessario verificare il sottodominio personalizzato utilizzando record A e AAAA, aggiungete il sottodominio personalizzato al container e assicuratevi che l'interruttore CDN sia disattivato (off).
Fate clic su Advanced settings e spuntate la casella Use A records instead of CNAME records. Vedrete i record DNS da aggiungere nel vostro container Stape. I record DNS da configurare variano in base alla posizione del server.
2. Accedete al vostro account DNS e aggiungete i record visualizzati nel vostro account Stape. Nella pagina principale dell'account, accanto al nome del dominio, fate clic sui tre punti e scegliete Configure DNS.
3. Fate clic su Add record.
4. Quindi create i record visualizzati nel vostro account Stape. Assicuratevi che lo stato del proxy (Proxy status) sia disattivato (off).
Prendete i valori per i vostri record DNS dall'account Stape:
Come risultato, otterrete due record DNS:
Passo 5. Verificare il dominio
Una volta inseriti i record DNS nel vostro provider DNS, tornate alla pagina del container Stape in cui avete configurato il dominio personalizzato e fate clic su Verify.
Attendete che Stape completi la verifica del vostro dominio personalizzato (quando la barra di stato del container cambia da Verifying a Ready). Di solito, la verifica del dominio personalizzato richiede 2-3 ore. Per alcuni provider DNS, la verifica dei record può richiedere fino a 72 ore. Vi invieremo un'e-mail una volta che il dominio personalizzato sarà verificato o qualora venga rilevato un errore.
Se riscontrate problemi con la verifica del dominio, seguite la nostra guida alla risoluzione dei problemi relativi al dominio personalizzato.
Passo 6. Aggiungere l'URL del server di tagging e aggiornare lo script del sito web
Accedete al vostro container server di Google Tag Manager → Admin → Container Settings → modificate Tagging server URL con il vostro sottodominio.
Aggiornare lo script
Se si utilizza un dominio personalizzato, è vivamente consigliato aggiornare lo script Web GTM sul vostro sito web. Questa modifica caricherà gtm.js dal vostro dominio. Per farlo, sostituite il dominio predefinito googletagmanager.com con il dominio personalizzato configurato nel passo precedente.
In alternativa, potete automatizzare questo processo con il Custom Loader power-up. Invece di modificare manualmente lo script GTM, Custom Loader genera uno snippet di codice pronto all'uso che carica gli script GTM e GA4 direttamente dal vostro dominio personalizzato. Questo fa risparmiare tempo, rende i vostri script di tracciamento più resistenti agli ad blocker e garantisce che tutti i cookie siano trattati come di prima parte.
Utilizzo della stessa origine
Prerequisiti
Prima di iniziare, assicurati di avere quanto segue:
- Un CDN o load balancer in grado di inoltrare le richieste, attraverso cui viene instradato tutto il traffico del tuo sito.
- Se utilizzi App Engine, il server di tagging deve eseguire la versione 2.2.0 o o successiva.
Nota:
Configurazione del dominio same-origin passo dopo passo
A seconda della tua infrastruttura, puoi configurare il dominio personalizzato same-origin utilizzando diverse piattaforme e servizi. Ecco le guide per ciascuno:
Nota:
Di seguito, illustreremo la configurazione utilizzando Cloudflare come esempio.
Affinché questa opzione funzioni, tutto il traffico del tuo sito deve essere instradato tramite proxy attraverso Cloudflare – la funzionalità Cloudflare Workers ti permetterà quindi di fare il proxy anche delle richieste sGTM. Dovresti anche usare SSL/TLS in modalità Full; altrimenti, il proxy same-origin potrebbe funzionare tramite un reindirizzamento 301, il che è scorretto.
Passaggio 1. Creare un Cloudflare Worker
Nella barra laterale sinistra, fai clic su Compute → Workers & Pages → fai clic su Create application → seleziona l'opzione Start with Hello World!.
Passaggio 2. Denominare e distribuire il worker
Aggiungi un nome worker → fai clic su Deploy.
Passaggio 3. Modificare il codice del worker
Scegli il path per il tuo dominio personalizzato sGTM – ad esempio, example.com/sgtm, example.com/data o example.com/metrics.
Nelle impostazioni del worker, fai clic su Edit code e incolla un JS simile all'esempio seguente, dove:
/metrics/è il path che hai scelto per il tuo contenitore server.https://sst.stapedesk.com/è l'URL del tuo server di tagging.
Per l'URL del server di tagging, hai due opzioni:
- [Non consigliato] L'URL predefinita del server di tagging fornita da Stape (ad es.,
https://wapdsrl.ca.stape.io). - [Consigliato] Il sottodominio personalizzato che hai configurato nel Stape admin. L'utilizzo di un sottodominio personalizzato offre due vantaggi: carica
gtm.jsegtag.jsda un path personalizzato tramite il Custom Loader power-up, rendendo i tracking script non bloccabili, e abilita i cookie first-party di lunga durata.
Se utilizzi un sottodominio personalizzato come URL del server di tagging same-origin, assicurati di aver aggiunto un dominio personalizzato al tuo contenitore sGTM su Stape e di aver creato i record DNS richiesti. Non utilizzare Own CDN con il dominio same-origin.
export default {
async fetch(request, env, ctx) {
let { pathname, search, host } = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sst.stapedesk.com';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
Distribuisci e salva le modifiche.
Passaggio 4. Aggiungere una route al worker
Vai al tuo worker sGTM → fai clic su Settings → Domains & Routes → crea una nuova Route. Aggiungi l'URL che usi per il server GTM terminando con * (nel nostro esempio è stapedesk.com/metrics*) e seleziona il tuo dominio nella selezione della zona.
Passaggio 5. Creare una regola di configurazione
Accanto al nome del tuo dominio, fai clic sui tre puntini → Configure Rules.
Fai clic su Create rule → Configuration Rules:
- Specifica un nome di regola comprensibile, ad es. sGTM same origin.
- Seleziona Custom filter expression.
- Il percorso URI inizia con
/metrics(aggiornalo se stai usando un path diverso). - SSL → seleziona l'opzione Full.
Fai clic su Deploy.
Passaggio 6. Creare una regola di trasformazione dell'intestazione della richiesta
Vai a Rules → Overview → Create Rule → Request Header Transform Rule:
- Inserisci un nome di regola descrittivo, ad es. sGTM header.
- Seleziona Custom filter expression.
- Il percorso URI inizia con /metrics (aggiornalo se stai usando un path diverso).
- Imposta un nome di intestazione statica
X-From-Cdncon il valorecf-stape.
Salva la regola.
Se non stai usando il tuo sottodominio e stai facendo il proxy delle richieste al sottodominio Stape standard, devi anche aggiungere l'X-Stape-Host intestazione.
Vai a Rules → Overview → Create Rule → Request Header Transform Rule:
- Inserisci un nome di regola descrittivo, ad es. sGTM same origin Stape host.
- Seleziona Custom filter expression.
- Il percorso URI inizia con
/metrics(aggiornalo se stai usando un path diverso). - Imposta un nome di intestazione statica
X-Stape-Hostcon il valore dell'host in cui si verificano gli eventi (nel nostro esempio è stape.work).
Salva la regola.
Passaggio 7. Aggiornare il Custom Loader
Una volta completata la configurazione same-origin, consigliamo anche di aggiornare il power-up Custom Loader per la protezione dagli ad blocker e di implementarlo sul tuo sito. Non dimenticare di specificare il tuo path Same Origin al suo interno.
Per ulteriori informazioni, consulta la nostra guida su Custom Loader.
Passaggio 8. Aggiungere l'URL del contenitore server nel GTM web e server
1. Nel tuo contenitore GTM web, aggiungi Google Tag e specifica il tuo Measurement ID (qualsiasi ID funziona per i test). Imposta il server_container_url sul path same-origin che hai configurato (nel nostro esempio èhttps://stapedesk.com/metrics).
2. Per semplificare i test, fai clic su Admin → Container Settings → inserisci il path sotto Server container URLs.
3. Per i test del dominio same-origin (come mostriamo nel passaggio seguente), dovrai anche configurare un Client (che trasmetterà i dati dal contenitore web al contenitore server) e il tag Google Analytics: GA4 nel contenitore GTM server.
Come Client, utilizzeremo GA4.
Per aggiungere il Client GA4 nel GTM server, apri la sezione clients → Create New client → Seleziona il tipo di client Google Analytics: GA4 (Web) → Aggiungi il nome del client e fai clic su Save.
Per configurare il tag GA4, aggiungi un nuovo tag con configurazione tag “Google Analytics: GA4” e specifica semplicemente il tuo Measurement ID nel tag.
Aggiungi il trigger per un tag. Deve attivarsi quando il nome del client riceve le richieste (nel nostro caso, il Client è GA4):
Test della configurazione Same Origin
Fai clic su Preview in entrambi i contenitori GTM, web e server.
Se tutto è configurato correttamente, il contenitore server dovrebbe aprirsi in anteprima al nuovo path che hai creato. Se, per qualche motivo, l'anteprima non si apre al nuovo path, puoi inserirlo manualmente nell'URL della finestra di anteprima.
- Nel DNS Records di Cloudflare, assicurati che le richieste al tuo dominio principale vengano instradate tramite proxy attraverso Cloudflare.
- In SSL/TLS, verifica che il modalità di crittografia sia impostato su Full. Se non lo è, fai clic su Configure, seleziona Full e fai clic su Save. Questa modifica può richiedere fino a 24 ore, quindi dagli il tempo necessario per aggiornarsi.
Visita il tuo sito web. Nell'anteprima del contenitore server, dovresti ora vedere una richiesta in entrata page_view proveniente dal dominio reale del tuo sito web.
Conclusione
L'aggiunta di un dominio personalizzato a un contenitore server di Google Tag Manager (GTM) può avere un impatto significativo sull'efficacia e sulla flessibilità del tracciamento lato server. In questo articolo abbiamo fornito due metodi di implementazione dei domini personalizzati.
L'approccio same-origin offre una maggiore sicurezza e una gestione dei cookie più semplice, ideale per domini singoli e mirati. Una configurazione a sottodomini offre flessibilità e ottimizzazione delle prestazioni, adatta a strutture di dominio complesse o multiple. Ognuno di essi presenta dei compromessi in termini di complessità, prestazioni e gestione. Considerate attentamente i vostri requisiti tecnici, le esigenze di sicurezza e gli obiettivi di tracciamento per scegliere la configurazione più appropriata per il vostro tracciamento lato server.
Per qualsiasi domanda, visitate il nostro helpdesk o scrivete un ticket. Il nostro team di esperti sarà lieto di aiutarvi a rispondere a qualsiasi domanda sull'hosting e sul tracciamento lato server di Stape.
Commenti