VAR
Documentação técnica · interna

Eventos de
Tag Manager

Catálogo dos eventos enviados para o Google Tag Manager (GTM-MDXFMS5W), o que é configurável e que métricas se obtêm de cada um. Domínio: var-mundial.com.

~33 eventos Funil de evidências Configurável KPIs
Arquitetura. A landing é servida dentro de um <iframe> (/var.html) no documento de topo (var-mundial.com). O GTM é carregado uma única vez no documento-pai. Todos os eventos da página são empurrados para o dataLayer do pai através do helper vmTrack() (mesma origem), evitando duplicação de pageviews e mantendo o page_location correto. Cada evento inclui sempre o parâmetro vm_source: "var_mundial".

0 · Fluxo de eventos (workflow)

O percurso típico de um visitante e os eventos que dispara, do primeiro carregamento à submissão de uma evidência.

1Chega à landing → o GTM dispara gtm.js / pageview no documento-pai
2landing_view + começam scroll_depth, time_on_page, section_view
3Navega: nav_click · anchor_click · cta_click · menu_open/close · faq_open
4Usa o verificador: verifier_useverifier_result
Regulada → clica "Joga com diversão" → licensed_operator_clickassociate_redirect_startassociate_redirect_go / _cancel
Não regulada → "Reportar esta casa" → vai ao formulário ↓
5Funil de evidências: evidence_form_startevidence_category_selectevidence_file_attachedevidence_submit
(via chat: chat_open → mesmos eventos com channel:"chat")
evidence_submit_success — conversão principal
evidence_submit_error / evidence_validation_error
6Vê o contador (counter_loaded) e sai por links: instagram_click, srij_click, responsible_gambling_click, complaint_portal_click, outbound_click

1 · Navegação & engagement

Evento (event)Quando disparaParâmetrosPara que serve
landing_viewCarregamento da landingpage, campaign, langVisita à campanha (complementa o pageview do GTM)
scroll_depthAtinge 25/50/75/100% da páginapercentProfundidade de leitura
time_on_pageMarcos de 30/60/120/300 ssecondsTempo de permanência / qualidade da visita
section_viewUma secção entra no ecrã (40%)section_idQue secções são realmente vistas
nav_clickClique no menu (desktop/mobile)nav_target, nav_textUso da navegação
anchor_clickClique em link âncora interno (#…)anchor, link_text, locationNavegação interna
cta_clickClique no CTA flutuantecta_label, locationEficácia do CTA fixo
menu_openAbertura do menu mobileInteração mobile
menu_closeFecho do menu mobileInteração mobile
faq_openAbertura de uma pergunta do FAQquestionDúvidas mais procuradas
share_clickClique em partilhar (Twitter/WhatsApp)networkPartilha social

2 · Funil de evidências núcleo da campanha

Sequência completa de submissão de evidência de publicidade a jogo ilegal. Permite medir a taxa de conversão em cada passo.

EventoQuando disparaParâmetrosPara que serve
evidence_form_start1ª interação com o formulárioTopo do funil
evidence_category_selectEscolha da categoriacategoriaTipo de publicidade reportada
evidence_file_attachedAnexa ficheirofile_type, file_size_kb% de submissões com prova
evidence_submitCarrega em enviarcategoria, has_file, has_emailTentativas de submissão
evidence_submit_successSubmissão guardada com sucessocategoria, has_file, has_emailConversão principal
evidence_submit_errorErro de servidor/redeerror_messageProblemas técnicos
evidence_validation_errorValidação do lado do cliente falhareasonAtrito no formulário
counter_loadedContador de evidências carregatotal_validadas, total_publicadasTotal de evidências validadas
chat_openAbertura do chat conversacionalUso do canal de chat

Valores possíveis de categoria: perfil_social, influencer, telegram, artigo_patrocinado, banner_pt, banner_intl, pesquisa, afiliado, outro. Multi-escolha — vêm separadas por vírgula.

O chat dispara os mesmos eventos do funil (evidence_submit, evidence_submit_success, evidence_submit_error) com o parâmetro extra channel: "chat", para distinguir do formulário.

3 · Conteúdo educativo (licenciado vs. ilegal & jogo responsável)

EventoQuando disparaParâmetrosPara que serve
verifier_useUsa o verificador SRIJverifier (topo/principal), queryProcura de marcas
verifier_resultResultado mostradoverifier, query, result (regulada/nao_regulada)Que marcas as pessoas verificam
licensed_operator_clickClique num operador licenciadooperator, link_urlInteresse em alternativas legais
illegal_casino_clickClique num cartão de casa ilegaloperator, link_urlInteresse na lista de ilegais
responsible_gambling_clickClique em recurso de jogo responsávelresource, link_textJogar em Segurança, autoexclusão, autoavaliação
srij_clickClique para o site/lista do SRIJlink_url, link_textEncaminhamento para a fonte oficial
apajo_clickClique para a APAJOlink_url, link_textTráfego institucional
complaint_portal_clickClique para o Portal da Queixalink_url, link_textEncaminhamento de queixas

4 · Saídas & contactos

EventoQuando disparaParâmetrosPara que serve
instagram_clickClique em qualquer link do Instagramlink_url, link_text, locationTráfego para o perfil / DM de evidências
outbound_clickClique em qualquer link externo não classificadolink_url, domain, link_text, locationSaídas gerais
phone_clickClique num número (tel:)numberContactos por telefone
email_clickClique num email (mailto:)emailContactos por email
associate_redirect_startAbre o ecrã de 5s ao clicar num operador licenciadooperator, link_urlIntenção de visitar casa legal
associate_redirect_goConfirma e segue para a casa (após contagem ou "Ir agora")link_urlRedirecionamentos concluídos
associate_redirect_cancelCancela o redirecionamentoAbandono no ecrã intermédio

Os associate_redirect_* são disparados pelo ecrã intermédio de jogo responsável (5 s) ao clicar num operador licenciado (logos APAJO, lista das 17 entidades e botão "Joga com diversão" do verificador).

Todos os eventos incluem ainda vm_source: "var_mundial". A maioria dos cliques inclui location = id da secção onde ocorreu (ex.: validar, cacar, faq).

5 · O que é configurável

ParâmetroValor atualOnde se altera
Container GTMGTM-MDXFMS5Wsrc/routes/__root.tsx (script + noscript)
Domínio do sitevar-mundial.com__root.tsx, sitemap[.]xml.ts, robots.txt, <head> de var.html
Marcos de scroll[25, 50, 75, 100]var.html · bloco analytics (marks)
Marcos de tempo[30, 60, 120, 300] svar.html · bloco analytics
Limite de tamanho de ficheiro25 MBFormulário (var.html) + API (submit-evidence.ts, MAX_FILE_BYTES)
Tipos de ficheiro aceitesimagem, vídeo, PDFsubmit-evidence.ts (ALLOWED_MIME)
Contador mostra…nº de evidências validadas (sem meta/objetivo definido)Vista evidencias_contagem (SQL) + script do contador
Categorias de evidência9 categoriasFormulário + submit-evidence.ts + CHECK da tabela
Limiar de section_view40% visívelvar.html · IntersectionObserver threshold

6 · Métricas & KPIs sugeridos

Alcance

  • Visitantes / sessões (pageview do GTM + landing_view)
  • Origem do tráfego (campanha Instagram, press-release)

Engagement

  • Scroll médio (scroll_depth)
  • Tempo na página (time_on_page)
  • Secções mais vistas (section_view)
  • FAQ mais abertas (faq_open)

Conversão (objetivo principal)

  • Funil: evidence_form_startevidence_category_selectevidence_submitevidence_submit_success
  • Taxa de submissão com ficheiro (has_file)
  • Evidências por categoria
  • Total de evidências validadas (counter_loaded)
  • Atrito: evidence_validation_error / evidence_submit_error

Educação & encaminhamento

  • Verificações SRIJ e % "não regulada" (verifier_result)
  • Cliques em jogo responsável e SRIJ
  • Tráfego para Instagram (instagram_click)

7 · Como ligar no GTM

  1. No GTM, cria um Trigger do tipo Custom Event para cada event (ex.: evidence_submit_success).
  2. Cria Data Layer Variables para os parâmetros que queres usar (ex.: categoria, percent, result, operator).
  3. Liga a tags GA4 do tipo Event, passando os parâmetros como event parameters.
  4. Marca evidence_submit_success como conversão em GA4.
  5. Usa o Preview/Tag Assistant do GTM: como o dataLayer é o do documento-pai, os eventos do iframe aparecem normalmente no container do pai.
Privacidade / RGPD. Antes de ativar em produção: validar o banner de consentimento de cookies e o Consent Mode do GTM. Os eventos não enviam dados pessoais (não incluem o email submetido nem o conteúdo das evidências).