Brú fyrir PostHog, Mixpanel & Amplitude

Vörugreiningartólið þitt segir þér hvað gerðist. MousePlayer sýnir þér hvers vegna. Þessi brú tengir kerfin í báðar áttir svo upptakan sem útskýrir brottfall úr trekt sé aðeins einum smelli frá.

1. Vandamálið: tölur án andlita

Vörugreining gefur þér trekt: 1.000 notendur náðu greiðsluafgreiðslu, 620 yfirgáfu hana. Það er nákvæm mæling á vandamáli sem þú sérð enn ekki. Að horfa á nokkrar af þessum 620 upptökum svarar yfirleitt spurningunni á mínútum — en aðeins ef þú kemst úr grafinu í réttar lotur án útflutnings auðkenna og handvirkrar leitar.

Þessi vörugreiningarbrú lokar bilinu. Hún keyrir inni í mp.js og tengir kerfin sjálfkrafa:

  • Út: hver atburður sem greiningartólið skráir ber eigindið mouseplayer_session_url . Opnaðu hvaða atburð sem er, smelltu á tengilinn og horfðu á lotuna.
  • Inn: Auðkenni gestsins, distinct_id , er lesið til baka og geymt á MousePlayer-lotunni svo upptökur verði leitanlegar með sama auðkenni og þú notar þegar í PostHog, Mixpanel eða Amplitude.

Enginn kóði þarf. Brúin greinir greiningar-SDK sjálf. Þú kallar ekki á neina MousePlayer-aðgerð og þarft ekki að breyta atburðarakningunni.

2. Virkjun

Leið A: stjórnborð (án kóða)

  1. Opnaðu verkefnið og farðu í flipann Samþættingar .
  2. Stilltu Brú fyrir PostHog, Mixpanel & Amplitude á ON.
  3. Veldu vettvanginn sem þú notar. Breytingar vistast sjálfkrafa.

Stillingin tekur gildi við næstu síðuhleðslu vefsvæðisins. Hún hefur ekki afturvirk áhrif á fyrri lotur.

Leið B: handvirk stilling skriftu

Ef þú kýst að harðkóða þetta skaltu stilla gildin tvö inni í 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. Hvað gerist á hverjum vettvangi

Hver vettvangur býður ólíkt API svo brúin notar viðeigandi kall fyrir hvern þeirra. Þú þarft ekki að stilla þetta — það fylgir vali þínu á þjónustuaðila.

VettvangurÚt (vefslóð endurspilunar)Inn (auðkenni)
PostHog posthog.register() — skráð sem supereigindi svo það fylgi öllum síðari atburðum posthog.get_distinct_id()
Mixpanel mixpanel.register() — sama hegðun supereigindis mixpanel.get_distinct_id()
Amplitude setUserProperties() — stillt sem notandaeigindi getDeviceId(), með varaleiðinni getInstance().options.deviceId í eldra SDK

Supereigindi eða notandaeigindi: í PostHog og Mixpanel fylgir endurspilunarvefslóð atburðum héðan í frá svo þú finnur hana á hverjum atburði sem verður eftir frumstillingu brúarinnar — ekki á atburðum sem voru þegar sendir fyrr í síðuhleðslunni.

4. Auðkenni: frá distinct_id að nafngreindri lotu

Innleiðin er sá hluti sem flest teymi vanmeta. Án hennar eru MousePlayer-lotur nafnlausar: þú getur horft á þær en ekki svarað „sýndu mér upptökur reikningsins sem hætti í síðustu viku.“

Þegar brúin er virk er auðkennið distinct_id úr greiningartólinu skrifað í reit lotunnar, custom_user_id — sama reit og handvirka SDK-kallið skrifar í:

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

Ef þú kallar nú þegar sjálf(ur) á mp('set') skaltu halda því áfram. Auðkenni sem þú gefur sérstaklega er áreiðanlegra því það er þinn eigin aðallykill en ekki greiningarauðkenni hvers vafra.

Persónuvernd: aðeins auðkennið sem greiningartólið hefur þegar úthlutað er flutt. Ekkert netfang, nafn eða annar persónureitur er lesinn úr SDK. Tryggðu að persónuverndarstefnan nái yfir þessa vinnslu og láttu samþykkistólið loka á rakningarskriftuna ef samþykki er lagagrundvöllurinn þinn.

5. Tæknileg hegðun

Greiningar-SDK hlaðast yfirleitt ósamstillt, oft eftir að mp.js er þegar farið að keyra. Ein tilraun við ræsingu myndi því bregðast á flestum raunverulegum vefsvæðum.

  • Brúin reynir aftur á 1,5 sekúndna fresti, allt að tíu sinnumog hættir um leið og báðar áttir eru tilbúnar.
  • Hvor átt lýkur sjálfstætt svo endurspilunarvefslóðin sé aldrei send tvisvar meðan beðið er eftir auðkenni.
  • Ef SDK birtist aldrei gefst brúin hljóðlega upp eftir um 15 sekúndur. Ekkert er skrifað í stjórnborðið og lotuupptaka heldur óbreytt áfram.
  • Auðkenni lengri en 128 stafir eru hunsuð en ekki stytt til að forðast geymslu hálfs auðkennis sem myndi aldrei samsvara neinu.

6. Sannreyna virkni

  1. Opnaðu vefsvæðið í venjulegum vafraflipa og notaðu það stuttlega.
  2. Opnaðu nýjasta atburðinn í greiningartólinu og leitaðu að eigindinu mouseplayer_session_url . Opnun þess ætti að fara beint í upptökuna.
  3. Opnaðu í MousePlayer Skoðun notenda. Lotur með auðkenni sýna það í stað myndaðs gælunafns gestsins.

Ef ekkert birtist

  • Eigindið vantar á alla atburði: athugaðu hvort greiningar-SDK hlaðist á síðunni og hvort réttur vettvangur sé valinn. Val á PostHog les ekki Mixpanel.
  • Eigindið birtist aðeins á síðari atburðum: það er eðlilegt, sjá athugasemd í kafla 3.
  • Vefslóðin er til en ekki auðkennið: SDK hefur ekki enn úthlutað distinct_id og það er eðlilegt áður en notandi er auðkenndur. Það verður lesið við síðari síðuhleðslu.
  • Þú prófar sem innskráður stjórnandi: sumar uppsetningar útiloka innri umferð. Prófaðu einkaglugga.

Öll vörumerki sem nefnd eru hér tilheyra eigendum sínum. MousePlayer er ekki í viðskiptasambandi við þessa þjónustuaðila.