Habilita el comportamiento específico de una región para las etiquetas

Este artículo está dirigido a los desarrolladores que publican secuencias de comandos de Google desde su propio servidor. Te recomendamos que habilites el comportamiento específico de la región para las etiquetas y, así, desbloquear funciones como el modo de consentimiento avanzado y controlar el comportamiento de las etiquetas según la ubicación de tus usuarios.

Si publicas una secuencia de comandos desde un dominio propio, debes proporcionar la información de ubicación geográfica del usuario en el encabezado de la solicitud para poder usar los parámetros event_location.country y event_location.region. Si está disponible en el encabezado de la solicitud, la dirección IP tiene prioridad para determinar la ubicación geográfica. De lo contrario, se usan los parámetros event_location.country y event_location.region para enviar información del país y la región, respectivamente.

Nota: Si gtm.js o gtag.js se publican desde www.googletagmanger.com, la dirección IP y la información de ubicación geográfica del usuario se incluyen en la solicitud de secuencia de comandos, pero solo se usa la información de ubicación geográfica. Si la dirección IP se oculta en el contenedor del servidor, permanecerá oculta, pero la información de la región y el país se usará para el modelado. Para quitarlos, puedes usar la función de transformación.

Antes de comenzar

En esta guía, se da por sentado que ya hiciste lo siguiente:

• Cómo configurar un contenedor de servidor en Tag Manager
• Configura un servidor de etiquetado
• Configura la publicación de secuencias de comandos propias

Paso 1: Configura el encabezado de la solicitud

Debes enviar encabezados de solicitud específicos que contengan la información de la región del usuario, como se describe en las siguientes secciones.

Puedes comenzar directamente en el paso 2 en los siguientes casos:

• Usas App Engine. App Engine envía encabezados geográficos automáticamente.
• Usas un proveedor de infraestructura diferente de los que se indican a continuación. Debes configurar encabezados personalizados.

Cloud Run con el balanceador de cargas de GCP

Puedes enviar información de ubicación geográfica con todos los encabezados de solicitud HTTP o para solicitudes específicas. Dado que agregar encabezados de solicitud personalizados generará un cargo por cada millón de solicitudes, recomendamos incluir solo información geográfica para las solicitudes que publiquen secuencias de comandos de Google. Esta opción requiere más configuración al principio, pero te ayuda a ejecutar tu infraestructura de la manera más económica posible.

Solicitudes de secuencias de comandos

Para incluir los encabezados geográficos solo en las solicitudes de secuencias de comandos, debes configurar un nuevo backend y crear reglas de enrutamiento.

Para crear un backend nuevo, sigue estos pasos:

1. Abre el balanceador de cargas de GCP
2. En tu balanceador de cargas, abre la sección Configuración de backend. Crea un servicio de backend nuevo.
   
3. Configura tu nuevo servicio de backend:
   • Tipo de backend: Elige el tipo de grupo de extremos de red que usa tu aplicación. Si usas Cloud Run, elige Grupo de extremos de red sin servidores.
   • En Nuevo backend, elige el grupo de extremos de red de tu implementación de Tag Manager del servidor.
     
4. Abre la sección Configuraciones avanzadas. Agrega los encabezados de solicitud personalizados.
   

   Nombre del encabezado	Valor del encabezado
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Guarda el servicio de backend nuevo.

Para configurar las reglas de enrutamiento, sigue estos pasos:

1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Regla avanzada de host y ruta de acceso.
2. Actualiza el parámetro pathRules para asignar gtm.js, /gtag/js y /gtag/destination al nuevo servicio de 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. Guarda los cambios.

Todas las solicitudes

Para enviar información de ubicación geográfica con todas las solicitudes HTTP, debes agregar encabezados de solicitud personalizados al servicio de backend existente. Consulta la documentación de Google Cloud. Crea un nuevo encabezado de solicitud personalizado para cada uno de los siguientes encabezados:

Nombre del encabezado	Valor del encabezado
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Balanceador de cargas de GCP

Puedes enviar información de ubicación geográfica con todos los encabezados de solicitud HTTP o para solicitudes específicas. Dado que agregar encabezados de solicitud personalizados generará un cargo por cada millón de solicitudes, recomendamos incluir solo información geográfica para las solicitudes que publiquen secuencias de comandos de Google. Esta opción requiere más configuración al principio, pero te ayuda a ejecutar tu infraestructura de la manera más económica posible.

Solicitudes de secuencias de comandos

Para incluir los encabezados geográficos solo en las solicitudes de secuencias de comandos, debes configurar un nuevo backend y crear reglas de enrutamiento.

Para crear un backend nuevo, sigue estos pasos:

1. Abre el balanceador de cargas de GCP
2. En tu balanceador de cargas, abre la sección Configuración de backend. Crea un servicio de backend nuevo.
   
3. Configura tu nuevo servicio de backend:
   • Tipo de backend: Elige el tipo de grupo de extremos de red que usa tu aplicación. Si usas Cloud Run, elige Grupo de extremos de red sin servidores.
   • En Nuevo backend, elige el grupo de extremos de red de tu implementación de Tag Manager del servidor.
     
4. Abre la sección Configuraciones avanzadas. Agrega los encabezados de solicitud personalizados.
   

   Nombre del encabezado	Valor del encabezado
   X-Gclb-Country	{client_region}
   X-Gclb-Region	{client_region_subdivision}

5. Guarda el servicio de backend nuevo.

Para configurar las reglas de enrutamiento, sigue estos pasos:

1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Regla avanzada de host y ruta de acceso.
2. Actualiza el parámetro pathRules para asignar gtm.js, /gtag/js y /gtag/destination al nuevo servicio de 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. Guarda los cambios.

Todas las solicitudes

Para enviar información de ubicación geográfica con todas las solicitudes HTTP, debes agregar encabezados de solicitud personalizados al servicio de backend existente. Consulta la documentación de Google Cloud. Crea un nuevo encabezado de solicitud personalizado para cada uno de los siguientes encabezados:

Nombre del encabezado	Valor del encabezado
X-Gclb-Country	{client_region}
X-Gclb-Country	{client_region_subdivision}

Amazon Web Services (AWS) CloudFront

Crea una política de solicitud de origen para agregar los encabezados CloudFront-Viewer-Country y CloudFront-Viewer-Country-Region a la solicitud.

Esto agregará automáticamente los siguientes encabezados junto con sus valores:

Nombre del encabezado	Valor del encabezado
CloudFront-Viewer-Country	El país del usuario
CloudFront-Viewer-Country-Region	La subdivisión del usuario

Azure Front Door

Con el motor de reglas, crea un conjunto de reglas con la acción modificar encabezado de la solicitud con la siguiente asignación:

Nombre del encabezado	Valor del encabezado
X-Azure-Country	{geo_country}

Cloudflare

Habilita la opción "Agregar encabezados de ubicación del visitante" en la sección de transformaciones administradas:

Esto agregará automáticamente el siguiente encabezado junto con su valor:

Nombre del encabezado	Valor del encabezado
CF-IPCountry	El país del usuario

Paso 2: Configura la variable Región del visitante

Si configuraste los encabezados geográficos como se especificó anteriormente, Tag Manager detectará automáticamente la región o el país leyendo el encabezado de la solicitud HTTP. Como alternativa, puedes configurar encabezados personalizados.

Detección automática

1. Abrir Google Tag Manager
2. Abre el contenedor del servidor.
3. En el menú Variables, Configura la lista de variables integradas.
4. Selecciona Región del visitante.

Los encabezados geográficos ahora estarán disponibles para usarse en la variable Región del visitante.

Encabezados personalizados

1. Abrir Google Tag Manager
2. Abre el contenedor del servidor.
3. En el menú Variables, crea una variable definida por el usuario nueva del tipo Región del visitante.
4. En Configuración de variables, elige Variable personalizada.

5. En el menú Variables, crea dos variables nuevas de Encabezado de la solicitud: una para tu país y otra para el código de subdivisión. Completa los valores con los códigos de país en los encabezados de tus solicitudes HTTP.

   Nota: El formato debe cumplir con la norma ISO-3166-2.

6. Usa las variables que creaste en la variable Visitor Region, como se muestra en la captura de pantalla.

   

7. Asigna un nombre a tu variable y haz clic en Guardar.

Paso 3: Habilita la configuración específica de la región en tu cliente

Para usar la región del visitante para procesar solicitudes HTTP entrantes, debes agregarla a tu cliente.

1. Selecciona el cliente Google Tag Manager: Contenedor web.

2. Marca Habilitar la configuración específica de la región. Agrega la variable {{Visitor Region}} que creaste en el paso anterior al campo Región.

3. Guarda tu cliente.

Paso 4: Verifica que se aplique la configuración regional

Para probar si tu configuración funciona, haz lo siguiente:

1. Abre el modo de vista previa de tu contenedor del servidor.
2. Carga tu sitio web mientras usas la publicación propia.
3. En la ventana de vista previa, haz clic en el cliente de Google Analytics GA4 Reclamado.
4. Para ver la región real, cambia el botón de opción Display Variables a valores.
   • ✅ Tu implementación es correcta si la propiedad Región muestra un código de país.
   • ❌ Si la propiedad Región muestra undefined o no aparece, tu servidor no recibe datos de la región. Comprueba si los encabezados HTTP del servidor están configurados según las variables predefinidas que busca Google Tag Manager. Consulta Cómo configurar el encabezado de la solicitud.

Próximos pasos

• Cómo configurar el modo de consentimiento para una región específica en un contenedor web