Attiva il comportamento dei tag per regioni specifiche

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:

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:

  1. Apri il bilanciatore del carico Google Cloud
  2. Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
    Screenshot delle impostazioni di configurazione del backend
  3. 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.
      Screenshot del nuovo servizio di backend
  4. 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}
  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à Percorso host e regola avanzata.
  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 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:

  1. Apri il bilanciatore del carico Google Cloud
  2. Nel bilanciatore del carico, apri la sezione Configurazione backend. Crea un nuovo servizio di backend.
    Screenshot delle impostazioni di configurazione del backend
  3. 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.
      Screenshot del nuovo servizio di backend
  4. 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}
  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à Percorso host e regola avanzata.
  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 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

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

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

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

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

Ora le intestazioni geografiche potranno essere utilizzate nella variabile Regione 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 visitatore.
  4. In Configurazione variabile, scegli Variabile personalizzata.
  5. 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.

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

    Screenshot delle impostazioni della variabile

  7. 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.

  1. 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
  2. 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.

  3. Seleziona Attiva impostazioni specifiche per la regione. Aggiungi al campo Regione la variabile {{ Visitor Region}} creata nel passaggio precedente.

  4. Salva il cliente.

Passaggio 4: verifica che le impostazioni della regione vengano applicate

Per verificare se le impostazioni funzionano:

  1. Apri la modalità di anteprima per il contenitore del server.
  2. Carica il tuo sito web mentre utilizzi la pubblicazione proprietaria.
  3. Nella finestra di anteprima, fai clic sul client Google Analytics GA4 o Universal Analytics rivendicato. Screenshot del client
  4. Per visualizzare la regione effettiva, imposta il pulsante di opzione Visualizza variabili sui valori. Screenshot del campo della regione del visitatore
    • ✅ 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.

Passaggi successivi