Puente para PostHog, Mixpanel & Amplitude
Su herramienta de analítica de producto le dice qué ha pasado. MousePlayer le muestra por qué. Este puente conecta ambas en los dos sentidos, de modo que un abandono en un embudo queda a un clic de la grabación que lo explica.
1. El problema: cifras sin rostro
La analítica de producto le da un embudo: 1.000 usuarios llegaron al pago y 620 lo abandonaron. Es una medición precisa de un problema que usted todavía no ve. Ver un puñado de esas 620 grabaciones suele responder la pregunta en minutos — pero solo si puede pasar del gráfico a las sesiones adecuadas sin exportar ID ni buscar a mano.
El puente de analítica de producto elimina esa brecha. Se ejecuta dentro de mp.js y enlaza ambos sistemas automáticamente:
- Saliente: cada evento que registra su herramienta de analítica lleva una propiedad
mouseplayer_session_url. Abra cualquier evento, haga clic en el enlace y vea la sesión. - Entrante: el
distinct_iddel visitante se lee y se guarda en la sesión de MousePlayer, de modo que las grabaciones se pueden buscar por la misma identidad que ya utiliza en PostHog, Mixpanel o Amplitude.
Sin necesidad de código. El puente detecta por sí solo el SDK de analítica. No tiene que llamar a ninguna función de MousePlayer ni cambiar la forma en que registra los eventos.
2. Activación
Método A: panel (sin código)
- Abra su proyecto y vaya a la pestaña Integraciones.
- Ponga Puente para PostHog, Mixpanel & Amplitude en
ON. - Seleccione la plataforma que utiliza. Los cambios se guardan automáticamente.
El ajuste se aplica en la siguiente carga de página de su sitio web. Las sesiones existentes no se ven afectadas de forma retroactiva.
Método B: configuración manual del script
Si prefiere fijarlo en el código, establezca los dos valores dentro de window.mp_config:
3. Qué ocurre en cada plataforma
Cada plataforma ofrece una API distinta, así que el puente usa la llamada habitual de cada una. No necesita configurarlo — se rige por el proveedor que haya seleccionado.
| Plataforma | Saliente (URL de reproducción) | Entrante (identidad) |
|---|---|---|
| PostHog | posthog.register() — se registra como super property, por lo que se añade a todos los eventos posteriores |
posthog.get_distinct_id() |
| Mixpanel | mixpanel.register() — el mismo comportamiento de super property |
mixpanel.get_distinct_id() |
| Amplitude | setUserProperties() — se establece como propiedad de usuario |
getDeviceId(), con getInstance().options.deviceId como alternativa en el SDK antiguo |
Super property frente a propiedad de usuario: en PostHog y Mixpanel la URL de reproducción se añade a los eventos a partir de ese momento, así que la encontrará en todos los eventos que se disparen después de que se inicialice el puente — no en los que ya se enviaron antes durante la carga de la página.
4. Identidad: del distinct_id a una sesión con nombre
La parte entrante es la que la mayoría de los equipos subestima. Sin ella, las sesiones de MousePlayer son anónimas: puede verlas, pero no puede responder a «muéstreme las grabaciones de la cuenta que se dio de baja la semana pasada».
En cuanto el puente está activo, el distinct_id de su herramienta de analítica se escribe en el campo custom_user_id de la sesión — el mismo campo en el que escribe la llamada manual del SDK:
Si ya llama usted mismo a mp('set'), siga haciéndolo. Una identidad que usted proporciona de forma explícita es más fiable, porque es su propia clave principal y no un identificador de analítica que cambia con cada navegador.
Nota de privacidad: solo se transfiere el identificador que su herramienta de analítica ya ha asignado. Del SDK no se lee ninguna dirección de correo electrónico, ningún nombre ni ningún otro dato personal. Asegúrese de que su propia política de privacidad cubra este tratamiento y condicione el script de seguimiento a su herramienta de consentimiento si el consentimiento es su base jurídica.
5. Comportamiento técnico
Los SDK de analítica suelen cargarse de forma asíncrona, a menudo cuando mp.js ya se está ejecutando. Por eso, un único intento al arrancar fallaría en la mayoría de los sitios web reales.
- El puente lo vuelve a intentar cada 1,5 segundos, hasta diez veces, y se detiene en cuanto ambos sentidos se han completado.
- Cada sentido se resuelve por separado, de modo que la URL de reproducción nunca se envía dos veces mientras se espera a que aparezca una identidad.
- Si el SDK no aparece nunca, el puente desiste sin avisar tras unos 15 segundos. No se escribe nada en la consola y la grabación de sesiones continúa sin verse afectada.
- Los identificadores de más de 128 caracteres se ignoran en lugar de recortarse, para no guardar medio identificador que nunca coincidiría con nada.
6. Comprobar que funciona
- Abra su sitio web en una pestaña normal del navegador e interactúe con él brevemente.
- En su herramienta de analítica, abra el evento más reciente y busque la propiedad
mouseplayer_session_url. Al abrirla debería llegar directamente a la grabación. - En MousePlayer, abra el explorador de usuarios. Las sesiones que llevan una identidad la muestran en lugar del apodo generado para el visitante.
Si no aparece nada
- La propiedad falta en todos los eventos: compruebe que el SDK de analítica se carga realmente en la página y que ha seleccionado la plataforma correspondiente. Con PostHog seleccionado no se lee Mixpanel.
- La propiedad solo aparece en eventos posteriores: es lo esperado; véase la nota del apartado 3.
- La URL está, pero la identidad no: su SDK todavía no ha asignado un
distinct_id, lo cual es normal antes de que se identifique a un usuario. Se recogerá en una carga de página posterior. - Está probando como administrador con la sesión iniciada: algunas configuraciones excluyen el tráfico interno. Pruebe en una ventana privada.
Todas las marcas mencionadas aquí pertenecen a sus respectivos propietarios. MousePlayer no tiene ninguna relación comercial con estos proveedores.