Pont de PostHog, Mixpanel & Amplitude

La seva eina d’anàlisi de producte li diu què ha passat. MousePlayer li mostra per què. Aquest pont els connecta en tots dos sentits, perquè un abandonament a l’embut sigui a un clic de la gravació que l’explica.

1. El problema: xifres sense cares

L’anàlisi de producte li dona un embut: 1.000 usuaris han arribat al pagament i 620 l’han abandonat. És una mesura precisa d’un problema que encara no veu. Veure unes quantes d’aquelles 620 gravacions sol respondre la pregunta en minuts — però només si pot passar del gràfic a les sessions adequades sense exportar ID ni cercar a mà.

El pont d’anàlisi de producte elimina aquesta distància. S’executa dins de mp.js i enllaça automàticament tots dos sistemes:

  • Sortida: cada esdeveniment que registra l’eina d’anàlisi incorpora mouseplayer_session_url com a propietat. Obri qualsevol esdeveniment, faci clic a l’enllaç i vegi la sessió.
  • Entrada: el distinct_id del visitant es llegeix i es desa a la sessió de MousePlayer; així pot cercar gravacions per la mateixa identitat que ja utilitza a PostHog, Mixpanel o Amplitude.

No cal codi. El pont detecta l’SDK d’anàlisi per si sol. No ha de cridar cap funció de MousePlayer ni canviar com registra els esdeveniments.

2. Activació

Mètode A: tauler (sense codi)

  1. Obri el projecte i vagi a la pestanya Integracions del projecte.
  2. Posi Pont de PostHog, Mixpanel & Amplitude en ON.
  3. Seleccioni la plataforma que utilitza. Els canvis es desen automàticament.

La configuració s’aplica en la pròxima càrrega de pàgina del seu lloc web. Les sessions existents no es veuen afectades retroactivament.

Mètode B: configuració manual de l’script

Si prefereix fixar-ho al codi, estableixi els dos valors dins 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. Què passa a cada plataforma

Cada plataforma ofereix una API diferent; el pont utilitza la crida habitual de cadascuna. No ho ha de configurar — depèn del proveïdor seleccionat.

PlataformaSortida (URL de reproducció)Entrada (identitat)
PostHog posthog.register() — es registra com a superpropietat i s’afegeix a tots els esdeveniments posteriors posthog.get_distinct_id()
Mixpanel mixpanel.register() — el mateix comportament de superpropietat mixpanel.get_distinct_id()
Amplitude setUserProperties() — es defineix com a propietat d’usuari getDeviceId(), amb getInstance().options.deviceId com a alternativa a l’SDK antic

Superpropietat respecte de propietat d’usuari: a PostHog i Mixpanel, l’URL de reproducció s’afegeix als esdeveniments a partir d’aquell moment; el trobarà a tots els esdeveniments activats després d’inicialitzar el pont — no als que ja s’havien enviat abans durant la càrrega de la pàgina.

4. Identitat: del distinct_id a una sessió amb nom

La part d’entrada és la que la majoria d’equips subestima. Sense ella, les sessions de MousePlayer són anònimes: les pot veure, però no pot respondre a «mostri’m les gravacions del compte que es va donar de baixa la setmana passada».

Quan el pont està actiu, el distinct_id de l’eina d’anàlisi s’escriu al camp custom_user_id de la sessió — el mateix camp on escriu la crida manual de l’SDK:

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

Si ja crida mp('set') pel seu compte, continuï fent-ho. Una identitat que proporciona explícitament és més fiable, perquè és la seva pròpia clau primària i no un identificador d’anàlisi que canvia amb cada navegador.

Nota de privacitat: només es transfereix l’identificador que ja ha assignat l’eina d’anàlisi. No es llegeix cap correu, nom ni altre camp personal de l’SDK. Asseguri’s que la seva política de privacitat cobreix aquest tractament i condicioni l’script de seguiment a l’eina de consentiment si el consentiment és la seva base jurídica.

5. Comportament tècnic

Els SDK d’anàlisi acostumen a carregar-se de manera asíncrona, sovint quan mp.js ja s’està executant. Per això un sol intent a l’inici fallaria a la majoria de llocs web reals.

  • El pont ho reintenta cada 1,5 segons, fins a deu vegades, i s’atura quan s’han completat tots dos sentits.
  • Cada sentit es resol de manera independent; l’URL de reproducció mai no s’envia dues vegades mentre s’espera que aparegui una identitat.
  • Si l’SDK no apareix mai, el pont desisteix discretament després d’uns 15 segons. No s’escriu res a la consola i la gravació de sessions continua sense canvis.
  • Els identificadors de més de 128 caràcters s’ignoren en lloc de truncar-se, per no desar mig identificador que mai no coincidiria amb res.

6. Comprovar que funciona

  1. Obri el seu lloc web en una pestanya normal del navegador i interactuï-hi breument.
  2. A l’eina d’anàlisi, obri l’esdeveniment més recent i cerqui la propietat mouseplayer_session_url de l’esdeveniment. En obrir-la hauria d’arribar directament a la gravació.
  3. A MousePlayer, obri Explorador d’usuaris. Les sessions amb identitat la mostren en lloc del sobrenom generat del visitant.

Si no apareix res

  • La propietat falta a tots els esdeveniments: comprovi que l’SDK d’anàlisi es carrega realment a la pàgina i que ha seleccionat la plataforma adequada. Si selecciona PostHog no es llegeix Mixpanel.
  • La propietat només apareix en esdeveniments posteriors: és el que s’espera; vegi la nota de l’apartat 3.
  • Hi ha l’URL, però no la identitat: l’SDK encara no ha assignat cap distinct_id al visitant, cosa normal abans d’identificar-lo. Es recollirà en una càrrega de pàgina posterior.
  • Està provant com a administrador amb sessió iniciada: algunes configuracions exclouen el trànsit intern. Provi-ho en una finestra privada.

Totes les marques esmentades aquí pertanyen als seus propietaris respectius. MousePlayer no té cap relació comercial amb aquests proveïdors.