Aggiungi il tracciamento di Plausible Analytics o Fathom a Discourse

Comunità Dati e reportistica
,
1

Plausible Analytics

  • Innanzitutto, aggiungi il tuo dominio alla tua istanza di Plausible Analytics e recupera il codice di tracciamento. Dovrebbe assomigliare a questo:
<script async defer data-domain="community.example.com" src="https://plausible.example.com/js/plausible.js"></script>

  • Crea un nuovo componente del tema da Admin > Personalizza > Temi.

  • Incolla quindi il codice di tracciamento nella sezione <head>.

  • Clicca su Salva.

Assicurati di aggiungerlo a tutti i temi disponibili in modo da poter tracciare le analisi per tutti gli utenti!

È tutto!

:information_source: Se non vedi arrivare dati, lo script potrebbe essere bloccato dalle tue impostazioni CSP. Controlla la console del browser e, se ricevi errori, aggiungi https://plausible.io/js/script.js alle tue impostazioni CSP.

Modifica: Non è più necessario aggiungere il Fathom o Plausible Content security policy script src a causa di questo aggiornamento Content-Security-Policy now uses 'strict-dynamic'

Fathom

Consulta la guida Fathom per Discourse.

Aggiornato il 14 maggio 2025 con la guida di Fathom per Discourse
Per ulteriori informazioni, consulta la guida di Fathom qui:

Nota: Sia per Plausible che per Fathom, i loro script funzionano correttamente in un componente allegato al tuo/ai tuoi tema(i) e inserito nell’head di ogni modello che desideri tracciare. La nuova guida di Fathom non utilizza il “metodo componente”.

27 Mi Piace
3

Secondo la roadmap di Plausible su GitHub, sembra che in un futuro prossimo sarà possibile incorporare una pagina Plausible nel proprio sito web.

Una cosa del genere potrebbe essere incorporata in Discourse, o forse richiederebbe un plugin, o…?

5 Mi Piace
4

Per quello ti serve un componente del tema.

6 Mi Piace
5

Ehi @Falco, è cambiato qualcosa nel tuo routing frontend? Vedo che consigli alle persone di utilizzare la versione hash del nostro script, che è fornita per i router basati su hash. Mi sembra che Discourse stia ora utilizzando l’API HTML5 PushState, è corretto?

3 Mi Piace
6

Non sono sicuro del motivo per cui @justin abbia scelto la versione hash qui, dato che usiamo l’HTML5 History API da sempre. Ho trasformato l’OP in una wiki, così è modificabile da tutti.

1 Mi Piace
7

Uso Plausible e posso confermare che il normale plausible.js NON registra gli URL se un utente passa da un argomento all’altro. Quindi, se ho bisogno di una rappresentazione accurata dei miei visitatori, devo utilizzare la versione hashata di Plausible JS.

8

Anche con la versione hashata ho lo stesso problema

9

Strano avere questi rapporti contrastanti. In teoria, dato che Discourse utilizza l’API HTML5 history, penserei che il nostro script standard (non lo script hash) sia quello che traccia correttamente.

Purtroppo non ho un’istanza di Discourse configurata con cui poter fare dei test.

10

Probabilmente è la mia mancanza di conoscenza a riguardo :slight_smile: Ho inizialmente optato per la versione hash perché siamo un SPA e abbiamo un tracciamento personalizzato per altri provider di analytics. Se plausible.js funziona, sentiti libero di modificarlo!

1 Mi Piace
11

Ciao @ukutaht

Ho cambiato da plausible.hash.js a plausible.js per uno dei miei due siti Discourse e questo è quanto succede quando lo faccio.

Il sito viene aperto in un’altra scheda e non mostra alcuna attività:

SmartSelect_20210707-000518_Firefox
SmartSelect_20210707-000518_Firefox1080×1709 95.6 KB

Ecco il mio altro sito con plausible.hash.js, che mostra correttamente 1 utente online e, in generale, le pagine corrette sono anche visualizzate nel widget delle pagine principali.

SmartSelect_20210707-000834_Firefox
SmartSelect_20210707-000834_Firefox1080×1470 95 KB

Sono felice di provare qualsiasi procedura di risoluzione dei problemi, nel caso in cui possa aiutare a eliminare la necessità dello script JS hashato.

3 Mi Piace
12

Ah sì, ricordo di aver visto lo stesso comportamento ora che lo dici – ed è per questo che ho optato per la via dello script con hash.

3 Mi Piace
13

Domanda forse un po’ banale. L’aggiunta di questa funzione monitora ciò che accade all’interno della tua community su Discourse o traccia il traffico in uscita verso un altro dominio a cui la community è collegata?

Che tipo di metriche è possibile ottenere da questo?

1 Mi Piace
14

Nel mio dashboard Plausible posso vedere quali link del mio forum Discourse vengono visitati e da quale paese.

2 Mi Piace
15

Ci sono alcuni bug nell’utilizzo di Plausible come Analytics?

16

No, dovrebbe funzionare benissimo. Lo uso nella mia community da un po’ di tempo e non ho riscontrato alcun problema.

1 Mi Piace
17

Ho modificato l’OP per includere semplici istruzioni per l’uso di Fathom. Si prega di espandere se necessario e testare ulteriormente.

2 Mi Piace
18

Funziona alla grande :smiley:

2 Mi Piace
19

Ciao e grazie per la tua guida.

Voglio integrare Fathom in Discourse, devo aggiungere hash.js al codice, proprio come hai fatto con Plausible?

20

Penso che sia script.js come indicato nell’OP (leggi fino a Per aggiungere il supporto per Fathom).

2 Mi Piace
21

Aggiornamento: I ragazzi di Fathom hanno preparato un semplice documento per guidarti attraverso ciò che devi fare. Divertiti!

Nota di Fathom: Potrebbe esserci un modo per cambiarlo, ma Discourse aggiunge il tag rel="canonical" per tutte le pagine alla homepage. Quindi tutte le nostre visualizzazioni di pagina in Fathom sono risultate provenire solo dalla homepage.

Ho parlato con Fathom e mi hanno detto di aggiungere questo al tuo script di tracciamento, canonical="false" in modo che appaia come di seguito.

<!-- Fathom - beautiful, simple website analytics -->
<script src="https://cdn.domain.com/script.js" data-spa="auto" data-site="ADHGFREZ" data-canonical="false" defer></script>
<!-- / Fathom -->

Ha funzionato.

3 Mi Piace