Ponte PostHog, Mixpanel & Amplitude

A súa ferramenta de analítica de produto dille que ocorreu. MousePlayer móstralle por que. Esta ponte conecta ambas nas dúas direccións, de xeito que un abandono nun funil queda a un clic da gravación que o explica.

1. O problema: cifras sen caras

A analítica de produto dálle un funil: 1.000 usuarios chegaron ao pagamento e 620 abandonaron. É unha medida precisa dun problema que aínda non pode ver. Ver unhas poucas desas 620 gravacións adoita responder á pregunta en minutos — pero só se pode pasar do gráfico ás sesións correctas sen exportar ID nin buscar á man.

A ponte de analítica de produto elimina esa distancia. Execútase dentro de mp.js e vincula ambos os sistemas automaticamente:

  • Saída: cada evento que grava a súa ferramenta de analítica leva unha propiedade mouseplayer_session_url coa ligazón á sesión. Abra calquera evento, prema a ligazón e vexa a sesión.
  • Entrada: o distinct_id do visitante lese e gárdase na sesión MousePlayer, polo que as gravacións se poden buscar coa mesma identidade que xa usa en PostHog, Mixpanel ou Amplitude.

Sen necesidade de código. A ponte detecta soa o SDK de analítica. Non ten que chamar ningunha función MousePlayer nin cambiar o seguimento dos eventos.

2. Activación

Método A: panel (sen código)

  1. Abra o seu proxecto e vaia a Integracións na barra de lapelas.
  2. Cambie Ponte PostHog, Mixpanel & Amplitude a ON.
  3. Seleccione a plataforma que usa. Os cambios gárdanse automaticamente.

A configuración aplícase na próxima carga dunha páxina do sitio. Non afecta retroactivamente ás sesións existentes.

Método B: configuración manual do script

Se prefire configuralo no código, estableza os dous valores dentro de window.mp_config:

<!-- MousePlayer SDK with the Product Analytics Bridge enabled --> <script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Que ocorre en cada plataforma

Cada plataforma ofrece unha API distinta, polo que a ponte usa a chamada habitual de cada unha. Non necesita configurar isto — segue a selección do provedor.

PlataformaSaída (URL da reprodución)Entrada (identidade)
PostHog posthog.register() — rexistrada como superpropiedade, polo que se engade a cada evento posterior posthog.get_distinct_id()
Mixpanel mixpanel.register() — o mesmo comportamento de superpropiedade mixpanel.get_distinct_id()
Amplitude setUserProperties() — establecida como propiedade do usuario getDeviceId(), recorrendo a getInstance().options.deviceId no SDK antigo

Superpropiedade fronte a propiedade do usuario: en PostHog e Mixpanel o URL da reprodución engádese aos eventos a partir dese momento; atoparao en cada evento enviado despois de inicializar a ponte — non nos eventos xa enviados antes durante a carga da páxina.

4. Identidade: de distinct_id a unha sesión identificada

A metade de entrada é a parte que a maioría dos equipos subestima. Sen ela, as sesións MousePlayer son anónimas: pode velas, pero non responder a «móstrame as gravacións da conta que abandonou definitivamente a semana pasada».

Coa ponte activa, o distinct_id da ferramenta de analítica escríbese no campo custom_user_id da sesión — o mesmo campo no que escribe a chamada manual do SDK:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

Se xa chama a mp('set') vostede mesmo, siga facéndoo. Unha identidade que proporciona expresamente é máis fiable porque é a súa propia clave principal, non un identificador de analítica por navegador.

Nota de privacidade: só se transfire o identificador que xa asignou a ferramenta de analítica. Non se le ningún enderezo de correo electrónico, nome nin outro campo persoal do SDK. Asegúrese de que a política de privacidade cubra este tratamento e bloquee o script coa ferramenta de consentimento se usa o consentimento como base xurídica.

5. Comportamento técnico

Os SDK de analítica adoitan cargarse de maneira asíncrona, a miúdo cando mp.js xa está en execución. Por iso un único intento ao inicio fallaría na maioría dos sitios reais.

  • A ponte reinténtao cada 1,5 segundos, ata dez veces, e detense en canto se completan as dúas direccións.
  • Cada dirección resólvese de forma independente, polo que o URL da reprodución nunca se envía dúas veces mentres se agarda a que apareza unha identidade.
  • Se o SDK nunca aparece, a ponte desiste en silencio tras uns 15 segundos. Non se escribe nada na consola e a gravación das sesións segue sen cambios.
  • Os identificadores de máis de 128 caracteres ignóranse en lugar de truncarse para evitar gardar medio identificador que nunca coincidiría con nada.

6. Comprobar que funciona

  1. Abra o seu sitio nunha lapela normal do navegador e interactúe brevemente.
  2. Na ferramenta de analítica, abra o evento máis recente e busque a propiedade mouseplayer_session_url para chegar directamente á gravación ao abrila.
  3. En MousePlayer abra o Explorador de usuarios. As sesións cunha identidade móstrana en lugar do alcume xerado do visitante.

Se non aparece nada

  • A propiedade falta en todos os eventos: comprobe que o SDK de analítica se carga realmente na páxina e que seleccionou a plataforma correcta. Seleccionar PostHog non permite ler Mixpanel.
  • A propiedade só aparece en eventos posteriores: é o esperado; vexa a nota da sección 3.
  • Hai URL pero non identidade: o SDK aínda non asignou un distinct_id nesta fase, o que é normal antes de identificar un usuario. Recollerase nunha carga de páxina posterior.
  • Proba como administrador coa sesión iniciada: algunhas configuracións exclúen o tráfico interno. Probe unha xanela privada.

Todas as marcas mencionadas aquí pertencen aos seus respectivos propietarios. MousePlayer non ten relación comercial con estes provedores.