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

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

Antes de comenzar

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

Paso 1: Configura el encabezado de la solicitud

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

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

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

Cloud Run con el balanceador de cargas de GCP

Puedes enviar la 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 se aplicará una tarifa por cada millón de solicitudes, te recomendamos que solo incluyas información geográfica para las solicitudes que entreguen secuencias de comandos de Google. Al principio, esta opción requiere más configuración, pero te ayuda a ejecutar la infraestructura de la manera más económica posible.

Solicitudes de secuencias de comandos

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

Sigue estos pasos para crear un backend nuevo:

  1. Abrir 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.
    Captura de pantalla de la configuración del backend
  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 la implementación de Tag Manager del servidor.
      Captura de pantalla del nuevo servicio de backend
  4. Abre la sección Configuración avanzada. Agrega los encabezados de solicitud personalizados.
    Nombre del encabezado Valor del encabezado
    X-Gclb-País {client_region}
    Región X-Gclb {client_region_subdivision}
  5. Guarda el nuevo servicio de backend.

Para configurar las reglas de enrutamiento, haz lo siguiente:

  1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Ruta y regla de host avanzadas.
  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:

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

Balanceador de cargas de GCP

Puedes enviar la 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 se aplicará una tarifa por cada millón de solicitudes, te recomendamos que solo incluyas información geográfica para las solicitudes que entreguen secuencias de comandos de Google. Al principio, esta opción requiere más configuración, pero te ayuda a ejecutar la infraestructura de la manera más económica posible.

Solicitudes de secuencias de comandos

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

Sigue estos pasos para crear un backend nuevo:

  1. Abrir 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.
    Captura de pantalla de la configuración del backend
  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 la implementación de Tag Manager del servidor.
      Captura de pantalla del nuevo servicio de backend
  4. Abre la sección Configuración avanzada. Agrega los encabezados de solicitud personalizados.
    Nombre del encabezado Valor del encabezado
    X-Gclb-País {client_region}
    Región X-Gclb {client_region_subdivision}
  5. Guarda el nuevo servicio de backend.

Para configurar las reglas de enrutamiento, haz lo siguiente:

  1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Ruta y regla de host avanzadas.
  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:

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 el encabezado 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-País El país del usuario
CloudFront-Viewer-Country-Region La subdivisión del usuario
Configuración del encabezado en CloudFront de AWS

Azure Front Door

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

Nombre del encabezado Valor del encabezado
X-Azure-Country {geo_country}
Captura de pantalla de la configuración de Azure Front Door

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-IPPaís El país del usuario
Captura de pantalla de la configuración de Cloudflare

Paso 2: Configura la variable Región del visitante

Si configuraste encabezados geográficos como se especificó antes, Tag Manager detecta automáticamente la región o el país mediante la lectura del encabezado de la solicitud HTTP. De manera alternativa, puedes configurar encabezados personalizados.

Detección automática

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

Los encabezados de ubicación geográfica ahora estarán disponibles para usarlos en la variable Región del visitante.

Encabezados personalizados

  1. Abrir Google Tag Manager
  2. Abre tu contenedor de servidor.
  3. En el menú Variables, crea una variable Nueva definida por el usuario 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 tus encabezados de solicitud HTTP.

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

    Captura de pantalla de la configuración de variables

  7. Asigna un nombre a tu variable y guárdala.

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

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

  1. Selecciona el cliente o crea uno nuevo al que quieras aplicar la configuración de región. Los clientes admitidos son los siguientes:

    • Google Tag Manager: Contenedor web
    • Google Analytics: GA4
    • Google Analytics: Universal Analytics

  2. Si configuras clientes de GA4 o UA, marca la casilla Rutas de gtag.js predeterminadas para IDs específicos y, luego, ingresa el ID de medición de tu contenedor web.

  3. Marca Habilitar la configuración específica de la región. En el campo Región, agrega la variable {{Visitor Region} que creaste en el paso anterior.

  4. Guarda el cliente.

Paso 4: Verifica que se aplique la configuración de la región

Para probar si la configuración funciona, sigue estos pasos:

  1. Abre el Modo de vista previa de tu contenedor de servidor.
  2. Carga tu sitio web mientras usas la publicación de origen.
  3. En la ventana de vista previa, haz clic en el cliente reclamado de Google Analytics GA4 o Universal Analytics. Captura de pantalla del cliente
  4. Para ver la región real, cambia el botón de selección Display Variables a valores. Captura de pantalla del campo de región del visitante
    • ✅ Tu implementación es correcta si la propiedad Region muestra un código de país.
    • ❌ Si la propiedad Región muestra undefined o falta, significa que tu servidor no recibe ningún dato de la región. Verifica 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