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: 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: 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.
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.

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.

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>

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>

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.

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