Implementei um sistema de rastreamento analítico para o Guest Gate v2.0, com suporte completo ao GTM (Google Tag Manager) e registro flexível de eventos personalizados.
Configurações Adicionadas
-
enable_analytics(desativado por padrão): Ativa ou desativa toda a funcionalidade de rastreamento, conforme solicitado. -
analytics_debug_logging: Quando ativado, registra todos os eventos rastreados diretamente no console do navegador. Isso é especialmente útil durante a configuração, ao definir gatilhos no GTM.
Funcionalidade Principal
Um módulo auxiliar dedicado (guest-gate-analytics.js) gerencia o despacho de eventos. Cada evento rastreado é enviado simultaneamente para dois destinos:
-
window.dataLayer.push(...): Capturado automaticamente pelo Google Tag Manager (GTM) e pelo Google Analytics 4 (GA4), se ativos no site. -
discourse-guest-gate:analytics(Evento de Navegador Personalizado): Permite a integração com ferramentas de terceiros (por exemplo, Matomo, Plausible ou webhooks personalizados) sem exigir quaisquer modificações adicionais de código.
Eventos Rastreados
-
guest_gate_shown(Disparado quando o modal aparece)-
guest_gate_reason: O tipo de gatilho (page_view,time,scrolloulightbox). -
guest_gate_path: O caminho da URL onde o modal foi exibido.
-
-
guest_gate_click(Disparado quando o visitante interage com o modal)-
guest_gate_click_action: A ação específica realizada (login,signup,sso_login,sso_signup,external_<provider>, como o botão de login com o Google, oudismissse fechado sem nenhuma ação). -
Inclui os mesmos metadados de
reasonepathpara correlacionar facilmente as interações com os gatilhos de exibição.
-
Privacidade e Proteção de Dados
- Nenhuma informação pessoal identificável (PII) é coletada ou transmitida, apenas os metadados operacionais mínimos listados acima.
Em breve…