Attiva il comportamento dei tag per regioni specifiche

Questo articolo è rivolto agli sviluppatori che pubblicano 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.

Nota: se gtm.js o gtag.js viene pubblicato da www.googletagmanger.com, l'indirizzo IP e le informazioni sulla geolocalizzazione dell'utente vengono inclusi nella richiesta dello script, ma vengono utilizzate solo le informazioni sulla geolocalizzazione. Se l'indirizzo IP viene oscurato all'interno del contenitore del server, rimarrà oscurato, ma le informazioni su regione e paese verranno utilizzate per la modellazione. Per rimuoverle, puoi utilizzare la funzionalità di trasformazione.

Prima di iniziare

Questa guida presuppone che tu abbia eseguito le seguenti operazioni:

• 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 richieste 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 provider di infrastrutture diverso da quelli elencati di seguito. Devi configurare le intestazioni personalizzate.

Cloud Run con il bilanciatore del carico Google Cloud

Puoi inviare le informazioni sulla 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, ti consigliamo di includere le informazioni geografiche solo per le richieste di erogazione degli script Google. Questa opzione inizialmente richiede una configurazione più complessa, 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:

1. Apri il bilanciatore del carico della piattaforma Google Cloud
2. Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
   
3. 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, seleziona il gruppo di endpoint di rete della tua implementazione di Tag Manager lato server.
     
4. Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni delle richieste personalizzate.
   

   Nome intestazione	Valore dell'intestazione
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Salva il nuovo servizio di backend.

Per configurare le regole di routing:

1. Nel bilanciatore del carico, apri la sezione Regole di routing. Scegli la modalità Regola avanzata per host, percorso e route.
2. Aggiorna il parametro pathRules per mappare gtm.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

3. Salva le modifiche.

Tutte le richieste

Per inviare le 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 dell'intestazione
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Bilanciatore del carico Google Cloud

Puoi inviare le informazioni sulla 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, ti consigliamo di includere le informazioni geografiche solo per le richieste di erogazione degli script Google. Questa opzione inizialmente richiede una configurazione più complessa, 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:

1. Apri il bilanciatore del carico della piattaforma Google Cloud
2. Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
   
3. 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, seleziona il gruppo di endpoint di rete della tua implementazione di Tag Manager lato server.
     
4. Apri la sezione Configurazioni avanzate. Aggiungi le intestazioni delle richieste personalizzate.
   

   Nome intestazione	Valore dell'intestazione
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Salva il nuovo servizio di backend.

Per configurare le regole di routing:

1. Nel bilanciatore del carico, apri la sezione Regole di routing. Scegli la modalità Regola avanzata per host, percorso e route.
2. Aggiorna il parametro pathRules per mappare gtm.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

3. Salva le modifiche.

Tutte le richieste

Per inviare le 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 dell'intestazione
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Amazon Web Services (AWS) CloudFront

Crea una policy di richiesta 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 con i 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 set di regole con l' azione modifica intestazione della richiesta con il seguente mapping:

Nome intestazione	Valore dell'intestazione
X-Azure-Country	{geo_country}

Cloudflare

Attiva l'opzione "Aggiungi intestazioni posizione visitatore" nella sezione trasformazioni gestite:

In questo modo, verrà aggiunta automaticamente la seguente intestazione con il relativo valore:

Nome intestazione	Valore dell'intestazione
CF-IPCountry	Il paese dell'utente

Passaggio 2: configura la variabile Regione del 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 le intestazioni personalizzate.

Rilevamento automatico

1. Apri Google Tag Manager
2. Apri il contenitore del server.
3. Nel menu Variabili, configura l'elenco delle variabili integrate.
4. Seleziona Regione del visitatore.

Le intestazioni geografiche saranno ora disponibili per l'utilizzo nella variabile Regione del visitatore.

Intestazioni personalizzate

1. Apri Google Tag Manager
2. Apri il contenitore del server.
3. Nel menu Variabili, crea una nuova variabile definita dall'utente di tipo Regione del visitatore.
4. In Configurazione variabile, scegli Variabile personalizzata.

5. Nel menu Variabili, crea due nuove variabili Intestazione della richiesta: una per il paese e una per il codice di suddivisione. Inserisci i codici paese nelle intestazioni delle richieste HTTP.

   Nota: il formato deve essere conforme a ISO-3166-2.

6. Utilizza le variabili create nella variabile Regione del visitatore come mostrato nello screenshot.

   

7. Assegna un nome alla variabile e salvala.

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.

1. Seleziona il client Google Tag Manager: contenitore web.

2. Seleziona Attiva le impostazioni specifiche per la regione. Aggiungi la {{Regione del visitatore}} variabile che hai creato nel passaggio precedente al campo Regione.

3. Salva il client.

Passaggio 4: verifica che le impostazioni della regione siano applicate

Per verificare se le impostazioni funzionano:

1. Apri la modalità di anteprima per il contenitore del server.
2. Carica il tuo sito web utilizzando la pubblicazione proprietaria.
3. Nella finestra di anteprima, fai clic sul client Google Analytics GA4 rivendicato.
4. Per visualizzare la regione effettiva, imposta il pulsante di opzione Visualizza variabili su valori.
   • ✅ L'implementazione è corretta se la proprietà Regione mostra un codice paese.
   • ❌ Se la proprietà Regione mostra undefined o non è presente, il server non riceve dati sulla regione. Verifica se le intestazioni HTTP del server sono configurate in base alle variabili predefinite che Google Tag Manager sta cercando. Consulta Configura l'intestazione della richiesta.

Passaggi successivi

• Configurare la modalità di consenso per una regione specifica in un contenitore web