Google Analytics avanzato (v4)

[AJ_Quick]

	Riepilogo	Tracciamento avanzato degli eventi per Google Analytics 4 su Discourse
	Link al repository	https://github.com/multidimension-al/discourse-google-analytics
	Guida all’installazione	Come installare i plugin in Discourse

Il core di Discourse invia a Google Analytics un singolo page_view per ogni navigazione. Questo plugin aggiunge eventi per il tempo di lettura, il progresso di lettura e il completamento, e può opzionalmente assumere il controllo delle visualizzazioni di pagina in modo da escludere le rotte dei messaggi privati e dell’amministrazione.

PERCHÉ NON USARE IL TAG SEO/GA ANALYTICS INTEGRATO?

Puoi farlo, e per molti forum è sufficiente. Il tag del core funziona, e questo plugin si basa su di esso anziché sostituirlo.

La differenza sta in ciò che viene misurato. Un page_view ti dice che un URL è stato caricato. Non può dirti se qualcuno ha letto ciò che vi era contenuto, quindi una lettura di venti minuti di un lungo argomento e un rimbalzo immediato appaiono identici nei tuoi report. Questo plugin misura quanto a lungo qualcuno ha effettivamente letto, quanto a fondo è arrivato nell’argomento e se ha raggiunto la fine. Questi sono i segnali su cui vale la pena prendere decisioni relative ai contenuti, e quelli che rendono utile la creazione di un pubblico per il remarketing.

I report di Discourse (Amministrazione → Report) sono un sistema separato e rimangono il posto migliore per le metriche interne. Questo riguarda solo ciò che raggiunge Google Analytics.

Funzionalità

• 13 eventi della community: visualizzazioni degli argomenti, coinvolgimento e traguardi del progresso di lettura, completamento della lettura, riepiloghi per visita, ricerca, registrazione, accesso, creazione di argomenti, risposte, “mi piace”, segnalibri
• Lettura misurata rispetto al flusso dei post e al tempo di attenzione, non alla profondità di scorrimento
• Due modalità: estendere il tag esistente del core, oppure assumere il controllo del tag e delle visualizzazioni di pagina
• Messaggi privati, categorie restritte e rotte di amministrazione non generano eventi
• Titoli degli argomenti e termini di ricerca disattivati di default
• Il traffico del personale può essere contrassegnato come traffico interno GA4, per gruppo
• Pagina di diagnostica e avvisi nella dashboard di amministrazione per configurazioni errate

Configurazione

1. Installazione

hooks:
  after_code:
    - exec:
        cd: $home/plugins
        cmd:
          - git clone https://github.com/multidimension-al/discourse-google-analytics.git

Poi esegui ./launcher rebuild app.

2. Scegli una modalità. Amministrazione → Impostazioni → Google Analytics 4.

Estensione del Core (predefinita) — il core mantiene il tag e le visualizzazioni di pagina, il plugin aggiunge eventi sopra di essi. Imposta il ga universal tracking code del core sul tuo G-XXXXXXXXXX e la ga version su v4_gtag.

Gestita — il plugin assume il controllo del tag e delle visualizzazioni di pagina, il che gli permette di escludere le rotte dei messaggi privati e dell’amministrazione. Svuota il ga universal tracking code del core, imposta la ga4 integration mode su managed e inserisci il tuo ID in ga4 measurement id.

3. Attiva discourse ga4 enabled.

4. Opzionale — traffico interno. ga4 internal traffic groups di default include amministratori e moderatori. Ha effetto solo dopo aver creato il filtro corrispondente in GA4 sotto Amministrazione → Impostazioni dati → Filtri dati → Traffico interno, facendo corrispondere traffic_type uguale a internal.

5. Verifica. Amministrazione → Plugin → Google Analytics → Diagnostica.

Per spostare una configurazione esistente da Estensione del Core a Gestita, usa Adotta configurazione GA Discourse esistente nella pagina di Diagnostica anziché modificare le impostazioni manualmente.

Impostazioni

Nome	Descrizione
discourse ga4 enabled	Abilita il plugin. Disattivato di default.
ga4 integration mode	core_extension (il core possiede il tag) o managed (il plugin lo possiede).
ga4 measurement id	ID di misurazione GA4, per la modalità gestita.
ga4 track page views	Invia page_view. Solo modalità gestita.
ga4 track topic views	Invia discourse_topic_view una volta per ogni visita all’argomento.
ga4 track topic engagement	Invia discourse_topic_engaged ai traguardi di tempo di lettura.
ga4 engagement milestones	Secondi di lettura attiva in cui attivare l’evento. Default 10|30|60|180.
ga4 track topic progress	Invia discourse_topic_progress ai traguardi di posizione di lettura.
ga4 progress milestones	Percentuali dell’argomento in cui attivare l’evento. Default 25|50|75|100.
ga4 track read completion	Invia discourse_topic_read_complete quando un lettore raggiunge la fine.
ga4 read complete min seconds	Tempo di lettura minimo prima che la fine conti come completamento.
ga4 track read summaries	Invia discourse_topic_read_summary quando un lettore lascia un argomento.
ga4 read summary min seconds	Sotto questa soglia, una visita è trattata come rimbalzo e non viene riepilogata.
ga4 track search	Invia search quando una ricerca a pagina intera restituisce risultati.
ga4 track registration	Invia sign_up dopo la creazione di un account.
ga4 track login	Invia login dopo un accesso riuscito. Disattivato di default.
ga4 track topic creation	Invia discourse_topic_created.
ga4 track replies	Invia discourse_reply_created.
ga4 track likes	Invia discourse_post_liked. La rimozione di un “mi piace” non invia nulla.
ga4 track bookmarks	Invia discourse_bookmark_created.
ga4 send search terms	Invia anche ciò che è stato cercato. Disattivato di default — le ricerche nei forum spesso contengono informazioni personali.
ga4 send page titles	Include il titolo della pagina. Disattivato di default — su una rotta di argomento, questo è il titolo dell’argomento.
ga4 track private message activity	Un evento aggregato dei messaggi privati che non porta identificatori. Disattivato di default.
ga4 login required is restricted	Su un forum con accesso obbligatorio, trattiene gli identificatori di argomenti e categorie.
ga4 send trust level	Include il livello di fiducia 0–4 come parametro dell’evento.
ga4 internal traffic groups	I membri di questi gruppi sono contrassegnati come traffic_type=internal. Default: amministratori, moderatori.
ga4 suppress in embed	Non invia nulla in modalità incorporata.
ga4 debug mode	Registra gli eventi e le decisioni di soppressione nella console del browser.

Note

• In modalità Estensione del Core, il core possiede ancora le visualizzazioni di pagina, quindi gli URL dei messaggi privati e i titoli degli argomenti vengono ancora inviati. Solo la modalità Gestita cambia questo comportamento.
• Non registrare topic_id come dimensione personalizzata GA4 — è illimitato e raggiungerà i limiti di cardinalità della proprietà.
• I report di Discourse (Amministrazione → Report → Ricerche in tendenza) registrano i click-through, quindi ti dicono quali ricerche hanno fallito. GA4 non può farlo. Ecco perché ga4 send search terms è disattivato di default.