Componente del tema Guest Gate

Ho implementato un sistema di tracciamento analitico per Guest Gate v2.0, con pieno supporto per GTM (Google Tag Manager) e logging personalizzato degli eventi flessibile.

Impostazioni aggiunte

  • enable_analytics (disabilitato di default): Attiva o disattiva l’intera funzionalità di tracciamento, come richiesto.

  • analytics_debug_logging: Quando abilitato, registra tutti gli eventi tracciati direttamente nella console del browser. Questo è particolarmente utile durante la configurazione, quando si impostano i trigger di GTM.

Funzionalità principali

Un modulo helper dedicato (guest-gate-analytics.js) gestisce la dispatch degli eventi. Ogni evento tracciato viene inviato simultaneamente a due destinazioni:

  1. window.dataLayer.push(...): Rilevato automaticamente da Google Tag Manager (GTM) e Google Analytics 4 (GA4) se attivi sul sito.

  2. discourse-guest-gate:analytics (Evento Browser Personalizzato): Consente l’integrazione con strumenti di terze parti (es. Matomo, Plausible o webhook personalizzati) senza richiedere ulteriori modifiche al codice.

Eventi tracciati

  • guest_gate_shown (Attivato quando appare la modale)

    • guest_gate_reason: Il tipo di trigger (page_view, time, scroll o lightbox).

    • guest_gate_path: Il percorso URL in cui la modale è stata mostrata.

  • guest_gate_click (Attivato quando il visitatore interagisce con la modale)

    • guest_gate_click_action: L’azione specifica eseguita (login, signup, sso_login, sso_signup, external_<provider> come il pulsante di accesso Google, oppure dismiss se chiusa senza alcuna azione).

    • Include gli stessi metadati reason e path per correlare facilmente le interazioni con i trigger di visualizzazione.

Privacy e Protezione dei Dati

  • Non vengono raccolti o trasmessi dati personali identificativi (PII), solo i metadati operativi minimi elencati sopra.

In arrivo…:rocket:

> ./support --coffee

3 Mi Piace