Integración de Plausible Analytics
Agrega Plausible Analytics a tu sitio de documentación. Una alternativa ligera y centrada en la privacidad a Google Analytics.
Agrega Plausible Analytics a tu sitio de documentación para obtener datos de tráfico sin cookies ni scripts de seguimiento que siguen a los usuarios por la web.
Plausible es de código abierto, pesa menos de 1 KB y no requiere un banner de consentimiento de cookies en la mayoría de las jurisdicciones. Es una buena opción si quieres analítica simple y conforme con el RGPD.
Si necesitas gestión de consentimiento (o también usas GA, GTM o Crisp), consulta Cookie Consent.
Hay dos formas de agregar Plausible. Elige la que coincida con tu configuración:
| Configuración | Cuándo usarla | Campo |
|---|---|---|
| Estándar | Estás en el plan gratuito de Plausible, o en un plan de pago sin necesidad de proxy | domain |
| Script proxy | Estás en un plan de pago y quieres evitar los bloqueadores de anuncios | scriptUrl |
Configuración estándar (domain)
Esta es la opción predeterminada para la mayoría de los usuarios. Registra tu sitio en Plausible y pasa el dominio.
Regístrate en Plausible
Crea una cuenta en Plausible Analytics y agrega el dominio de tu sitio de documentación (por ejemplo, docs.example.com).
Agrega el dominio a docs.json
{
"name": "My Docs",
"integrations": {
"plausible": {
"domain": "docs.example.com"
}
}
}Usa exactamente el dominio que registraste: docs.example.com, no www.docs.example.com.
Servidor autoalojado
Si ejecutas la Community Edition, agrega el campo server para que el script y la API de eventos apunten a tu instancia:
{
"name": "My Docs",
"integrations": {
"plausible": {
"domain": "docs.example.com",
"server": "https://analytics.example.com"
}
}
}server solo funciona con domain. Los scripts proxy manejan su propio enrutamiento.
Configuración de script proxy (scriptUrl)
Los planes de pago de Plausible ofrecen scripts proxy con un nombre de archivo único (como pa-XXXXX.js). Estos evitan la mayoría de los bloqueadores de anuncios porque la URL del script no coincide con las listas de filtros comunes.
Obtén la URL de tu script proxy
En la configuración de tu sitio en Plausible, busca la sección de script proxy y copia la URL completa. Se ve así: https://plausible.io/js/pa-XXXXX.js.
Agrega la URL del script a docs.json
{
"name": "My Docs",
"integrations": {
"plausible": {
"scriptUrl": "https://plausible.io/js/pa-XXXXX.js"
}
}
}No se necesitan los campos domain ni server. La identidad de tu sitio está integrada en el ID del script, y el CDN de Plausible gestiona el enrutamiento internamente.
Verificar la instalación
Después de agregar la integración:
- Activa un rebuild de tu documentación
- Visita tu sitio de documentación en vivo
- Revisa tu dashboard de Plausible. Tu visita debería aparecer en unos segundos.
- O abre DevTools, ve a la pestaña Network y busca una solicitud a
plausible.io/js/script.js(estándar) o tu scriptpa-XXXXX.js(proxy)
Plausible muestra datos en tiempo real, sin el período de espera de Google Analytics.
Referencia de configuración
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
domain | string | Uno de domain o scriptUrl | El dominio de tu sitio tal como está registrado en Plausible. Se usa como el atributo data-domain en la etiqueta del script. |
scriptUrl | string | Uno de domain o scriptUrl | URL completa a un script proxy de pago de Plausible (pa-XXXXX.js). La identidad del sitio está integrada en el script, por lo que no se necesita el campo domain. |
server | string | No | URL de un servidor de Plausible autoalojado. Solo se usa con domain, no con scriptUrl. |
Solución de problemas
Nueve de cada diez veces, es el dominio. Debe coincidir exactamente con lo que registraste en Plausible (es decir, docs.example.com, no www.docs.example.com).
Si el dominio parece correcto:
- Reconstruye tu documentación. Los cambios de configuración solo tienen efecto después de un nuevo build.
- Revisa si hay bloqueadores de anuncios. Algunas extensiones del navegador bloquean scripts de analítica, incluido Plausible. Si esa es la causa, cambia a la configuración de script proxy.
- Inspecciona el código fuente de la página en busca de una etiqueta
<script>condata-domain(estándar) o el nombre de tu archivopa-XXXXX.js(proxy). Si no está ahí, la configuración no se aplicó.
Registra el dominio que tus usuarios realmente visitan. Si tu documentación está en docs.example.com, usa eso como el domain, no tu dominio raíz.
Cambia a la configuración de script proxy. El nombre de archivo único evita la mayoría de las listas de filtros de bloqueadores de anuncios. El autoalojamiento logra el mismo resultado, ya que el script se carga desde tu propio dominio.
Usa domain si estás en el plan gratuito o no te preocupan los bloqueadores de anuncios. Usa scriptUrl si estás en un plan de pago y quieres la máxima cobertura de seguimiento. No configures ambos; elige uno.