Google Tag Manager

A sua instituição pode conectar o seu próprio container do Google Tag Manager (GTM). Com a integração ativa, a Eduvem carrega o container em todas as telas da plataforma e publica um conjunto fixo de eventos no dataLayer - o que fazer com esses eventos (Google Analytics, pixels de mídia, remarketing) é configurado por você, dentro do seu container.

Ativando a integração

Na aba de configuração da instituição, logo abaixo dos campos do Zendesk:

Ative Usar Google Tag Manager.
Preencha o ID do Container GTM que aparece em seguida.
Salve.

Campos Usar Google Tag Manager (ativado) e ID do Container GTM, na aba de configuração da instituição, logo abaixo dos campos do Zendesk

O ID é o código que o GTM mostra no topo do seu workspace, no formato GTM-XXXXXXX (as letras GTM- seguidas de 4 a 12 letras maiúsculas ou números). Cole apenas o ID, não o trecho de código completo que o Google oferece para copiar - o campo recusa qualquer outra coisa e mostra o erro logo abaixo dele. Se você digitar em minúsculas, a plataforma normaliza para maiúsculas ao salvar.

Os dois campos são visíveis apenas para o administrador da instituição e acima.

Onde o container carrega

O container carrega em todas as telas da plataforma, inclusive na vitrine, antes do login - é o que permite medir visitantes que ainda não são participantes.

Ele não carrega em dois casos:

quando o conteúdo é aberto de forma incorporada em outro sistema (lançamento externo/embed);
no Painel de Controle da própria Eduvem.

Desativar a chave remove o script e o dataLayer inteiro na carga seguinte da página.

Os eventos publicados

Todos os eventos seguem o mesmo formato: um nome de evento e um objeto knl com as propriedades daquele evento.

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

Evento	Quando acontece	Propriedades em `knl`
`login`	Alguém entra pelo formulário de login (participante ou administrador)	`method` (`password` ou `keycloak`)
`course_view`	Abre a página de um curso ou a visão geral dentro da sala	`course_class_uuid`, `course_version_uuid`
`class_enter`	Entra em uma sala	`course_class_uuid`, `course_version_uuid`
`lecture_enter`	Abre uma aula	`course_class_uuid`, `lecture_uuid`, `lecture_type`
`exam_finish`	Finaliza uma prova	`course_class_uuid`, `approved`
`certificate_download`	Baixa um certificado	`course_class_uuid`, ou `kind: "trilha"` no certificado de trilha
`purchase`	Conclui uma compra	`transaction_id`, `value`, `currency`, `items` (formato recomendado do GA4)

Em lecture_enter, o lecture_type depende do tipo de conteúdo da turma: em conteúdo criado no assistente vem o tipo real da aula (video, text e assim por diante); em conteúdo SCORM ou Coursebox vem scorm12 ou coursebox, que é o que a plataforma consegue informar nesses casos.

O purchase já sai no formato recomendado pelo GA4, então uma tag de ecommerce padrão funciona sem transformação.

O que nunca é enviado

Nenhum evento carrega dado pessoal do participante. A plataforma filtra as propriedades de cada evento contra uma lista fixa antes de publicar, então nome, e-mail, CPF, nome de usuário, identificador da pessoa e identificador da matrícula nunca chegam ao seu container, mesmo por engano.

A nota de uma prova também não é publicada: o exam_finish informa apenas se o participante foi aprovado (approved), nunca a nota.

Conferindo se está funcionando

Depois de salvar, abra a vitrine da sua instituição em uma aba anônima, pressione F12 e, no Console:

document.getElementById('knl-gtm').src deve mostrar um endereço com googletagmanager.com/gtm.js?id= e o seu ID;
window.dataLayer.map(e => e.event) lista os eventos publicados até ali.

O Preview / Tag Assistant do próprio GTM também funciona normalmente.

Boas práticas

Um container por instituição. Se você administra várias instituições na Eduvem, use containers separados - os eventos não trazem nada que os diferencie de dentro do GTM.
Configure o consentimento de cookies no seu container. A plataforma carrega o container que você indicar; o que ele dispara é responsabilidade da configuração dele.
Guarde o ID do container junto com as demais integrações da instituição: ele não aparece mascarado na tela de configuração.