Google Tag Manager

Su institución puede conectar su propio contenedor de Google Tag Manager (GTM). Con la integración activa, Eduvem carga el contenedor en todas las pantallas de la plataforma y publica un conjunto fijo de eventos en el dataLayer - qué hacer con esos eventos (Google Analytics, píxeles de medios, remarketing) lo configura usted, dentro de su contenedor.

Activando la integración

En la pestaña de configuración de la institución, justo debajo de los campos de Zendesk:

Active Usar Google Tag Manager.
Complete el ID del Contenedor GTM que aparece a continuación.
Guarde.

Los campos Usar Google Tag Manager (activado) e ID del Contenedor GTM, en la pestaña de configuración de la institución, justo debajo de los campos de Zendesk

El ID es el código que GTM muestra en la parte superior de su workspace, en el formato GTM-XXXXXXX (las letras GTM- seguidas de 4 a 12 letras mayúsculas o números). Pegue solo el ID, no el fragmento de código completo que Google ofrece para copiar - el campo rechaza cualquier otra cosa y muestra el error justo debajo. Si usted lo escribe en minúsculas, la plataforma lo normaliza a mayúsculas al guardar.

Los dos campos son visibles solo para el administrador de la institución y superiores.

Dónde carga el contenedor

El contenedor carga en todas las pantallas de la plataforma, incluida la vitrina, antes del inicio de sesión - es lo que permite medir visitantes que aún no son participantes.

No carga en dos casos:

cuando el contenido se abre incorporado en otro sistema (lanzamiento externo/embed);
en el Panel de Control de la propia Eduvem.

Desactivar la clave elimina el script y todo el dataLayer en la siguiente carga de la página.

Los eventos publicados

Todos los eventos siguen el mismo formato: un nombre de evento y un objeto knl con las propiedades de ese evento.

{ event: 'class_enter', knl: { course_class_uuid: '...', course_version_uuid: '...' } }

Evento	Cuándo sucede	Propiedades en `knl`
`login`	Alguien ingresa por el formulario de inicio de sesión (participante o administrador)	`method` (`password` o `keycloak`)
`course_view`	Abre la página de un curso o la vista general dentro de la sala	`course_class_uuid`, `course_version_uuid`
`class_enter`	Ingresa a una sala	`course_class_uuid`, `course_version_uuid`
`lecture_enter`	Abre una clase	`course_class_uuid`, `lecture_uuid`, `lecture_type`
`exam_finish`	Finaliza una evaluación	`course_class_uuid`, `approved`
`certificate_download`	Descarga un certificado	`course_class_uuid`, o `kind: "trilha"` en el certificado de ruta
`purchase`	Completa una compra	`transaction_id`, `value`, `currency`, `items` (formato recomendado de GA4)

En lecture_enter, el lecture_type depende del tipo de contenido de la sala: en un contenido creado en el asistente viene el tipo real de la clase (video, text y así sucesivamente); en un contenido SCORM o Coursebox viene scorm12 o coursebox, que es lo que la plataforma puede informar en esos casos.

El purchase ya se envía en el formato recomendado por GA4, así que una etiqueta de ecommerce estándar funciona sin transformación.

Qué nunca se envía

Ningún evento lleva datos personales del participante. La plataforma filtra las propiedades de cada evento contra una lista fija antes de publicarlo, así que el nombre, el correo electrónico, el CPF, el nombre de usuario, el identificador de la persona y el identificador de la matrícula nunca llegan a su contenedor, ni siquiera por error.

La nota de una evaluación tampoco se publica: el exam_finish informa solo si el participante fue aprobado (approved), nunca la nota.

Verificando que funciona

Después de guardar, abra la vitrina de su institución en una pestaña de incógnito, presione F12 y, en la Consola:

document.getElementById('knl-gtm').src debe mostrar una dirección con googletagmanager.com/gtm.js?id= y su ID;
window.dataLayer.map(e => e.event) lista los eventos publicados hasta ese momento.

El Preview / Tag Assistant del propio GTM también funciona normalmente.

Buenas prácticas

Un contenedor por institución. Si usted administra varias instituciones en Eduvem, use contenedores separados - los eventos no incluyen nada que los diferencie desde dentro de GTM.
Configure el consentimiento de cookies en su contenedor. La plataforma carga el contenedor que usted indique; lo que ese contenedor dispare es responsabilidad de su configuración.
Guarde el ID del contenedor junto con las demás integraciones de la institución: no aparece enmascarado en la pantalla de configuración.