Questo articolo è rivolto agli sviluppatori che pubblicano gli script Google dal proprio server. Ti consigliamo di attivare il comportamento specifico per regione per i tag per sbloccare funzionalità come la modalità di consenso avanzata e per controllare il comportamento dei tag in base alla posizione degli utenti.
Se pubblichi uno script da un dominio proprietario, devi fornire le informazioni sulla geolocalizzazione dell'utente
nell'intestazione della richiesta per poter utilizzare i parametri event_location.country e
event_location.region. Se disponibile nell'intestazione della richiesta, l'indirizzo IP ha la precedenza nella determinazione della geolocalizzazione. In caso contrario, i parametri
event_location.country e event_location.region vengono utilizzati per
inviare rispettivamente le informazioni su paese e regione.
Prima di iniziare
Questa guida presuppone che tu abbia eseguito quanto segue:
- 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 di richiesta specifiche che contengano le informazioni sulla regione dell'utente, come descritto nelle sezioni seguenti.
Puoi iniziare direttamente dal passaggio 2 se:
- Utilizzi App Engine. App Engine invia automaticamente le intestazioni geografiche.
- Utilizzi un fornitore di infrastrutture diverso da quelli elencati di seguito. Devi configurare le intestazioni personalizzate.
Cloud Run con bilanciatore del carico GCP
Puoi inviare informazioni sulla geolocalizzazione con tutte le intestazioni delle richieste HTTP o per richieste specifiche. Poiché l'aggiunta di intestazioni delle richieste personalizzate comporta una tariffa per ogni milione di richieste, ti consigliamo di includere informazioni geografiche solo per le richieste di pubblicazione degli script Google. Questa opzione inizialmente richiede più configurazione, ma ti aiuta a 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 GCP
- 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 dalla tua applicazione. Se utilizzi Cloud Run, scegli Gruppo di endpoint di rete serverless.
- In Nuovo backend, scegli il gruppo di endpoint di rete del tuo
deployment di Tag Manager lato server.
- Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni
della richiesta personalizzata.
Nome intestazione Valore dell'intestazione X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Salva il nuovo servizio di backend.
Per configurare le regole di routing:
- Nel bilanciamento del carico, apri la sezione Regole di routing. Scegli la modalità Regola avanzata per host, percorso e route.
- Aggiorna il parametro
pathRulesper mapparegtm.js,/gtag/jse/gtag/destinational 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 sulla 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 riportata di seguito:
| Nome intestazione | Valore intestazione |
|---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
Bilanciatore del carico GCP
Puoi inviare informazioni sulla geolocalizzazione con tutte le intestazioni delle richieste HTTP o per richieste specifiche. Poiché l'aggiunta di intestazioni delle richieste personalizzate comporta una tariffa per ogni milione di richieste, ti consigliamo di includere informazioni geografiche solo per le richieste di pubblicazione degli script Google. Questa opzione inizialmente richiede più configurazione, ma ti aiuta a 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 GCP
- 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 dalla tua applicazione. Se utilizzi Cloud Run, scegli Gruppo di endpoint di rete serverless.
- In Nuovo backend, scegli il gruppo di endpoint di rete del tuo
deployment di Tag Manager lato server.
- Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni
della richiesta personalizzata.
Nome intestazione Valore dell'intestazione X-Gclb-Country {client_region} X-Gclb-Region {client_region_subdivision} - Salva il nuovo servizio di backend.
Per configurare le regole di routing:
- Nel bilanciamento del carico, apri la sezione Regole di routing. Scegli la modalità Regola avanzata per host, percorso e route.
- Aggiorna il parametro
pathRulesper mapparegtm.js,/gtag/jse/gtag/destinational 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 sulla 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 riportata di seguito:
| Nome intestazione | Valore intestazione |
|---|---|
X-Gclb-Country |
{client_region} |
X-Gclb-Country |
{client_region_subdivision} |
Amazon Web Services (AWS) CloudFront
Crea una policy delle richieste di 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 dell'intestazione |
|---|---|
| CloudFront-Viewer-Country | Il paese dell'utente |
| CloudFront-Viewer-Country-Region | La suddivisione dell'utente |
Azure Front Door
Utilizzando il motore delle regole, crea un insieme di regole con l'azione modifica l'intestazione della richiesta con il seguente mapping:
| Nome intestazione | Valore dell'intestazione |
|---|---|
| X-Azure-Country | {geo_country} |
Cloudflare
Attiva l'opzione "Aggiungi intestazioni della posizione dei visitatori" nella sezione delle trasformazioni gestite:
In questo modo verrà aggiunta automaticamente la seguente intestazione insieme al relativo valore:
| Nome intestazione | Valore dell'intestazione |
|---|---|
| CF-IPCountry | Il paese dell'utente |
Passaggio 2: configura la variabile Regione visitatore
Se hai configurato le intestazioni geografiche come specificato sopra, Tag Manager rileva automaticamente la regione o il paese leggendo l'intestazione della richiesta HTTP. In alternativa, puoi configurare intestazioni personalizzate.
Rilevamento automatico
- Apri Google Tag Manager
- Apri il contenitore del server.
- Nel menu Variabili, configura l'elenco delle variabili integrate.
- Seleziona Regione visitatore.
Le intestazioni geografiche saranno ora disponibili per l'utilizzo 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 della richiesta: una per il paese e una per il codice di suddivisione. Compila i valori con i codici paese nelle intestazioni delle richieste HTTP.
Utilizza le variabili che hai creato 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 la regione nel client
Per utilizzare la regione del visitatore per l'elaborazione delle richieste HTTP in entrata, devi aggiungerla al client.
Seleziona il client Google Tag Manager: contenitore web.
Seleziona Attiva le impostazioni specifiche per la regione. Aggiungi la variabile {{Visitor Region}} che hai creato nel passaggio precedente al campo Regione.
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 durante l'utilizzo della pubblicazione proprietaria.
- Nella finestra di anteprima, fai clic sul client rivendicato Google Analytics GA4.
- Per visualizzare la regione effettiva, imposta il pulsante di opzione Visualizza variabili sui valori.
- ✅ L'implementazione è corretta se la proprietà Regione mostra un codice paese.
- ❌ Se la proprietà Region mostra
undefinedo è mancante, il tuo server non riceve dati sulle regioni. Verifica che le intestazioni HTTP del server siano configurate in base alle variabili predefinite che Google Tag Manager sta cercando. Consulta Configurare l'intestazione della richiesta.