Adicione o rastreamento do Plausible Analytics ou Fathom ao Discourse

Comunidade Dados e relatórios
,
1

Plausible Analytics

  • Primeiro, adicione seu domínio à sua instância do Plausible Analytics e obtenha seu código de rastreamento. Ele deve se parecer com algo assim:
<script async defer data-domain="community.example.com" src="https://plausible.example.com/js/plausible.js"></script>

  • Crie um novo componente de tema em Admin > Personalizar > Temas.

  • Em seguida, cole o código de rastreamento na seção <head>.

  • Clique em Salvar.

Certifique-se de adicionar isso a todos os temas disponíveis para que você possa rastrear as análises em todos os usuários!

É isso!

:information_source: Se você não vir dados sendo transmitidos, o script pode estar bloqueado pelas suas configurações de CSP. Verifique o console do seu navegador e, se estiver recebendo erros, adicione https://plausible.io/js/script.js às suas configurações de CSP.

Edição: Adicionar o script de política de segurança de conteúdo do Fathom ou Plausible não é mais necessário devido a esta atualização Content-Security-Policy now uses 'strict-dynamic'

Fathom

Consulte o guia do Fathom para Discourse.

Atualizado em 14 de maio de 2025 com o guia do Fathom para Discourse
Para mais informações, consulte o guia do Fathom aqui:

Nota: Tanto para o Plausible quanto para o Fathom, seus scripts funcionam bem em um componente anexado ao(s) seu(s) tema(s) e inserido no cabeçalho de cada modelo que você deseja rastrear. O novo guia do Fathom não usa o “método de componente”.

27 curtidas
3

De acordo com o roteiro do Plausible no GitHub, parece que será possível, em algum momento no futuro próximo, incorporar a página do Plausible ao próprio site.

Seria algo assim incorporável ao Discourse, ou talvez exigisse um plugin, ou…?

5 curtidas
4

Você precisa de um componente de tema para isso.

6 curtidas
5

Ei @Falco, algo mudou no seu roteamento de frontend? Vejo que você recomenda que as pessoas usem a versão hash do nosso script, que é fornecida para roteadores baseados em hash. Parece-me que o Discourse está usando a API HTML5 PushState agora, está correto?

3 curtidas
6

Não tenho certeza do motivo pelo qual @justin escolheu a versão com hash aqui, já que usamos a API de Histórico do HTML5 há tempos. Transformei a OP em um wiki, para que possa ser editada por todos.

1 curtida
7

Eu uso o Plausible e posso confirmar que o plausible.js padrão NÃO registra as URLs quando um usuário navega de um tópico para outro. Portanto, se preciso de uma representação precisa dos meus visitantes, tenho que usar o plausible.js com hash.

8

Eu tenho o mesmo problema com a versão hashada, embora.

9

É estranho ter esses relatos conflitantes. Teoricamente, como o Discourse usa a API de histórico do HTML5, eu pensaria que nosso script padrão (não o script de hash) seria o que acompanha corretamente.

Infelizmente, não tenho uma instância do Discourse configurada para testar.

10

Provavelmente minha falta de conhecimento sobre isso :slight_smile: Originalmente optei pela versão hash porque somos uma SPA e temos rastreamento personalizado para outros provedores de análise. Se plausible.js funcionar, fique à vontade para alterá-lo!

1 curtida
11

Olá @ukutaht

Mudei de plausible.hash.js para plausible.js em um dos meus dois sites do Discourse e é isso que acontece quando faço isso.

O site é aberto em outra aba e não mostra nenhuma atividade:

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

Aqui está meu outro site com plausible.hash.js, que mostra corretamente 1 usuário online e, em geral, as páginas corretas também são exibidas no widget de páginas mais visitadas.

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

Estou disposto a testar qualquer solução de problemas, caso isso ajude a eliminar a necessidade do JS com hash.

3 curtidas
12

Ah, sim, agora que você menciona, lembro de ter visto o mesmo comportamento — é por isso que optei pela rota do script com hash.

3 curtidas
13

Pergunta bobinha. Adicionar esse recurso rastreia o que está acontecendo dentro da sua comunidade no Discourse ou rastreia o tráfego de saída para outro domínio ao qual a comunidade está vinculada?

Que tipo de métricas você pode obter com isso?

1 curtida
14

Eu consigo (no meu painel plausível) ver quais links do meu fórum Discourse estão sendo acessados e de qual país.

2 curtidas
15

Então, existem alguns bugs ao usar o Plausible como Analytics?

16

Não, deve funcionar perfeitamente. Eu o uso em minha comunidade há algum tempo e não notei nenhum problema.

1 curtida
17

Eu editei o OP para incluir instruções simples para usar o Fathom. Por favor, expanda conforme necessário e teste mais.

2 curtidas
18

Está funcionando muito bem :smiley:

2 curtidas
19

Olá e obrigado pelo seu guia.

Quero integrar o Fathom ao Discourse, preciso adicionar hash.js ao código, assim como você fez com o Plausible?

20

Eu acho que é script.js como indicado no OP (leia até Para adicionar suporte ao Fathom).

2 curtidas
21

Atualização: O pessoal da Fathom preparou um documento simples para guiá-lo pelo que você precisa fazer. Aproveite!

Observação da Fathom: Pode haver uma maneira de alterá-lo, mas o Discourse adiciona a tag rel="canonical" para todas as páginas de volta à página inicial. Portanto, todas as nossas visualizações de página na Fathom mostraram como se viessem apenas da página inicial.

Conversei com a Fathom e eles disseram para adicionar isto ao seu script de rastreamento, canonical="false" para que fique como abaixo.


-- 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 --

Isso resolveu o problema.

3 curtidas