Añade el seguimiento de Plausible Analytics o Fathom a Discourse

Plausible Analytics

  • Primero, agrega tu dominio a tu instancia de Plausible Analytics y obtén tu código de seguimiento. Debería verse algo así:
<script async defer data-domain="community.example.com" src="https://plausible.example.com/js/plausible.js"></script>
  • Crea un nuevo componente de tema desde Administrador > Personalizar > Temas.

  • Luego pega el código de seguimiento en la sección <head>.

  • Haz clic en Guardar.

¡Asegúrate de agregar esto a todos los temas disponibles para que puedas realizar el seguimiento de analíticas en todos los usuarios!

¡Eso es todo!

:information_source: Si no ves que fluyen los datos, es posible que el script esté bloqueado por tus configuraciones de CSP. Revisa la consola de tu navegador y, si recibes errores, agrega https://plausible.io/js/script.js a tus configuraciones de CSP.


Edición: Ya no es necesario agregar el script de origen de la política de seguridad de contenido de Fathom o Plausible debido a esta actualización Content-Security-Policy now uses 'strict-dynamic'

Fathom

Consulta la guía de Fathom para Discourse.

Actualizado el 14 de mayo de 2025 con la guía de Fathom para Discourse
Para más información, consulta la guía de Fathom aquí:

Nota: Tanto para Plausible como para Fathom, sus scripts funcionan correctamente en un componente adjunto a tu(s) tema(s) y insertado en el encabezado de cada plantilla que desees rastrear. La nueva guía de Fathom no utiliza el “método de componente”.

Según la hoja de ruta de Plausible en GitHub, parece que en un futuro cercano será posible incrustar una página de Plausible en un sitio web.

¿Sería posible incrustar algo así en Discourse, o quizás requeriría un plugin, o…?

Necesitas un componente de tema para eso.

¡Hola @Falco! ¿Ha cambiado algo en tu enrutamiento frontend? Veo que recomiendas que la gente use la versión hash de nuestro script, que está pensada para enrutadores basados en hash. Por lo que veo, parece que Discourse ahora está usando la API HTML5 PushState, ¿es correcto?

No estoy seguro de por qué @justin eligió la versión con hash aquí, ya que usamos la API de Historia de HTML5 desde hace mucho tiempo. He convertido la publicación original en un wiki para que todos puedan editarla.

Uso Plausible y puedo confirmar que el plausible.js estándar NO registra las URL si un usuario navega de un tema a otro. Por lo tanto, si necesito una representación precisa de mis visitantes, debo utilizar la versión hash de Plausible JS.

Sin embargo, tengo el mismo problema con la versión con hash.

Es extraño tener estos informes contradictorios. Teóricamente, dado que Discourse utiliza la API de historial de HTML5, debería ser nuestro script estándar (no el script hash) el que realice el seguimiento correctamente.

Por desgracia, no tengo una instancia de Discourse configurada con la que poder probar.

Probablemente sea por mi falta de conocimiento sobre eso :slight_smile: Originalmente opté por la versión de hash porque somos una SPA y tenemos un seguimiento personalizado para otros proveedores de análisis. Si plausible.js funciona, ¡siéntete libre de cambiarlo!

Hola @ukutaht

Cambie de plausible.hash.js a plausible.js en uno de mis dos sitios de Discourse y esto es lo que sucede al hacerlo.

El sitio se abre en otra pestaña y no muestra ninguna actividad en absoluto.

Aquí está mi otro sitio con plausible.hash.js, que muestra correctamente 1 usuario en línea y, en general, también se muestran las páginas correctas en el widget de páginas principales.

Estoy encantado de probar cualquier solución de problemas en caso de que ayude a eliminar la necesidad del JS con hash.

Ah, sí, recuerdo haber visto el mismo comportamiento ahora que lo mencionas, por eso opté por la ruta del script con hash.

Pregunta tonta. ¿Agregar esta función rastrea lo que ocurre dentro de tu comunidad de Discourse o rastrea el tráfico saliente hacia otro dominio al que está vinculada la comunidad?

¿Qué tipo de métricas puedes obtener con esto?

Puedo ver (en mi panel de Plausible) qué enlaces de mi foro de Discourse se están visitando y desde qué país.

¿Así que hay algunos errores al usar Plausible como Analítica?

No, debería funcionar perfectamente. Llevo un tiempo usándolo en mi comunidad y no he notado ningún problema.

He editado el OP para incluir instrucciones sencillas para usar Fathom. Por favor, expanda según sea necesario y pruebe más a fondo.

Funciona muy bien :smiley:

Hola y gracias por tu guía.

Quiero integrar Fathom a Discourse, ¿necesito agregar hash.js al código, al igual que lo hiciste con Plausible?

Creo que es script.js como se indica en el OP (leer hasta Para añadir soporte para Fathom).

Actualización: Los chicos de Fathom han preparado un documento sencillo para guiarte en lo que necesitas hacer. ¡Disfruta!

Nota de Fathom: Puede haber una forma de cambiarlo, pero Discourse añade la etiqueta rel="canonical" para todas las páginas de vuelta a la página de inicio. Por lo tanto, todas nuestras visitas a páginas en Fathom aparecían como si solo provinieran de la página de inicio.

Hablé con Fathom y me dijeron que añadiera esto a tu script de seguimiento, canonical="false" para que quede como a continuación.


-- Fathom - análisis de sitios web sencillos y bonitos --
<script src="https://cdn.domain.com/script.js" data-spa="auto" data-site="ADHGFREZ" data-canonical="false" defer></script>
 -- / Fathom -

Eso solucionó el problema.