Questo articolo è rivolto agli sviluppatori che pubblicano gli script Google dal proprio server. Ti consigliamo di attivare per i tag un comportamento specifico per regione al fine di sbloccare funzionalità quali la modalità di consenso avanzata e controllare il comportamento dei tag in base alla località degli utenti.
Prima di iniziare
Questa guida presuppone che tu abbia:
- Configurare un contenitore del server in Tag Manager
- Configurare un server di tagging
- Configurare la pubblicazione di script proprietari
Passaggio 1: configura l'intestazione della richiesta
Devi inviare intestazioni della richiesta specifiche contenenti le informazioni sulla regione dell'utente, come descritto nelle sezioni di seguito.
Puoi iniziare direttamente dal passaggio 2 se:
- Utilizzi App Engine. App Engine invia automaticamente le intestazioni geografiche.
- Utilizzi un provider di infrastruttura diverso da quelli elencati di seguito. Devi configurare le intestazioni personalizzate.
Cloud Run con il bilanciatore del carico Google Cloud
Puoi inviare informazioni di geolocalizzazione con tutte le intestazioni delle richieste HTTP o per richieste specifiche. Poiché l'aggiunta di intestazioni delle richieste personalizzate comporterà una tariffa per ogni milione di richieste, consigliamo di includere solo i dati geografici per le richieste di pubblicazione degli script Google. Questa opzione inizialmente richiede una maggiore configurazione, ma consente di gestire l'infrastruttura nel modo più economico possibile.
Richieste di script
Per includere le intestazioni geografiche solo per le richieste di script, devi configurare un nuovo backend e creare regole di routing.
Per creare un nuovo backend:
- Apri il bilanciatore del carico Google Cloud
- Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
- Configura il nuovo servizio di backend:
- Tipo di backend: scegli il tipo di gruppo di endpoint di rete utilizzato dall'applicazione. Se utilizzi Cloud Run, scegli Gruppo di endpoint di rete serverless.
- In Nuovo backend, scegli il gruppo di endpoint di rete dell'implementazione di Tag Manager lato server.
- Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni
delle richieste personalizzate.
Nome intestazione Valore intestazione X-Gclb-Country {client_region} Regione X-Gclb {client_region_subdivision} - Salva il nuovo servizio di backend.
Per configurare le regole di routing:
- Nel bilanciatore del carico, apri la sezione Regole di routing. Scegli la modalità Percorso host e regola avanzata.
- Aggiorna il parametro
pathRules
per mapparegtm.js
,/gtag/js
e/gtag/destination
al nuovo servizio di backend.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Salva le modifiche.
Tutte le richieste
Per inviare informazioni di geolocalizzazione con tutte le richieste HTTP, devi aggiungere intestazioni delle richieste personalizzate al servizio di backend esistente. Consulta la documentazione di Google Cloud. Crea una nuova intestazione della richiesta personalizzata per ogni intestazione seguente:
Nome intestazione | Valore intestazione |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
Bilanciatore del carico Google Cloud
Puoi inviare informazioni di geolocalizzazione con tutte le intestazioni delle richieste HTTP o per richieste specifiche. Poiché l'aggiunta di intestazioni delle richieste personalizzate comporterà una tariffa per ogni milione di richieste, consigliamo di includere solo i dati geografici per le richieste di pubblicazione degli script Google. Questa opzione inizialmente richiede una maggiore configurazione, ma consente di gestire l'infrastruttura nel modo più economico possibile.
Richieste di script
Per includere le intestazioni geografiche solo per le richieste di script, devi configurare un nuovo backend e creare regole di routing.
Per creare un nuovo backend:
- Apri il bilanciatore del carico Google Cloud
- Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
- Configura il nuovo servizio di backend:
- Tipo di backend: scegli il tipo di gruppo di endpoint di rete utilizzato dall'applicazione. Se utilizzi Cloud Run, scegli Gruppo di endpoint di rete serverless.
- In Nuovo backend, scegli il gruppo di endpoint di rete dell'implementazione di Tag Manager lato server.
- Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni
delle richieste personalizzate.
Nome intestazione Valore intestazione X-Gclb-Country {client_region} Regione X-Gclb {client_region_subdivision} - Salva il nuovo servizio di backend.
Per configurare le regole di routing:
- Nel bilanciatore del carico, apri la sezione Regole di routing. Scegli la modalità Percorso host e regola avanzata.
- Aggiorna il parametro
pathRules
per mapparegtm.js
,/gtag/js
e/gtag/destination
al nuovo servizio di backend.
pathRules: - paths: - /gtm.js - /gtag* service: projects/project_id/global/backendServices/new backend service - paths: - /* service: projects/project_id/global/backendServices/original backend service
- Salva le modifiche.
Tutte le richieste
Per inviare informazioni di geolocalizzazione con tutte le richieste HTTP, devi aggiungere intestazioni delle richieste personalizzate al servizio di backend esistente. Consulta la documentazione di Google Cloud. Crea una nuova intestazione della richiesta personalizzata per ogni intestazione seguente:
Nome intestazione | Valore intestazione |
---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
Amazon Web Services (AWS) CloudFront
Crea un criterio di richiesta dell'origine per aggiungere le intestazioni CloudFront-Viewer-Country
e CloudFront-Viewer-Country-Region
alla richiesta.
In questo modo verranno aggiunte automaticamente le seguenti intestazioni insieme ai relativi valori:
Nome intestazione | Valore intestazione |
---|---|
CloudFront-Viewer-Paese | Il paese dell'utente |
CloudFront-Viewer-Country-Region | La suddivisione dell'utente |
![Impostazioni intestazione in AWS CloudFront](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/aws-headers.png?authuser=19&hl=it)
Porta principale Azure
Utilizzando il motore regole, crea un set di regole con l'azione modifica intestazione della richiesta con la seguente mappatura:
Nome intestazione | Valore intestazione |
---|---|
X-Azure-Country | {geo_country} |
![Screenshot della configurazione Frontdoor di Azure](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/azure-headers.png?authuser=19&hl=it)
Cloudflare
Attiva "Aggiungi intestazioni località visitatore" nella sezione Trasformazioni gestite:
Verrà aggiunta automaticamente la seguente intestazione insieme al relativo valore:
Nome intestazione | Valore intestazione |
---|---|
CF-IPCountry | Il paese dell'utente |
![Screenshot della configurazione cloudflare](https://developers.google.cn/static/tag-platform/tag-manager/server-side/img/cloudflare-headers.png?authuser=19&hl=it)
Passaggio 2. Configura la variabile Regione visitatore
Se hai impostato le intestazioni geografiche come specificato sopra, Tag Manager rileva automaticamente la regione o il paese leggendo l'intestazione della richiesta HTTP. In alternativa, puoi impostare intestazioni personalizzate.
Rilevamento automatico
- Apri Google Tag Manager
- Apri il contenitore del server.
- Nel menu Variabili, Configura l'elenco di variabili integrate.
- Seleziona Regione visitatore.
Ora le intestazioni geografiche potranno essere utilizzate nella variabile Regione visitatore.
Intestazioni personalizzate
- Apri Google Tag Manager
- Apri il contenitore del server.
- Nel menu Variabili, crea una Nuova variabile definita dall'utente di tipo Regione visitatore.
- In Configurazione variabile, scegli Variabile personalizzata.
Nel menu Variabili, crea due nuove variabili Intestazione richiesta: una per il paese e una per il codice di suddivisione. Inserisci i valori con i codici paese nelle intestazioni delle richieste HTTP.
Utilizza le variabili create nella variabile Regione visitatore, come mostrato nello screenshot.
Assegna un nome alla variabile e fai clic su Salva.
Passaggio 3: attiva le impostazioni specifiche per regione nel client
Per utilizzare la regione del visitatore per l'elaborazione delle richieste HTTP in entrata, devi aggiungerla al client.
Seleziona il client o creane uno nuovo a cui vuoi applicare l'impostazione della regione. I client supportati sono:
- Google Tag Manager: contenitore web
- Google Analytics: GA4
- Google Analytics: Universal Analytics
Se stai configurando i client GA4 o UA, seleziona la casella Percorsi gtag.js predefiniti per ID specifici e inserisci l'ID misurazione del tuo contenitore web.
Seleziona Attiva impostazioni specifiche per la regione. Aggiungi al campo Regione la variabile {{ Visitor Region}} creata nel passaggio precedente.
Salva il cliente.
Passaggio 4: verifica che le impostazioni della regione vengano applicate
Per verificare se le impostazioni funzionano:
- Apri la modalità di anteprima per il contenitore del server.
- Carica il tuo sito web mentre utilizzi la pubblicazione proprietaria.
- Nella finestra di anteprima, fai clic sul client Google Analytics GA4 o Universal Analytics rivendicato.
- Per visualizzare la regione effettiva, imposta il pulsante di opzione Visualizza variabili sui valori.
- ✅ La tua implementazione è corretta se la proprietà Region mostra un codice paese.
- ❌ Se la proprietà Region mostra
undefined
o non è presente, il server non riceve dati sulla regione. Verifica che le intestazioni HTTP del server siano configurate in base alle variabili predefinite cercate da Google Tag Manager. Consulta Configurare l'intestazione della richiesta.