Integración de Plausible Analytics

Añade Plausible Analytics a tu sitio de documentación para obtener datos de tráfico sin cookies ni scripts de seguimiento que persigan 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 compatible con GDPR.

Hay dos formas de añadir Plausible. Elige la que se adapte a tu configuración:

Configuración	Úsala cuando	Campo
Estándar	Estás en el plan gratuito de Plausible, o en el 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 proporciona el dominio.

Regístrate en Plausible

Crea una cuenta en Plausible Analytics y añade el dominio de tu sitio de documentación (por ejemplo, docs.example.com).

Añade el dominio a docs.json

{
  "name": "My Docs",
  "integrations": {
    "plausible": {
      "domain": "docs.example.com"
    }
  }
}

Usa el dominio exacto que registraste: docs.example.com, no www.docs.example.com.

Servidor autoalojado

Si utilizas la Community Edition, añade 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 gestionan su propio enrutamiento.

Configuración con 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 habituales.

Obtén la URL de tu script proxy

En la configuración de tu sitio en Plausible, busca la sección de scripts proxy y copia la URL completa. Tiene el formato https://plausible.io/js/pa-XXXXX.js.

Añade 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 de forma interna.

Verificación de la instalación

Tras añadir la integración:

Activa una reconstrucción de tus docs
Visita tu sitio de documentación en producción
Comprueba tu dashboard de Plausible. Tu visita debería aparecer en pocos segundos.
O abre DevTools, ve a la pestaña Red y busca una solicitud a plausible.io/js/script.js (estándar) o a tu script pa-XXXXX.js (proxy)

Plausible muestra datos en tiempo real, sin período de espera como ocurre con 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 atributo `data-domain` en la etiqueta del script.
`scriptUrl`	`string`	Uno de `domain` o `scriptUrl`	URL completa de 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 Plausible autoalojado. Solo se usa con `domain`, no con `scriptUrl`.

Solución de problemas

Nueve de cada diez veces, el problema es el dominio. Debe coincidir exactamente con el que registraste en Plausible (es decir, docs.example.com, no www.docs.example.com).

Si el dominio parece correcto:

Reconstruye tus docs. Los cambios de configuración solo surten efecto tras una nueva build.
Comprueba si hay bloqueadores de anuncios. Algunas extensiones del navegador bloquean los scripts de analítica, incluido Plausible — cambia a la configuración con script proxy si ese es el motivo.
Inspecciona el código fuente de la página para encontrar una etiqueta <script> con data-domain (estándar) o el nombre de archivo pa-XXXXX.js (proxy). Si no está, la configuración no se aplicó.

Registra el dominio que tus usuarios visitan realmente. Si tu documentación está en docs.example.com, usa ese como domain, no tu dominio raíz.

Cambia a la configuración con script proxy. El nombre de archivo único evita la mayoría de las listas de filtros de bloqueadores de anuncios. El autoalojamiento consigue 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.