Gracias por consultar la versión preliminar de la nueva documentación sobre la plataforma de etiquetas de Google. Este sitio web está en versión beta pública. (Comentarios)

Envía datos a Google Tag Manager del servidor

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

En este artículo, se describen las diferentes formas de enviar eventos a un contenedor del servidor. Si aún no lo hiciste, completa la configuración del etiquetado del servidor inicial antes de comenzar con los pasos de este artículo.

En este artículo, se describe lo siguiente:

  • Envía datos de un sitio web a tu contenedor del servidor
  • Recibe datos en tu contenedor del servidor
  • Cargue las secuencias de comandos de Google Analytics desde su extremo propio
  • Use una etiqueta de Google Analytics 4 para enviar datos adicionales a un contenedor del servidor
  • Enviar datos de fuentes que no sean sitios web

Configuración del sitio web

Puedes enrutar datos a través de una implementación del servidor mediante Tag Manager o la etiqueta de Google (gtag.js).

Tag Manager

Puedes configurar etiquetas compatibles para enrutar datos mediante la configuración del servidor con la configuración URL del contenedor del servidor. La URL del contenedor del servidor especifica tu extremo de dominio propio.

A fin de configurar una etiqueta para el procesamiento del servidor, agregue la URL del contenedor del servidor:

Google Analytics 4

  1. En un contenedor web, agrega una etiqueta de configuración de GA4 o edita una existente.
  2. Selecciona la casilla de verificación Enviar al contenedor del servidor.
  3. Ingresa la URL del contenedor del servidor en el campo de texto correspondiente.
  4. Guarde la etiqueta y configure el activador para que se active en Todas las páginas.
  5. Publique el contenedor.

Universal Analytics

  1. En un contenedor web, agrega una etiqueta de Universal Analytics con una variable de configuración de Google Analytics o usa una configuración existente de Universal Analytics.
  2. Ve a Más opciones de configuración.
  3. Selecciona la casilla de verificación Establecer URL de transporte.
  4. Agrega la URL del contenedor del servidor al campo URL del transporte (p.ej., https://<DOMAIN_NAME>, en el que DOMAIN_NAME es el nombre del dominio del contenedor del servidor).
  5. Guarde la etiqueta y configure el activador para que se active en todas las páginas.
  6. Publique el contenedor.

Etiqueta de Google (gtag.js)

Si usas gtag.js en tu sitio web, actualiza tu comando config para enviar eventos a tu contenedor del servidor. Agrega un parámetro transport_url a la etiqueta existente:

Para las etiquetas de Google Analytics 4 y Universal Analytics, agrega un parámetro transport_url a la etiqueta existente de la siguiente manera:

gtag('config', 'TARGET-ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
});

Reemplaza TARGET-ID por tu ID de etiqueta o el ID de seguimiento de Universal Analytics. Reemplaza https://analytics.example.com por la URL del contenedor del servidor.

Configuración del cliente del servidor

Una vez que se configura la URL del contenedor del servidor, los datos se envían a un cliente en tu contenedor del servidor de Tag Manager. De forma predeterminada, los clientes GA4 y UA están preinstalados en el contenedor del servidor.

En tu contenedor del servidor de Tag Manager, haz clic en Clientes en la barra de navegación izquierda para ver la lista de clientes. Haz clic en el nombre del cliente para ver o editar los detalles. En la mayoría de los casos, el cliente no requerirá modificaciones. Sin embargo, hay parámetros de configuración que pueden requerir modificaciones en ciertos casos:

  • 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 el cliente responderá a las solicitudes:

    • Rutas de acceso predeterminadas de Universal Analytics: El cliente se activará cuando las rutas de las solicitudes incluyan /collect, /r/collect y otras rutas de acceso similares que usan los archivos de JavaScript que envían datos a Google Analytics. Esta configuración está activa de forma predeterminada.

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

Cargar secuencias de comandos de Google

Para desbloquear todos los beneficios del etiquetado del servidor, puedes cargar secuencias de comandos compatibles a través del contenedor del servidor. Esto reduce la dependencia en un dominio de terceros.

Cómo actualizar el dominio de origen gtag.js

Cuando instalas gtag.js, la configuración predeterminada carga las bibliotecas de Google Analytics desde www.googletagmanager.com. Para cargar el código de Analytics a través del contenedor de tu servidor, cambia este nombre de dominio al dominio de tu contenedor de servidor:

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

  gtag('config', 'TAG_ID');
</script>

Configuración del cliente

Si deseas que el contenedor del servidor responda a las solicitudes para cargar las secuencias de comandos de Google Analytics, necesitas algunas modificaciones menores en los clientes:

  1. En tu contenedor del servidor, haz clic en Clientes para ver la lista de clientes.
  2. Haga clic en el nombre del cliente que desea editar.
  3. Seleccione Rutas de acceso de gtag.js predeterminadas para ID específicos.
  4. Haga clic en Agregar ID de medición y, luego, ingrese su ID.
  5. Guarda la configuración del cliente y publica el contenedor.

Actualiza el dominio de origen de gtm.js

Cuando instalas gtm.js en tu sitio web, la configuración predeterminada carga las bibliotecas de Google Tag Manager desde www.googletagmanager.com. Para cargar el código de GTM a través del contenedor del servidor, cambia este nombre de dominio al dominio del contenedor del servidor para la secuencia de comandos gtm.js y el archivo ns.html:

Captura de pantalla del fragmento de Google Tag Manager para la inserción de gtm.js y ns.html

Configuración del cliente

Para que el contenedor del servidor responda a las solicitudes de carga de secuencias de comandos de Google Tag Manager, debes agregar el cliente Google Tag Manager: Contenedor web y realizar cambios en la configuración:

  1. En tu contenedor del servidor, haz clic en Clientes para ver la lista de clientes.
  2. Haga clic en Nuevo en la sección Clientes.
  3. Haz clic en la sección Client Configuration (Configuración del cliente) para elegir un tipo de cliente.
  4. Selecciona Google Tag Manager: Contenedor web de la lista de clientes disponibles.
  5. Haga clic en Agregar ID de contenedor y, luego, ingrese su ID de contenedor web de GTM. Este ID debe coincidir con el ID que usaste en el fragmento HTML que se muestra arriba.
  6. Guarda la configuración del cliente y publica el contenedor.

Incluir datos adicionales para otras etiquetas

Es posible que tengas varias etiquetas instaladas en la página que envíen datos similares al servidor. En lugar de usar etiquetas separadas, te recomendamos que enrutes esos datos a tu contenedor del servidor con las etiquetas de Google Analytics 4 a través de Tag Manager o gtag.js. Puedes especificar parámetros de eventos adicionales en la etiqueta y, luego, usar variables en el contenedor del servidor para extraer los parámetros. Esto te permite reducir la cantidad de JavaScript en tu página y minimizar la cantidad de solicitudes HTTP, que aumentarán el rendimiento de tu sitio web.

Tag Manager

Si deseas enviar parámetros a todos los eventos, como un identificador único, agrégalos a los campos que deseas configurar en la etiqueta Configuración de Google Analytics 4:

  1. En un contenedor web, agrega una etiqueta de configuración de Google Analytics 4 o edita una existente.
  2. Haz clic en Fields to Set > Add Row.
  3. Agrega el parámetro que deseas presentar en cada evento a la tabla de nombre o valor del parámetro.
  4. Configure un activador para que se active en Todas las páginas y, luego, guarde la etiqueta.

Si hay parámetros que quieres enviar en algunos eventos, agrégalos en la sección Event Parameters de la etiqueta Google Analytics 4 Event.

  1. En un contenedor web, agrega una etiqueta de Evento de Google Analytics 4 o edita una existente.
  2. Haz clic en Parámetros de evento > Agregar fila.
  3. Agrega el parámetro a la tabla de nombre o valor del parámetro.
  4. Configure un activador y guarde la etiqueta.

gtag.js

Con la API de gtag.js, puedes especificar parámetros adicionales si los incluyes como parámetros de comando. Consulte la referencia de la API de gtag.js para obtener más información.

Para configurar los parámetros de todos los eventos, haz lo siguiente:

gtag('config', 'TAG_ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
  'custom_parameter': 'value',
});

Para configurar los parámetros de ciertos eventos, haz lo siguiente:

gtag('event', 'event_name', {
  'custom_parameter': 'value',
});

Para configurar los parámetros que se enviarán solo en los eventos page_view, agrega el parámetro send_page_view con un valor de false en el comando de configuración y agrega un evento page_view independiente.

gtag('config', 'TAG_ID', {
  'transport_url': 'https://analytics.example.com',
  'first_party_collection': true,
  'send_page_view': false,
});
gtag('event', 'page_view', {
  'custom_parameter': 'value',
});

Cómo recibir datos adicionales en Google Tag Manager del servidor

En el contenedor del servidor, el cliente de Google Analytics 4 analizará los parámetros adicionales y los establecerá en los datos del evento. Para usar estos datos en otras etiquetas, te recomendamos crear una variable de datos de eventos y especificar el nombre del parámetro en la ruta de la clave. Ahora puedes usar esta variable en cualquier etiqueta que necesite el parámetro.

Envía datos desde otras fuentes

El Protocolo de medición de Google Analytics se puede usar para habilitar la compatibilidad del etiquetado del servidor desde fuentes como aplicaciones para dispositivos móviles y aplicaciones de servidor a servidor.

Aplicaciones para dispositivos móviles

Si desea que su aplicación para Android o iOS envíe datos al contenedor de su servidor, deberá crear una etiqueta de imagen personalizada y configurarla para usar el Protocolo de medición:

  1. En su contenedor para dispositivos móviles (Android o iOS), haga clic en Tags > New.
  2. En Tag Configuration, seleccione el tipo de etiqueta Custom Image.
  3. Configura el valor de Image URL como una imagen de píxel en el contenedor del servidor en la ruta del cliente del Protocolo de medición que especificaste antes. Agrega los parámetros del Protocolo de medición deseados 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 el almacenamiento en memoria caché.
  5. Guarde la etiqueta y publique el contenedor.
  6. En el contenedor del servidor, haz clic en Clientes > Nuevo.
  7. En Configuración del cliente, seleccione el tipo de cliente Protocolo de medición.
  8. Configura la Ruta de activación como la ruta de acceso del extremo de recopilación de la 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 del servidor, reemplaza el nombre de host www.google-analytics.com por el nombre de dominio de tu contenedor del 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 la instalación de Google Tag Manager del servidor con un cliente del Protocolo de medición:

  1. En el contenedor del servidor, haz clic en Clientes > Nuevo.
  2. En Configuración del cliente, seleccione el tipo de cliente Protocolo de medición.
  3. Configura Ruta de activación como la ruta de acceso del extremo del servidor.
  4. Guarda la configuración del cliente y publica el contenedor.