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:
window.dataLayer.push(...): Rilevato automaticamente da Google Tag Manager (GTM) e Google Analytics 4 (GA4) se attivi sul sito.
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.
Dopo un bel po’ di lavoro, sono lieto di rilasciare Guest Gate v2.0.
Guest Gate è iniziato come un componente di tema relativamente semplice basato sull’originale plugin Guest Gate Sign Up Popup, che permetteva di incoraggiare o richiedere ai visitatori anonimi di registrarsi o accedere dopo aver visualizzato un certo numero di argomenti.
Nel tempo, il componente è cresciuto notevolmente e l’implementazione originale è diventata sempre più difficile da estendere.
Quindi v2.0 non è solo un refactoring o un aggiornamento visivo. Introduce un sistema di trigger completamente nuovo, una migliore personalizzazione, analisi opzionali e una serie di miglioramenti sotto la superficie.
Novità in v2.0?
Multipli tipi di trigger
Guest Gate non è più limitato alle visualizzazioni di argomenti/pagine.
Ora puoi attivare la gate in base a:
Visualizzazioni di pagina
Tempo
Profondità di scorrimento
Apertura di lightbox/immagine
Qualsiasi - attiva la gate quando viene soddisfatta la prima condizione di trigger configurata
Ogni trigger ha la propria soglia configurabile.
Puoi anche configurare un ritardo tra il trigger e l’apparizione della finestra modale.
Questo rende possibile creare diversi tipi di gate, ad esempio:
Mostra la gate dopo 3 visualizzazioni di pagina.
oppure:
Mostra la gate dopo 60 secondi.
oppure:
Mostra la gate quando il visitatore ha scorruto il 70% della pagina.
Comportamento ripetuto
Il vecchio comportamento casuale delle visualizzazioni di pagina è stato espanso in un vero e proprio sistema di ripetizione.
Puoi scegliere tra:
Ripeti trigger: mostra la gate ogni volta che il trigger configurato viene attivato.
Visualizzazioni di pagina casuali: mostra la gate dopo un numero casuale di visualizzazioni di pagina.
Una volta per sessione: mostra la gate al massimo una volta durante la sessione del browser.
Il comportamento esistente “mostra solo una volta” è anche conservato per la compatibilità retroattiva.
Migliore personalizzazione della modale
v2.0 aggiunge più controllo sulla modale stessa.
Ora puoi configurare:
Dimensione della modale: compatta, standard o larga
Allineamento del corpo
Allineamento del piè di pagina
Visibilità del titolo
Posizionamento del titolo
Stile e icona del pulsante di accesso
Stile e icona del pulsante di registrazione
La gate personalizzata è stata anche migliorata con un migliore controllo su:
Allineamento dell’immagine
Larghezza dell’immagine
Testo alternativo dell’immagine
Allineamento e colore dell’intestazione
Allineamento e colore del testo
Colore di sfondo
Colori del piè di pagina e dei link
L’immagine personalizzata è ora opzionale e utilizza anche il caricamento pigro e gli indizi di decodifica.
Analisi
Guest Gate v2.0 include analisi opzionali attente alla privacy.
Quando abilitate, Guest Gate traccia:
Impressione della gate
Motivo del trigger
Percorso della pagina
Clic su accesso
Clic su registrazione
Azioni SSO
Azioni di chiusura
Gli eventi sono esposti tramite window.dataLayer e vengono anche inviati come evento del browser:
discourse-guest-gate:analytics
Questo consente a Guest Gate di essere integrato con piattaforme di analisi e gestione dei tag come Google Analytics, Google Tag Manager, Matomo, o implementazioni di analisi personalizzate.
Nessun dato personale viene raccolto da Guest Gate.
Le analisi sono disabilitate per impostazione predefinita.
Installazioni esistenti
Una delle parti importanti di v2.0 è che le configurazioni esistenti non devono essere ricreate manualmente.
È stata aggiunta una migrazione delle impostazioni per migrare le vecchie impostazioni di Guest Gate alle loro equivalenti v2.
Questo include impostazioni come:
max_guest_topic_views
dismissable_false
gate_show_when_thumbnail_clicked
Le configurazioni esistenti dovrebbero quindi continuare a funzionare dopo l’aggiornamento.
Il componente ora richiede ufficialmente Discourse 3.2.0 o più recente.
Perché v2.0?
L’originale Guest Gate era progettato principalmente per limitare il numero di argomenti che i visitatori anonimi potevano visualizzare.
L’obiettivo di v2.0 è renderlo molto più flessibile.
Guest Gate può ora essere utilizzato come gate generale per la conversione e l’engagement dei visitatori, supportando al contempo il caso d’uso originale.
Ad esempio, puoi usarlo per incoraggiare la registrazione dopo che un visitatore ha:
Letto diversi argomenti
Trascorso una certa quantità di tempo sul sito
Scorrito un articolo
Aperto un’immagine
Raggiunto qualsiasi combinazione di condizioni configurate
Questo è stato un riscrittura piuttosto sostanziale, quindi sono sicuro che ci possono ancora essere cose da migliorare.
Grazie a tutti che hanno usato, testato e fornito feedback su Guest Gate negli anni.
