Planes que admiten esta función: Business Enterprise
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 te permite analizar cómo interactúan los lectores con tu contenido, qué artículos generan interacción, dónde se deshacen y medir la efectividad de tu sitio.
Document360 es compatible con Mixpanel como una de sus muchas integraciones de terceros.
Requisitos previos antes de integrar Mixpanel con Document360
Una cuenta Mixpanel
Tu token Mixpanel (disponible en Mixpanel bajo Configuración > Configuración de proyecto > token de proyecto).
Opciones de configuración
Al integrar Mixpanel con Document360, puedes elegir entre dos opciones 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 Mixpanel Project.
Configuración personalizada: Configuración avanzada que requiere cargar e inicializar manualmente la biblioteca Mixpanel . Luego puedes añadir código de seguimiento personalizado para eventos específicos.
Configuración básica
Usa la configuración Básica si quieres una configuración rápida que registre automáticamente las vistas de página con un esfuerzo mínimo.
Navegar a Conexiones () > Integraciones en la barra de navegación izquierda del portal de la base de conocimiento.
Selecciona Mixpanel desde la lista de integraciones y haz clic en Añadir.
Aparecerá el cuadro de Añadir nueva integración .
Selecciona la opción de configuración básica .
Aquí entra la descripción.
Introduce tu token Mixpanel en el campo Mixpanel. Para más detalles sobre dónde encontrar tu token de Mixpanel Project, consulta la guía de instalación Mixpanel.
Opcionalmente, utiliza la función de inclusión/exclusión de código para aplicar el código en función de la dirección IP, el espacio de trabajo o el lenguaje.
Haz clic en Añadir para guardar tu integración.
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), puedes usar la opción de configuración personalizada.
Configuración personalizada
Usa la configuración personalizada para configurar una integración Mixpanel . Esta opción te permite añadir código JavaScript directamente en el panel de configuración y personalizar aún más la integración según tus necesidades.
Navega a Conexiones () > Integraciones en la barra de navegación izquierda del portal de la Base de conocimiento.
Selecciona Mixpanel desde la lista de integraciones y haz clic en Añadir. Aparecerá el panel de Añadir nueva integración .
Selecciona la opción de configuración personalizada .
Introduce la descripción en el panel Añadir nueva integración .
Pega tu fragmento de JavaScript (ver ejemplos más abajo).
Opcionalmente, utiliza la función de inclusión/exclusión de código para aplicar el código en función de la dirección IP, el espacio de trabajo o el lenguaje.
Haz clic en Añadir para guardar tu integración.
PRECAUCIÓN
La configuración personalizada no carga Mixpanel automáticamente. Primero debes incluir la biblioteca Mixpanel e inicializarla con tu token de proyecto de Mixpanel.
Ejemplo: Cargar e inicializar Mixpanel
Sustituye YOUR_PROJECT_TOKEN por tu token Mixpanel Project desde la configuración 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 rastrear.
Ejemplo: seguimiento de clics de botón
Sustituye yourButtonId por el ID real del botón que quieres rastrear y actualiza "Button Name" con una etiqueta significativa.
<script>
document.getElementById("yourButtonId")
.addEventListener("click", function() {
mixpanel.track("Button Click", {
"Button Name": "Your Button Label",
"Page URL": window.location.href
});
});
</script>NOTA
Por ejemplo, si estás rastreando un botón etiquetado como "Suscribirse", sustituye
yourButtonIdpor"subscribeButton"y"Your Button Label"por"Subscribe".
CONSEJO PROFESIONAL
Los ejemplos de código anteriores muestran solo los casos de uso más comunes (vistas de página y clics de botones). Si quieres seguir otros tipos de eventos personalizados, como envíos de formularios, reproducciones de vídeo o profundidad de desplazamiento, consulta la documentación del SDK JavaScript Mixpanel. Incluye una lista completa de métodos, propiedades y patrones avanzados de seguimiento de eventos.
Verifica la configuración
Si no aparece ningún dato en Mixpanel:
Confirma tu token
Asegúrate de haber introducido el token Project de Mixpanel (no el ID del proyecto ni el secreto de la API).Consulta la fuente de la página
Abre tu base de conocimientos en un navegador.
Haz clic derecho en cualquier parte de la página y selecciona Ver fuente de la página.
Atajo: Ctrl+U (Windows/Linux) o ⌘+Option+U (Mac).
Pulsa Ctrl+F / ⌘+F y busca
mixpanel.Si no lo encuentras, el script de integración Mixpanel no ha sido inyectado.
Revisa la pestaña de Red
Abre tu base de conocimientos en un navegador.
Pulsa F12 (Windows/Linux) o ⌘+Option+I (Mac) para abrir Herramientas de desarrollo.
Ve a la pestaña de Red .
En la caja del filtro, escribe
api.mixpanel.com.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 los eventos se bloquean.
Descartar bloqueadores
Revisa bloqueadores de anuncios, banners de consentimiento a cookies o políticas restrictivas de Seguridad de Contenido (CSP). Estos pueden impedir Mixpanel cargue o envíe datos.
CONSEJO PROFESIONAL
Prueba siempre en una ventana incógnita 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 no carga correctamente, puedes añadir una integración personalizada en HTML como solución alternativa.
Navega a Conexiones () > Integraciones en la barra de navegación izquierda del portal de la Base de conocimiento.
Selecciona HTML personalizado desde la lista de integraciones y haz clic en Añadir. Aparecerá el panel de Añadir nueva integración.
Pega el fragmento de la biblioteca Mixpanel (véase "Cargar e inicializar Mixpanel" arriba).
Añade tu código personalizado de seguimiento de eventos.
Guarda la integración y vuelve a probar en Mixpanel.