Enviar datos a Tag Manager del servidor

En este artículo, se describen las diferentes formas de enviar eventos a un contenedor de 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:

  • Enviar datos de un sitio web a tu contenedor de servidor
  • Enviar datos adicionales a un contenedor de servidor
  • Recibir datos en tu contenedor de servidor
  • Enviar 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 mediante Tag Manager o gtag.js. Elige tu 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 de parámetros adicionales: 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 establecer para todos los eventos, seleccionar eventos o eventos page_view.

Elige tu opción de implementación.

Recomendaciones de configuración

Te recomendamos que uses la etiqueta de Google Analytics en una página web para enviar datos al contenedor de 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
  • API de Fetch
  • XHR
  • Trabajador de servicio 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 de servidor.

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

2. Recibe datos en tu contenedor de 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, haz lo siguiente:

  1. Abre Google Tag Manager.

  2. Abre tu contenedor de servidor.

  3. En la barra de navegación de la izquierda, haz clic en Clientes. El cliente de Google Analytics 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, tu caso de uso puede ser diferente y es posible 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 su cliente activo.

  • 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 en tu contenedor de servidor para analizar los parámetros adicionales y crear datos de eventos a partir de ellos.

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

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

  1. En tu contenedor de servidor, haz clic en Variables en la navegación de la izquierda.
  2. Crea una variable nueva definida por el usuario.
  3. En Configuración de variables, selecciona el tipo de variable Datos de eventos.
  4. En Ruta de 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 de evento en cualquier otra etiqueta de tu contenedor de servidor.

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

El Measurement Protocol de Google Analytics se puede usar para habilitar la compatibilidad con el etiquetado del servidor desde fuentes como apps 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 medición. 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 obtención de información geográfica y del dispositivo a partir de 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 Measurement Protocol:

  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 Measurement Protocol que especificaste anteriormente. Agrega los parámetros de Measurement Protocol que desees al final de la URL del 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 de servidor, haz clic en Clientes > Nuevo.
  7. En Configuración del cliente, selecciona el tipo de cliente Protocolo de medición.
  8. Establece la Ruta de activación en la ruta del extremo de recopilación de tu app.
  9. Guarda la configuración del cliente y publica el contenedor de 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 Measurement Protocol, configura tu instalación de Tag Manager del servidor con un cliente del Measurement Protocol:

  1. En tu contenedor de servidor, haz clic en Clientes > Nuevo.
  2. En Configuración del cliente, selecciona el tipo de cliente Protocolo de medición.
  3. Establece la Ruta de activación 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 propio 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