Enviar datos a Tag Manager del servidor

En este artículo, se describen las diferentes formas de enviar eventos a un contenedor del servidor. Si necesitas más información general, consulta cómo funciona el etiquetado del servidor.

En este artículo, se explica cómo hacer lo siguiente:

  • Envía datos de un sitio web a tu contenedor del servidor
  • Envía datos adicionales a un contenedor de servidor
  • Cómo recibir datos en tu contenedor del servidor
  • Envía datos de fuentes que no sean sitios web

Antes de comenzar

En esta guía, suponemos que ya tienes lo siguiente:

1. Envía datos de un sitio web a tu contenedor de servidor

Puedes enrutar los datos a través de una implementación del servidor con Tag Manager o gtag.js. Elige la opción de implementación.

Elige tu opción de implementación.

Opcional: Envía parámetros adicionales con cada evento

Puedes enviar dos tipos adicionales de parámetros: parámetros a nivel de la configuración y parámetros a nivel del evento. Los parámetros de configuración influyen en el comportamiento de tu etiqueta de Google y solo se pueden establecer a nivel de la etiqueta de Google.

Los parámetros de eventos especifican información adicional sobre un evento y se pueden configurar para todos los eventos, eventos seleccionados o eventos de page_view.

Elige la opción de implementación.

Recomendaciones de configuración

Te recomendamos que uses la etiqueta de GA4 en una página web para enviar datos al contenedor del servidor. Esta etiqueta puede usar diferentes métodos de transporte para garantizar la mejor tasa de entrega de los eventos. Estos métodos incluyen, entre otros, los siguientes:

  • Píxel de imagen
  • Fetch API
  • XHR
  • Service worker que se ejecuta en un iframe cargado desde el dominio de tu contenedor de servidor.

Para asegurarte de que se admitan todos los métodos, verifica lo siguiente:

Política de Seguridad del Contenido (CSP)

Directiva Contenido Purpose
img-src [SERVER_CONTAINER_URL] Solicitudes de medición
connect-src [SERVER_CONTAINER_URL] Solicitudes de medición
frame-src [SERVER_CONTAINER_URL] Implementación del service worker

Además, X-Frame-Options no debe restringir la carga de iframes desde la URL del contenedor del servidor.

Consulta https://developers.google.com/tag-platform/security/guides/csp para conocer las políticas específicas de cada producto.

2. Cómo recibir datos en tu contenedor del servidor

Cuando envías una solicitud HTTP a un contenedor de servidor, un cliente debe reclamar esa solicitud.

Para ver la lista de clientes disponibles, sigue estos pasos:

  1. Abrir Google Tag Manager

  2. Abre el contenedor del servidor.

  3. En la barra de navegación de la izquierda, haz clic en Clientes. El cliente de GA4 está preinstalado en tu contenedor de servidor de forma predeterminada.

  4. Haz clic en el nombre del cliente para ver o editar los detalles.

Configuración opcional del cliente

En la mayoría de los casos, el cliente no requerirá modificaciones. Sin embargo, es posible que tu caso de uso sea diferente y que desees editar uno de los siguientes parámetros de configuración:

  • Prioridad: Determina el orden en que se ejecutarán los clientes. Los números más altos se ejecutan primero, y el primer cliente que coincida con la solicitud entrante se convertirá en el cliente activo para esa solicitud.

  • Criterios de activación: Los criterios de activación definen cuándo responderá el cliente a las solicitudes:

    • Rutas predeterminadas de gtag.js para IDs específicos: Usa este parámetro de configuración para habilitar la publicación de JavaScript de gtag.js a través de la URL de tu contenedor de servidor. Si se habilita esta opción, se activará este cliente en respuesta a las solicitudes que se envíen a las rutas de solicitud predeterminadas de gtag.js, p.ej., /gtag/js?id=TAG_ID. Haz clic en Agregar ID de medición para agregar uno o más IDs de destino.

Opcional: Recibe datos adicionales en Tag Manager del servidor

Si envías parámetros adicionales, debes configurar el cliente de Google Analytics 4 en tu contenedor del servidor para analizar los parámetros adicionales y crear datos de eventos a partir de ellos.

Algunas etiquetas del servidor incluirán los parámetros adicionales en sus solicitudes salientes sin necesidad de configuración. Para excluir esos parámetros, crea una Transformation para quitar el valor.

Para usar parámetros adicionales en otras etiquetas, haz lo siguiente:

  1. En tu contenedor del servidor, haz clic en Variables en el panel de navegación de la izquierda.
  2. Crea una nueva variable definida por el usuario.
  3. En Configuración de variables, selecciona el tipo de variable Datos del evento.
  4. En Ruta de acceso a la clave, ingresa el nombre del parámetro.
  5. Asigna un nombre a tu variable y haz clic en Guardar.

Ahora puedes usar el parámetro del evento en cualquier otra etiqueta de tu contenedor de servidor.

3. Opcional: Envía datos de fuentes que no sean sitios web

El Protocolo de medición de Google Analytics se puede usar para habilitar la compatibilidad con el etiquetado del servidor desde fuentes como aplicaciones para dispositivos móviles y aplicaciones de servidor a servidor. Esta opción te permite enviar eventos a tu contenedor en el formato del Protocolo de Measurement. El contenedor envía esos eventos a Google Analytics con el mismo mecanismo que todos los demás eventos de sGTM.

Esta opción no admite todas las funciones del extremo del Protocolo de medición, como la derivación de información geográfica y del dispositivo a partir de los eventos de etiquetado.

Aplicaciones para dispositivos móviles

Para que tu app para Android o iOS envíe datos a tu contenedor de servidor, crearás una etiqueta de imagen personalizada y la configurarás para que use el Protocolo de Measurement:

  1. En tu contenedor para dispositivos móviles (Android o iOS), haz clic en Etiquetas > Nueva.
  2. En Configuración de la etiqueta, selecciona el tipo de etiqueta Imagen personalizada.
  3. Establece el valor de URL de la imagen en una imagen de píxel en el contenedor de servidor en la ruta de acceso del cliente del Protocolo de Measurement que especificaste anteriormente. Agrega los parámetros del Protocolo de medición que desees al final de la URL de tu píxel:
    https://custom.example.com/app?v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home
  4. Anula la selección de Habilitar la prevención del almacenamiento en caché.
  5. Guarda la etiqueta y publica el contenedor.
  6. En tu contenedor del servidor, haz clic en Clientes > Nuevo.
  7. En Client Configuration, selecciona el tipo de cliente Measurement Protocol.
  8. Establece Activation Path en la ruta de acceso al extremo de recopilación de tu app.
  9. Guarda la configuración del cliente y publica el contenedor del servidor.

Apps de servidor a servidor

Para enviar datos del Protocolo de medición a tu contenedor de servidor, reemplaza el nombre de host www.google-analytics.com por el nombre de dominio de tu contenedor de servidor. Por ejemplo:

POST /batch HTTP/1.1
Host: collection.example.com

v=1&tid=TAG_ID&cid=555&t=screenview&an=myApp&version=1.6.2&aid=com.foo.myapp&cd=home

Para recibir hits del Protocolo de medición, configura tu instalación de Tag Manager del servidor con un cliente del Protocolo de medición:

  1. En tu contenedor del servidor, haz clic en Clientes > Nuevo.
  2. En Client Configuration, selecciona el tipo de cliente Measurement Protocol.
  3. Establece Activation Path en la ruta del extremo de tu servidor.
  4. Guarda la configuración del cliente y publica el contenedor.

Próximos pasos

Para enviar datos en un contexto de origen real, debes publicar secuencias de comandos de Google, como la biblioteca de Google Analytics, desde tus propios servidores.

Cargar secuencias de comandos de Google a través de mi servidor