PostHog-, Mixpanel- ja Amplitude-silta

1. Ongelma: lukuja ilman kasvoja

Tuoteanalytiikka antaa suppilon: 1 000 käyttäjää saapui kassalle, 620 hylkäsi sen. Tarkka mittaus ongelmasta, jota ei vieläkään näe. Muutaman näistä 620 tallenteesta katsominen vastaa yleensä kysymykseen minuuteissa — mutta vain jos kaaviosta pääsee oikeisiin istuntoihin ilman tunnusten vientiä ja käsin hakemista.

Tämä tuoteanalytiikkasilta poistaa aukon. Se toimii skriptissä mp.js ja yhdistää järjestelmät automaattisesti:

Ulospäin: jokainen analyysityökalun tallentama tapahtuma sisältää mouseplayer_session_url-ominaisuuden. Avaa tapahtuma, napsauta linkkiä ja katso istunto.
Sisäänpäin: kävijän distinct_id luetaan takaisin ja tallennetaan MousePlayer-istuntoon, joten tallenteita voi hakea samalla identiteetillä kuin PostHogissa, Mixpanelissa tai Amplitudessa.

Koodia ei tarvita. Silta tunnistaa analytiikka-SDK:n itse. MousePlayer-funktioita ei kutsuta eikä tapahtumaseurantaa tarvitse muuttaa.

2. Aktivointi

Tapa A: koontinäyttö (ei koodia)

Avaa projekti ja välilehti Integraatiot.
Aseta PostHog-, Mixpanel- & Amplitude-silta tilaan ON.
Valitse käytössä oleva alusta. Muutokset tallentuvat automaattisesti.

Asetus tulee voimaan sivuston seuraavalla latauksella. Olemassa oleviin istuntoihin ei vaikuteta jälkikäteen.

Tapa B: skriptin määritys käsin

Jos määritys tehdään suoraan koodiin, aseta kaksi arvoa objektiin window.mp_config:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Alustakohtainen toiminta

Jokaisella alustalla on eri API, joten silta käyttää kullekin sopivaa kutsua. Tätä ei tarvitse määrittää — se seuraa palveluntarjoajan valintaa.

Alusta	Ulospäin (toisto-URL)	Sisäänpäin (identiteetti)
PostHog	`posthog.register()` — rekisteröity super property -ominaisuudeksi, joten se liitetään jokaiseen myöhempään tapahtumaan	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — sama super property -toiminta	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — asetetaan käyttäjäominaisuudeksi	`getDeviceId()`, varavaihtoehtona `getInstance().options.deviceId` vanhassa SDK-versiossa

Super property ja käyttäjäominaisuus: PostHogissa ja Mixpanelissa toisto-URL liitetään tuleviin tapahtumiin, joten se löytyy kaikista sillan alustuksen jälkeen lauenneista tapahtumista — ei jo aiemmin sivulatauksen aikana lähetetyistä.

4. Identiteetti: distinct_id:stä nimettyyn istuntoon

Sisäänpäin tuleva osuus on se, jota useimmat tiimit aliarvioivat. Ilman sitä MousePlayer-istunnot ovat anonyymejä: niitä voi katsoa, mutta ei vastata pyyntöön ”näytä viime viikolla poistuneen tilin tallenteet.”

Sillan ollessa aktiivinen analyysityökalun distinct_id kirjoitetaan istunnon custom_user_id-kenttään — samaan kenttään kuin manuaalinen SDK-kutsu:

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

Jos kutsut jo mp('set') itse, jatka niin. Nimenomaisesti annettu identiteetti on luotettavampi, koska se on oma pääavain eikä selainkohtainen analyysitunniste.

Tietosuojahuomio: vain analyysityökalun jo antama tunniste siirretään. SDK-ohjelmistosta ei lueta sähköpostia, nimeä tai muita henkilökenttiä. Varmista käsittelyn kattaminen tietosuojaselosteessa ja estä seurantaskripti suostumustyökalulla, jos oikeusperuste on suostumus.

5. Tekninen toiminta

Analytiikka-SDK:t ladataan yleensä asynkronisesti, usein vasta kun mp.js on jo käynnissä. Yksi käynnistysyritys epäonnistuisi siksi useimmilla oikeilla sivustoilla.

Silta yrittää uudelleen aina 1,5 sekunnin välein, enintään kymmenen kertaa, ja pysähtyy heti molempien suuntien valmistuttua.
Suunnat valmistuvat itsenäisesti, joten toisto-URL:ia ei koskaan lähetetä kahdesti identiteettiä odotettaessa.
Jos SDK ei ilmesty, silta luovuttaa huomaamatta noin 15 sekunnissa. Konsoliin ei kirjoiteta mitään, ja istuntotallennus jatkuu ennallaan.
Yli 128 merkin tunnisteet ohitetaan katkaisun sijaan, jottei tallenneta puolikasta tunnistetta, joka ei vastaisi mitään.

6. Toiminnan tarkistus

Avaa sivusto tavallisella selainvälilehdellä ja käytä sitä hetki.
Avaa analyysityökalun uusin tapahtuma ja etsi mouseplayer_session_url-ominaisuus. Sen avaamisen pitäisi viedä suoraan tallenteeseen.
Avaa MousePlayerin Käyttäjänäkymä. Tunnistetut istunnot näyttävät identiteetin luodun lempinimen sijaan.

Jos mitään ei näy

Ominaisuus puuttuu kaikista tapahtumista: tarkista analytiikka-SDK:n latautuminen sivulle ja oikean alustan valinta. PostHog-valinta ei lue Mixpanelia.
Ominaisuus näkyy vain myöhemmissä tapahtumissa: odotettua, katso huomautus kohdassa 3.
URL näkyy, mutta identiteetti puuttuu: SDK ei ole vielä antanut tunnistetta distinct_id, mikä on normaalia ennen käyttäjän tunnistamista. Se poimitaan myöhemmällä sivulatauksella.
Testaus tehdään kirjautuneena ylläpitäjänä: jotkin asennukset sulkevat sisäisen liikenteen pois. Kokeile yksityistä ikkunaa.

Miten voimme auttaa?