Questo articolo è rivolto agli sviluppatori che vogliono ospitare il tagging lato server nello stesso contesto proprietario del loro sito web. La gestione della stessa origine è una best practice che ti consente di sfruttare i vantaggi dei cookie impostati dal server in termini di sicurezza e durabilità. Le istruzioni riportate di seguito si applicano alla configurazione della pubblicazione di annunci con lo stesso origin, indipendentemente dal tag Google implementato sul tuo sito (gtag.js o gtm.js).
Quando configuri per la prima volta un server di tagging, questo viene ospitato su un dominio fornito dal fornitore cloud. Quando utilizzi l'endpoint predefinito, i dati vengono inviati al contenitore del server, ma vengono eseguiti in un contesto di terze parti. Per usufruire dei vantaggi di un contesto proprietario, come cookie più duraturi, il server di tagging e il sito web devono essere eseguiti nello stesso dominio.
La tabella seguente illustra come puoi ospitare un server di tagging quando il sito web principale è ospitato su www.example.com:
| Stessa origine (best practice) | Sottodominio | Dominio predefinito | |
|---|---|---|---|
| URL di esempio | https://www.example.com/metrics |
https://metrics.example.com |
https://metrics.run.app |
| Accesso ai cookie impostati dal server | Accesso completo ai vantaggi di sicurezza e durata. | Accesso completo ai vantaggi di sicurezza e durata. | Nessuna. Può impostare solo cookie JavaScript. |
| Complessità di configurazione | Configura una CDN o un bilanciatore del carico per inoltrare le richieste. Potrebbe essere necessario aggiornare le voci DNS. | Aggiorna le voci DNS. | È preconfigurato. |
Per iniziare, scegli l'opzione di implementazione.
Prerequisiti
Questa guida presuppone che tu abbia:
- Configurare un contenitore del server in Tag Manager
- Configura un server di tagging
- Una CDN o un bilanciatore del carico in grado di inoltrare le richieste.
- Se utilizzi App Engine: il server di tagging deve eseguire la versione 2.2.0 o successive. Per garantire la compatibilità futura del tuo server di tagging, esegui la migrazione a Cloud Run.
Configura il dominio personalizzato
Puoi configurare il contenitore del server in modo che venga eseguito su un percorso dello stesso dominio del tuo sito web. Ad esempio, se il tuo sito invia traffico web a
www.example.com, riserva un percorso come www.example.com/metrics per il
contenutore del server.
1. Scegli un percorso del tuo dominio da utilizzare per il server di tagging
Questo percorso sarà riservato a questa implementazione di pubblicazione proprietaria. Assicurati di scegliere un percorso che non utilizzi già.
Ecco alcuni esempi di percorsi che potresti utilizzare: /collect, /metrics,
/data
Prendi nota di questa stringa di percorso. Lo utilizzerai in tutti i passaggi successivi
al posto di /metrics ovunque vedi: /metrics
2. Indirizza il traffico al server di tagging
Se il tuo sito web è già configurato con una rete CDN o un bilanciatore del carico che supporta il routing del traffico per percorsi, vai al passaggio 4.
- Aggiungi un'origine o un backend che rimandi al tuo sito web.
- Sostituisci l'intestazione Host in modo che corrisponda al nome host del sito web, ad esempio
example.com - Consenti l'inoltro di tutti i cookie e le stringhe di query. Se nella piattaforma non è disponibile questa opzione, è probabile che l'inoltro avvenga per impostazione predefinita.
- Aggiungi un'altra origine o un altro backend che rimandi al server di tagging. Può trattarsi del dominio fornito dal provider cloud, ad esempio
metrics.run.app - Sostituisci l'intestazione Host in modo che corrisponda al dominio specificato sopra. Consenti l'inoltro di tutti i cookie e le stringhe di query.
- Aggiungi una regola di percorso, ad esempio
/metrics/*, per instradare il traffico al server di tagging. - Configura il percorso di tagging lato server riservato in modo che abbia una priorità maggiore rispetto alla regola predefinita.
- Se non lo hai già fatto, aggiorna il DNS in modo che punti alla CDN o al bilanciatore del carico. La propagazione degli aggiornamenti del DNS potrebbe richiedere tempo.
- Vai all'endpoint
/healthynel dominio che hai appena configurato, ad esempiohttps://example.com/metrics/healthy. Dovresti visualizzare unok.
3. Aggiornare l'URL del server in Google Tag Manager
Devi aggiornare la configurazione del contenitore del server in modo che possa identificare il prefisso del percorso ed elaborare correttamente le richieste.
Per eseguire l'aggiornamento al nuovo endpoint:
- Apri Google Tag Manager
- Apri il contenitore del server configurato sulla stessa origine del sito web.
- Nella scheda Amministrazione > Impostazioni contenitore, rimuovi tutti gli URL precedenti. Questo è necessario perché tutti gli URL dei contenitori dei server devono condividere lo stesso percorso.
- Fai clic su Aggiungi URL e inserisci l'URL, incluso il prefisso del percorso.
- Salva e torna alla tua area di lavoro.
- Fai clic sul pulsante Anteprima per avviare una nuova sessione di debug e inviare una richiesta in una scheda separata.
- Fai clic sulla richiesta inviata. Assicurati che il cliente abbia rivendicato la richiesta in arrivo.
Risolvere i problemi comuni
- L'anteprima non mostra le richieste in entrata
- Vai all'esplora log del tuo progetto cloud. Verifica che il deployment del tagging lato server riceva traffico. In caso contrario, segui le istruzioni riportate nel passaggio 1.
- Verifica che la CDN o il bilanciatore del carico inoltri i cookie.
- Verifica di avere un unico server di anteprima e che i server di tagging abbiano impostato
PREVIEW_SERVER_URL. - Verifica che il server di anteprima sia in esecuzione andando a
PREVIEW_SERVER_URL+/healthy. Dovresti visualizzare unok.
- I client non rivendicano le richieste: aggiorna l'URL in Impostazioni contenitore per utilizzare il percorso riservato. Se l'URL non contiene il percorso o se sono diversi, i client non funzioneranno correttamente.