---
title: Integración con Plausible Analytics
description: Añade Plausible Analytics a tu sitio de documentación. Una alternativa ligera y respetuosa con la privacidad a Google 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.

<Info>
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.
</Info>

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.

<Steps>

### Regístrate en Plausible

Crea una cuenta en [Plausible Analytics](https://plausible.io/) y añade el dominio de tu sitio de documentación (por ejemplo, `docs.example.com`).

### Añade el dominio a docs.json

```json 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`.

</Steps>

### Servidor autoalojado

Si utilizas la [Community Edition](https://github.com/plausible/community-edition), añade el campo `server` para que el script y la API de eventos apunten a tu instancia:

```json docs.json
{
  "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.

<Steps>

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

```json 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.

</Steps>

## Verificación de la instalación

Tras añadir la integración:

1. Activa una reconstrucción de tus docs
2. Visita tu sitio de documentación en producción
3. Comprueba tu dashboard de Plausible. Tu visita debería aparecer en pocos segundos.
4. 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)

<Note>
Plausible muestra datos en tiempo real, sin período de espera como ocurre con Google Analytics.
</Note>

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

<Accordion title="No veo datos en Plausible">
  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:

  1. Reconstruye tus docs. Los cambios de configuración solo surten efecto tras una nueva build.
  2. 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](#configuraci-n-con-script-proxy-scripturl) si ese es el motivo.
  3. 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ó.
</Accordion>

<Accordion title="Uso de un dominio personalizado o subdirectorio">
  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.
</Accordion>

<Accordion title="Script bloqueado por bloqueadores de anuncios">
  Cambia a la [configuración con script proxy](#configuraci-n-con-script-proxy-scripturl). 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.
</Accordion>

<Accordion title="Cuándo usar domain en lugar de scriptUrl">
  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.
</Accordion>

## Artículos relacionados

<Columns cols={2}>
  <Card title="Google Analytics" icon="chart-simple" href="/es/integrations/google-analytics">
    Añade el seguimiento de GA4 a tus docs
  </Card>
  <Card title="Analítica del proyecto" icon="chart-line" href="/es/setup/project-analytics">
    Consulta la analítica integrada de Jamdesk
  </Card>
</Columns>