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
I prerequisiti per configurare lo stesso dominio personalizzato di origine:
1. Un CDN o un bilanciatore di carico in grado di inoltrare le richieste.
2. Se si utilizza App Engine, il server di tagging deve eseguire la versione 2.2.0 o successiva.
3. Selezionare il percorso del dominio personalizzato sGTM, ad esempio example.com/sgtm, example.com/data, example.com/metrics, ecc.
Vi mostreremo 2 esempi di configurazione dello stesso dominio personalizzato di origine per sGTM utilizzando Cloudflare o nginx.
1. Cloudflare
Affinché questa opzione funzioni, tutto il traffico del sito deve essere proxato attraverso CloudFlare. Pertanto, la funzionalità di CF Workers consentirà di proxyare anche le richieste di sGTM.
a. Creare un worker in Cloudflare.
b. Aggiungere il nome del lavoratore.
c. Creare un js simile a quello sottostante, dove:
/metrics/ - è il percorso scelto per il contenitore del server.
https://sgtm.stape.video/ - è l'URL del server di tagging. Esistono due scenari:
- [L'URL del server di tagging predefinito, fornito da stape. In questo caso, l'URL del server di tagging avrà l'aspetto di https://wapdsrl.ca.stape.io.
- [Il sottodominio personalizzato che avete impostato nell'amministrazione di stape.io. L'uso di un sottodominio personalizzato quando si configura un worker è consigliato perché offre due vantaggi: il caricamento di gtm.js e gtag.js da un percorso personalizzato tramite l'attivazione del Custom Loader, che rende gli script di tracciamento non bloccabili e consente l'impostazione di cookie di prima parte a lunga durata. Se si utilizza un sottodominio personalizzato per l'URL del server di tagging della stessa origine, assicurarsi di aver aggiunto un dominio personalizzato al contenitore sGTM su stape e di aver creato i record DNS come descritto qui. Non utilizzare Own CDN con lo stesso dominio di origine.
export default {
async fetch(request, env, ctx) {
let {pathname, search, host} = new URL(request.url);
pathname = pathname.replace('/metrics/', '/');
const domain = 'sgtm.stape.video';
let newRequest = new Request((`https://` + domain + pathname + search), request);
newRequest.headers.set('Host', domain);
return fetch(newRequest);
},
};
d. Andare alla Rotta dei lavoratori e creare una nuova rotta. Aggiungere l'URL utilizzato per il server GTM che termina con *. Nel mio caso, è stape.video/metrics* e selezionare il lavoratore creato nei passaggi precedenti.
2. nginx
Aggiungere alla configurazione del server, dove:
/metrics - percorso selezionato per il server GTM.
https://gtm.mysimple.name - dominio personalizzato del vostro GTM.
location = /metrics { return 302 /metrics/; }
location ~ ^/metrics(.*) {
resolver 8.8.8.8 valid=3600s;
proxy_pass https://gtm.mysimple.name$1$is_args$args;
proxy_set_header Host gtm.mysimple.name;
proxy_set_header X-From-Cdn "cf-stape";
proxy_set_header CF-Connecting-Ip $remote_addr; #If you do not use Cloudflare for your domain
#proxy_set_header CF-Connecting-Ip $http_cf_connecting_ip; #If you use Cloudflare for your domain
}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.
Avete problemi con l'aggiunta di un dominio personalizzato?
Bastano alcune semplici domande. Fate clic su Chiedere aiuto, compilate il modulo e vi guideremo.
Commenti