En este artículo, se describen las diferentes formas de enviar eventos a un contenedor del servidor. Si necesitas más información contextual, 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
- Cómo enviar datos desde 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 del 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.
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 page_view.
2. Recibe 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:
Abre el contenedor del servidor.
En la barra de navegación de la izquierda, haz clic en Clientes. El cliente de GA4 está preinstalado en tu contenedor del servidor de forma predeterminada.
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 su cliente activo.
Criterios de activación: Los criterios de activación definen cuándo el cliente responderá a las solicitudes:
- Rutas de acceso de gtag.js predeterminadas 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 del contenedor de tu 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.
- Rutas de acceso de gtag.js predeterminadas 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 del contenedor de tu 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.,
Opcional: Cómo recibir datos adicionales en Tag Manager del servidor
Si envías parámetros adicionales, debes configurar el cliente de Google Analytics 4 en tu contenedor de servidor para analizarlos 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:
- En el contenedor de tu servidor, haz clic en Variables, en el panel de navegación izquierdo.
- Crea una nueva variable definida por el usuario.
- En Configuración de variables, selecciona el tipo de variable Datos de eventos.
- En Ruta de acceso a la clave, ingresa el nombre del parámetro.
- Asigna un nombre a tu variable y haz clic en Guardar.
Ahora puedes usar el parámetro del evento en cualquier otra etiqueta del contenedor de servidor.
3. Opcional: Envía datos desde 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 apps para dispositivos móviles y aplicaciones de servidor a servidor.
Aplicaciones para dispositivos móviles
Para que tu app para Android o iOS envíe datos a tu contenedor de servidor, deberás crear una etiqueta de imagen personalizada y configurarla para usar el Protocolo de medición:
- En tu contenedor para dispositivos móviles (Android o iOS), haz clic en Etiquetas > Nueva.
- En Configuración de la etiqueta, selecciona el tipo de etiqueta Imagen personalizada.
- Establece el valor de Image URL en una imagen de píxeles en el contenedor de servidor en la ruta del cliente de Measurement Protocol que especificaste antes.
Adjunta 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 - Anula la selección de Habilitar la prevención del almacenamiento en caché.
- Guarda la etiqueta y publica el contenedor.
- En tu contenedor del servidor, haz clic en Clientes > Nuevo.
- En Configuración del cliente, selecciona el tipo de cliente del Protocolo de medición.
- Establece Activation Path en la ruta del extremo de recopilación de tu app.
- 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:
- En el contenedor del servidor, haz clic en Clientes > Nuevo.
- En Configuración del cliente, selecciona el tipo de cliente de Protocolo de medición.
- Establece Activation Path en la ruta de acceso del extremo de tu servidor.
- 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