---
title: "Mixpanel"
slug: "mixpanel"
description: "Mixpanel is one of the most powerful analytical tools out in the market now. It is an event-centric platform and uses events for tracking, unlike automatically tracking data. "
tags: ["Mixpanel", "Integrations"]
updated: 2026-06-30T07:01:53Z
published: 2026-06-30T07:01:53Z
canonical: "docs.document360.com/mixpanel"
stale: true
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.document360.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mixpanel

Mixpanel es una herramienta analítica centrada en eventos que rastrea los eventos de los usuarios en lugar de capturar datos automáticamente. Integrar Mixpanel con tu base de conocimientos de Document360 te permite analizar cómo interactúan los lectores con tu contenido, qué artículos generan interacción, dónde se quedan y la efectividad general de tu sitio.

---

## Antes de que empieces

- Necesitas una cuenta de Mixpanel.
- Necesitas tu **token de proyecto de Mixpanel**, disponible en Mixpanel bajo **Configuración** > **Configuración de proyecto** > **token de proyecto**.

---

## Opciones de configuración

Al añadir la integración de Mixpanel, puedes elegir entre dos tipos de configuración:

- **[Configuración básica](/docs/es/mixpanel#basic-configuration):** configuración estándar que rastrea automáticamente las vistas de página después de introducir tu token de Mixpanel Project. Úsala para una instalación rápida y con el mínimo esfuerzo.
- **[Configuración personalizada](/docs/es/mixpanel#custom-configuration):** configuración avanzada que requiere cargar e inicializar manualmente la biblioteca de Mixpanel. Úsalo cuando quieras seguir eventos específicos más allá de las vistas de página, como clics de botones o envíos de formularios.

---

## Cómo configurar Mixpanel

### Configuración básica

1. En el portal Document360, navega a **Conexiones** () > **Integraciones** () en la barra de navegación izquierda.
2. Selecciona **Mixpanel** desde la lista de integraciones y haz clic **en Añadir**. Aparece el cuadro **de Añadir nueva integración** .
3. Selecciona la opción **de configuración básica** .
4. Introduce una **Descripción** para esta integración.
5. Introduce tu **token de proyecto Mixpanel** en el campo **ID de Mixpanel** . Para más detalles sobre dónde encontrar tu token, consulta la [guía de instalación de Mixpanel](https://docs.mixpanel.com/docs/quickstart/install-mixpanel).
6. Opcionalmente, amplía **las condiciones de inclusión/exclusión del código** para aplicar el código en función de **la dirección IP**, **el Espacio de trabajo** o **el lenguaje**.
7. Haz clic **en Añadir**.

Tu base de conocimiento ahora enviará los datos de la vista de página a Mixpanel.

 NOTA

Si quieres seguir eventos adicionales como clics de botones o envíos de formularios, utiliza la opción de configuración personalizada.

![Mixpanel integration setup in Document360 showing Basic configuration with Project token field](https://cdn.document360.io/860f9f88-412e-4570-8222-d5bf2f4b7dd1/Images/Documentation/MixPanel%20integration.gif.gif)

---

### Configuración personalizada

Usa la configuración personalizada para configurar una integración avanzada con Mixpanel. Esta opción te permite añadir código JavaScript directamente en el panel de configuración y personalizar el seguimiento de eventos según tus necesidades.

1. En el portal Document360, navega a **Conexiones** () > **Integraciones** () en la barra de navegación izquierda.
2. Selecciona **Mixpanel** desde la lista de integraciones y haz clic **en Añadir**. Aparece el **panel de Añadir nueva integración** .
3. Selecciona la opción **de configuración personalizada** .
4. Introduce una **Descripción** para esta integración.
5. Pega tu fragmento de JavaScript en el campo de código. Consulta los ejemplos a continuación.
6. Opcionalmente, amplía **las condiciones de inclusión/exclusión del código** para aplicar el código en función de **la dirección IP**, **el Espacio de trabajo** o **el lenguaje**.
7. Haz clic **en Añadir**.

 PRECAUCIÓN

La configuración personalizada no carga Mixpanel automáticamente. Primero debes incluir la biblioteca de Mixpanel e inicializarla con tu token de proyecto de Mixpanel.

**Ejemplo: Cargar e inicializar Mixpanel**

Sustituye `YOUR_PROJECT_TOKEN` por tu token real de Mixpanel Project desde la configuración de Project de Mixpanel.

```
<script>
(function(f,b){
  if(!b.__SV){
    var e,g,i,h;window.mixpanel=b;b._i=[];
    b.init=function(e,f,c){function g(a,d){var b=d.split(".");
      2==b.length&&(a=a[b[0]],d=b[1]);
      a[d]=function(){a.push([d].concat(Array.prototype.slice.call(arguments,0)))}}
      var a=b;"undefined"!==typeof c?a=b[c]=[]:c="mixpanel";
      a.people=a.people||[];a.toString=function(a){var d="mixpanel";
      "mixpanel"!==c&&(d+="."+c);a||(d+=" (stub)");return d};
      a.people.toString=function(){return a.toString(1)+".people (stub)"};
      i="disable time_event track track_pageview track_links track_forms track_with_groups add_group set_group remove_group register register_once alias unregister identify name_tag set set_once union unset toString reset opt_in_tracking opt_out_tracking has_opted_in_tracking has_opted_out_tracking clear_opt_in_out_tracking get_group".split(" ");
      for(h=0;h<i.length;h++)g(a,i[h]);
      b._i.push([e,f,c])
    };
    b.__SV=1.2;
    e=f.createElement("script");
    e.type="text/javascript";e.async=!0;
    e.src="https://cdn.mxpnl.com/libs/mixpanel-2-latest.min.js";
    g=f.getElementsByTagName("script")[0];
    g.parentNode.insertBefore(e,g)
  }
})(document, window.mixpanel || []);
mixpanel.init("YOUR_PROJECT_TOKEN");
</script>
```

**Ejemplo: seguimiento de la vista de página**

```
<script>
mixpanel.track("Page View", {
  "Page URL": window.location.href,
  "Page Title": document.title,
  "Referrer": document.referrer || ""
});
</script>
```

 NOTA

Puedes cambiar el nombre `"Page View"` a otro evento, como `"Article Viewed"` o `"Category Opened"` dependiendo de lo que quieras seguir.

**Ejemplo: seguimiento de clics de botón**

Sustituye `yourButtonId` por el ID real del botón que quieres rastrear y actualiza `"Your Button Label"` con una etiqueta significativa. Por ejemplo, si estás rastreando un botón etiquetado como "Suscribirse", usa `"subscribeButton"` y `"Subscribe"`.

```
<script>
document.getElementById("yourButtonId")
  .addEventListener("click", function() {
    mixpanel.track("Button Click", {
      "Button Name": "Your Button Label",
      "Page URL": window.location.href
    });
  });
</script>
```

  **CONSEJO PROFESIONAL**
  

Los ejemplos anteriores cubren los casos de uso más comunes. Para rastrear otros tipos de eventos como envíos de formularios, reproducciones de vídeo o profundidad de desplazamiento, consulta la [documentación del SDK JavaScript de Mixpanel](https://developer.mixpanel.com/docs/javascript) para una lista completa de métodos y patrones avanzados de seguimiento.

---

## Verifica la configuración

Si no aparece ningún dato en Mixpanel tras la configuración, realiza las siguientes comprobaciones:

**Confirma tu token**

Asegúrate de haber introducido el **token de Mixpanel Project** y no el ID del proyecto ni el secreto de la API.

**Consulta la fuente de la página**

1. Abre tu base de conocimientos en un navegador.
2. Haz clic derecho en cualquier parte de la página y selecciona **Ver fuente de la página** (acceso directo: `Ctrl + U` en Windows/Linux, `⌘+ Option+ U` en Mac).
3. Pulsa `Ctrl + F` / `⌘ + F` y busca `mixpanel`. Si no lo encuentras, el script de integración de Mixpanel no ha sido inyectado.

**Revisa la pestaña de Red**

1. Abre tu base de conocimientos en un navegador.
2. Pulsa **F12** (Windows/Linux) o `⌘ + Option + I` (Mac) para abrir Herramientas de Desarrollo.
3. Ve a la pestaña **de Red** .
4. En la caja del filtro, escribe `api.mixpanel.com`.
5. Recarga la página o realiza una acción como ver un artículo. Si ves solicitudes a `api.mixpanel.com`, se están enviando eventos. Si no aparecen solicitudes, la biblioteca Mixpanel no se está cargando o se bloquean eventos.

**Descartar bloqueadores**

Revisa bloqueadores de anuncios, banners de consentimiento a cookies o políticas restrictivas de Seguridad de Contenido (CSP). Estos pueden impedir que Mixpanel cargue o envíe datos.

  **CONSEJO PROFESIONAL**
  

Prueba siempre en una ventana de navegador de incógnito o privada. Esto garantiza que cargues los scripts publicados más recientes y evita problemas causados por la caché del navegador.

---

### Solución alternativa usando HTML personalizado

Si el script de integración de Mixpanel no carga correctamente a través de la integración nativa, puedes añadirlo como una integración HTML personalizada.

1. En el portal Document360, navega a **Conexiones** () > **Integraciones** () en la barra de navegación izquierda.
2. **Selecciona HTML personalizado** desde la lista de integraciones y haz clic **en Añadir**. Aparece el **panel de Añadir nueva integración**.
3. Pega el fragmento de la biblioteca de Mixpanel (véase "Cargar e inicializar Mixpanel" arriba).
4. Añade tu código personalizado de seguimiento de eventos debajo del fragmento de inicialización.
5. Haz **clic en Añadir** y vuelve a probar en Mixpanel.

---

## Mejores prácticas

- **Usa la configuración básica a menos que necesites seguimiento de eventos personalizado.** Para la mayoría de las bases de conocimiento, introducir el token del Proyecto en configuración Básica es suficiente para empezar a rastrear las vistas de página.
- **Siempre inicializa la biblioteca de Mixpanel antes de llamar a las funciones de seguimiento.** En configuración personalizada, pega primero el fragmento completo de inicialización de la biblioteca y luego añade tu código de seguimiento de eventos debajo.
- **Prueba en una ventana de incógnito después de guardar.** La caché del navegador puede hacer que se ejecuten scripts obsoletos, lo que hace que parezca que los cambios no han tenido efecto.
- **Utiliza condiciones de inclusión/exclusión de código para excluir el tráfico interno.** Añade tu dirección IP de oficina como una exclusión para evitar que las visitas al equipo distorsionen tus datos analíticos.
- **Renombra los eventos para que coincidan con tu convención de nombres.** Los nombres de los eventos de Mixpanel son sensibles a mayúsculas y minúsculas y aparecen tal cual en tu panel de control. Utiliza nombres coherentes y descriptivos como "Artículo Consultado" en lugar de "Vista de página" para facilitar la lectura de tus datos.

---

## Preguntas frecuentes

**¿Cuál es la diferencia entre la configuración Básica y la Personalizada?**

La configuración básica rastrea automáticamente las vistas de página después de introducir tu token de Mixpanel Project. La configuración personalizada requiere que cargues manualmente la biblioteca de Mixpanel y escribas JavaScript para rastrear eventos específicos. Usa Basic para una configuración rápida y Custom cuando necesites seguir eventos más allá de las vistas de página.

**¿Dónde puedo encontrar mi token de Mixpanel Project?**

En Mixpanel, ve a **Configuración** > **Configuración del proyecto** > **token del proyecto**. Asegúrate de copiar el token del Proyecto y no el ID del Proyecto ni el secreto de la API, ya que estos son valores diferentes.

**¿Por qué no aparecen datos en Mixpanel después de configurar la integración?**

Comprueba que has introducido correctamente el token de Proyecto, verifica que el script de Mixpanel está inyectado buscando "mixpanel" en la fuente de la página, y revisa la pestaña de Red en Herramientas de Desarrollo para solicitar a `api.mixpanel.com`. Los bloqueadores de anuncios, los banners de consentimiento a las cookies o las políticas de seguridad de contenido también pueden bloquear la ejecución del guion. Consulta la sección Verificar la configuración para comprobaciones paso a paso.

**¿Puedo hacer seguimiento de eventos distintos a las vistas de página?**

Sí. Utiliza la opción de configuración personalizada y añade código JavaScript de seguimiento de eventos para clics de botones, envíos de formularios, reproducciones de vídeo o cualquier otra interacción. Consulta los ejemplos de código en este artículo y consulta la [documentación del SDK JavaScript de Mixpanel](https://developer.mixpanel.com/docs/javascript) para patrones avanzados.

**¿Puedo limitar qué espacios de trabajo o idiomas rastrea Mixpanel?**

Sí. Al añadir o editar la integración de Mixpanel, amplía la sección de **condiciones de inclusión/exclusión de código** y añade condiciones basadas en la dirección IP, el espacio de trabajo o el lenguaje. Consulte [las condiciones de inclusión y exclusión del Código](https://docs.document360.com/docs/es/advanced-insertion-rules-in-integration) para más detalles.