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

Este artículo está destinado 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 desbloquees funciones como el modo de consentimiento avanzado, además de controlar el comportamiento de las etiquetas según la ubicación de los usuarios.

Si publicas una secuencia de comandos desde un dominio de origen, debes proporcionar la información de geolocalización 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 geolocalización. 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.

Antes de comenzar

En esta guía, se supone que ya hiciste lo siguiente:

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 si se cumplen las siguientes condiciones:

  • 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 geolocalización con todos los encabezados de solicitud HTTP o para solicitudes específicas. Dado que agregar encabezados de solicitud personalizados generará una tarifa por cada millón de solicitudes, te recomendamos que solo incluyas información geográfica para las solicitudes de publicación de secuencias de comandos de Google. Esta opción requiere más configuración inicial, 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 para las solicitudes de secuencias de comandos, debes configurar un backend nuevo 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.
    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 tu 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-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Guarda el servicio de backend nuevo.

Para configurar reglas de enrutamiento, sigue estos pasos:

  1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Regla de host y ruta de acceso avanzada.
  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 geolocalización 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 encabezado de solicitud personalizado nuevo para cada encabezado que se indica a continuación:

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 geolocalización con todos los encabezados de solicitud HTTP o para solicitudes específicas. Dado que agregar encabezados de solicitud personalizados generará una tarifa por cada millón de solicitudes, te recomendamos que solo incluyas información geográfica para las solicitudes de publicación de secuencias de comandos de Google. Esta opción requiere más configuración inicial, 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 para las solicitudes de secuencias de comandos, debes configurar un backend nuevo 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.
    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 tu 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-Country {client_region}
    X-Gclb-Region {client_region_subdivision}
  5. Guarda el servicio de backend nuevo.

Para configurar reglas de enrutamiento, sigue estos pasos:

  1. En tu balanceador de cargas, abre la sección Reglas de enrutamiento. Elige el modo Regla de host y ruta de acceso avanzada.
  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 geolocalización 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 encabezado de solicitud personalizado nuevo para cada encabezado que se indica a continuación:

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

Azure Front Door

Con el motor de reglas, crea un conjunto de reglas con la acción de 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-IPCountry 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ó anteriormente, Tag Manager detecta 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. Abre Google Tag Manager.
  2. Abre tu 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. Abre Google Tag Manager.
  2. Abre tu contenedor del servidor.
  3. En el menú Variables, crea una variable definida por el usuario nueva del tipo Región del visitante.
  4. En la 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 la solicitud HTTP.

  6. Usa las variables que creaste en la variable Región del visitante como se muestra en la captura de pantalla.

    Captura de pantalla de la configuración de la variable

  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

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

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

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

  3. Guarda tu 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 para tu contenedor del 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 Google Analytics GA4 reclamado. Captura de pantalla del cliente
  4. Para ver la región real, cambia el botón de selección Mostrar variables a valores. Captura de pantalla del campo de región del visitante
    • ✅ 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 falta, tu servidor no recibe datos 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 Configura el encabezado de la solicitud.

Próximos pasos