Introducción al etiquetado del servidor

El etiquetado del servidor es una nueva forma de usar Google Tag Manager para instrumentar aplicaciones en todos los dispositivos. Los contenedores de servidor usan la misma etiqueta, activador y de variable de entorno variable que ya conoces, además de brindar herramientas nuevas que te te permite medir la actividad del usuario dondequiera que ocurra.

Una configuración de etiquetado típica sin etiquetado del servidor depende de de la página para enviar datos de medición a varios servidores de recolección. La figura 1 ilustra un ejemplo de cómo un contenedor web de Tag Manager que se ejecuta en un navegador web envía datos a varios servidores.

Diagrama de un sitio instrumentado para usar un contenedor web de Google Tag Manager

Figura 1: Diagrama de un sitio instrumentado para usar un contenedor web de Google Tag Manager.

Por el contrario, un contenedor de servidor no se ejecuta en el navegador del usuario ni en su teléfono. En cambio, se ejecuta en un servidor que tú controlas.

Diagrama de un sitio instrumentado con un contenedor de etiquetado del servidor.

Figura 2: Ejemplo de una configuración de etiquetado que usa un contenedor de servidor

El servidor se ejecuta en tu propio proyecto de Google Cloud Platform o en un entorno diferente de tu elección y que solo tú tengas acceso a los datos en el servidor hasta que decidas enviarlos a otro lugar. Tienes control total sobre cómo se forman esos datos y hacia dónde se enrutan desde la servidor. Las etiquetas se crean con el JavaScript de zona de pruebas tecnología. Los permisos te brindan visibilidad sobre lo que puede hacer la etiqueta te permiten establecer límites en torno al contenedor.

El servidor recibe solicitudes web del dispositivo del usuario y las transforma las solicitudes en eventos. Cada evento es procesado por la dirección etiquetas, activadores y variables. Etiquetas, activadores y variables en un servidor funcionan exactamente como lo hacen en otros tipos de contenedores: los activadores examinar cada evento para detectar ciertas condiciones y, cuando corresponda, activar etiquetas que envían los datos del evento que se procesarán.

En este modelo, se presentan dos preguntas importantes para los contenedores de servidor:

  • ¿Cómo llegan los datos de medición del dispositivo del usuario al contenedor del servidor?
  • ¿Cómo se convierten en un evento los datos de medición que se envían a un contenedor de servidor?

La respuesta a ambas preguntas es un nuevo tipo de entidad para usar en el servidor. contenedores: un cliente.

Cómo funcionan los clientes

Los clientes son adaptadores entre el software que se ejecuta en el dispositivo de un usuario y tu tu contenedor de servidor. El cliente recibe datos de medición de un dispositivo, transforma esos datos en uno o más eventos, enruta los datos para que se procesen en el contenedor y empaqueta los resultados para enviarlos de vuelta al solicitante.

¡Eso es mucho! Analicemos con más detalle cada parte de forma individual. En la Figura 3, se muestran datos que fluyen hacia el contenedor de servidor desde la página web del usuario en el navegador y desde tu servidor web al contenedor de servidor.

Diagrama de un sitio instrumentado con un contenedor de etiquetado del servidor.

Figura 3: Un cliente diferente maneja cada transmisión de datos.

Los clientes reciben datos de medición de un dispositivo. Digamos que quieres medir la actividad de los usuarios en tres lugares: un sitio web, una aplicación para teléfonos y una tostadora. Tu sitio web usa Google Analytics y tu aplicación para teléfonos usa Firebase Analytics y tu toaster usan un protocolo de su propiedad llamado "ToastMeasure".

Instrumentar estos tres dispositivos con Google Tag Manager normalmente requeriría un contenedor diferente para cada plataforma. Dado que el contenedor del servidor no se ejecuta en el dispositivo, el mismo contenedor puede controlar la instrumentación de tres plataformas de dispositivos. Sin embargo, hay un problema. No todos estos dispositivos se comuniquen de la misma manera. El protocolo de Google Analytics no es el mismo que con el protocolo ToastMeasure. Aquí es donde los clientes intervienen.

En lugar de esos tres contenedores, el contenedor de servidor tiene tres clientes. Cada cliente procesa cada solicitud que llegue al contenedor orden de prioridad (el cliente con la prioridad más alta primero). Lo primero que hará cada cliente debe decidir si sabe cómo procesar ese tipo de solicitudes. Si es posible, el cliente "reclama" la solicitud y continúa con la siguiente etapa de datos. El acto de reclamar la solicitud impide que los clientes posteriores en ejecución. Si el cliente no puede procesar la solicitud, no hace nada y permite que el con otros clientes para decidir si procesar la solicitud o no.

Los clientes transforman los datos de las solicitudes en uno o más eventos. Una vez que el cliente de ToastMeasure reclama una solicitud, debe transformar la en algo que el resto del contenedor comprenda. Que algo es un conjunto de eventos

Los eventos son aquellos que suceden y que deseas medir. Pueden ser de cualquier tipo: start_toasting, finish_toasting o buy_bread. Existen algunos recomendaciones sobre la estructura los eventos que genera un cliente, pero el único requisito es que el resto del para que el contenedor los comprenda.

Los clientes ejecutan el contenedor. El cliente reclamó la solicitud y la convirtió en eventos. Ahora es momento de usar las etiquetas, los activadores y las variables. El cliente cada evento al resto del contenedor para su procesamiento posterior.

Los clientes agrupan los resultados para enviarlos de vuelta al dispositivo. Una vez que se ejecutó el contenedor, es hora de responder a la tostadora. La respuesta puede tardar muchas formas. Tal vez el cliente solo dice “Bien, listo”. Tal vez una de las etiquetas quiere redireccionar la solicitud a otro servidor de recopilación. O quizás una de las etiquetas le indica a las luces de la tostadora que cambien de color. Lo que se supone que el trabajo del cliente es empaquetar los resultados y enviarlos de vuelta al solicitante.

Afortunadamente, Tag Manager controla gran parte de esto por ti. Los contenedores de servidor vienen con tres clientes incluidos: Google Analytics 4; Google Analytics: Universal Analytics y el Protocolo de medición. Estos clientes te proporcionan las herramientas que necesitas para comenzar a instrumentar tu aplicación en cuanto hayas creado contenedor.

Un ejemplo breve

Veamos un ejemplo rápido para ver cómo encajan todas las piezas. En en este ejemplo, crearás lo siguiente:

  1. Un sitio web sencillo que utiliza gtag.js para enviar un evento click a una tu contenedor de servidor.
  2. Un cliente de Google Analytics 4 que recibe el evento
  3. Un activador que se activa en un evento click
  4. Una etiqueta de Google Analytics 4 que envía los datos del evento a Google Analytics para de datos.

Para este ejemplo, supondremos que ya creaste y implementado tu contenedor de servidor.

Configura la etiqueta gtag.js

Primero, configura gtag.js para enviar los datos a tu contenedor de servidor. Con gtag.js, enviar datos a tu contenedor de servidor funciona igual que enviar datos a Google Analytics, con una modificación. Como en la página de ejemplo a continuación, establece la Opción de configuración server_container_url para que apunte al contenedor del servidor.

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID', {
    server_container_url: 'https://analytics.example.com',
  });
</script>

Reemplaza TAG_ID por el ID de tu etiqueta. Reemplaza https://analytics.example.com por la URL del contenedor de tu servidor.

A continuación, agrega una función sendEvent() para controlar los eventos click:

<!-- Google tag (gtag.js) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=TAG_ID"></script>
<script>
  window.dataLayer = window.dataLayer || [];
  function gtag(){dataLayer.push(arguments);}
  gtag('js', new Date());

  gtag('config', 'TAG_ID', {
    server_container_url: 'https://analytics.example.com',
  });

  function sendEvent() {
    gtag('event', 'click');
  }
</script>

<button onclick="javascript:sendEvent()">Send Event</button>

Reemplaza TAG_ID por el ID de tu etiqueta. Reemplaza https://analytics.example.com por la URL del contenedor de tu servidor.

Con esta configuración, los controladores de eventos, como la función sendEvent(), incluidos en este ejemplo enviarán un evento click a tu contenedor de servidor.

Cliente de Google Analytics 4

Tu contenedor necesita un cliente para recibir el evento una vez que llega al servidor. Por suerte, los contenedores de servidor incluyen un cliente de Google Analytics 4 preinstalado, por lo que ya completaste este paso.

Hacer clic en el activador

A continuación, crea un activador que se active en el evento click. Crea una configuración Activador que se activa cuando la variable integrada Nombre del evento es igual a "clic".

configuración del activador

Etiqueta de Google Analytics 4

Por último, adjunta una etiqueta de GA4 al activador. Al igual que con los clientes, un contenedor de servidor incluye una etiqueta de GA4. Solo debe crear la etiqueta, establecer su configuración y ya conectaste el contenedor. Los clientes de GA4 y las etiquetas de GA4 están diseñados para trabajar juntos. Esto significa que todo lo que debes hacer es crear una etiqueta de GA4 y su configuración se extraerá automáticamente de los eventos que provengan de cliente.

Obtén una vista previa del contenedor

Ahora que el contenedor está configurado, haz clic en Vista previa. Visita tu sitio web en una otra ventana del navegador. A medida que las solicitudes y los eventos se envían a tu servidor contenedor, verás las solicitudes y los eventos enumerados en el lado izquierdo de la página de vista previa.

Una vez que estés conforme con los cambios, publica el contenedor del servidor.

Cómo configurar tu servidor para el modo de producción con entrega propia

Antes de enviar tráfico de producción a tu contenedor de servidor, recomendamos que instales el servidor en tu dominio propio y actualizar el servidor a modo de producción.