Pont PostHog, Mixpanel ac Amplitude

1. Y Broblem: Rhifau Heb Wynebau

Mae dadansoddeg cynnyrch yn rhoi twndis i chi: cyrhaeddodd 1,000 o ddefnyddwyr y ddesg dalu, gadawodd 620 ohonynt. Mesuriad manwl yw hwn o broblem na allwch ei gweld o hyd. Mae gwylio dyrnaid o’r 620 recordiad hynny fel arfer yn ateb y cwestiwn mewn munudau — ond dim ond os gallwch fynd o’r siart i’r sesiynau cywir heb allforio IDs a chwilio â llaw.

Mae’r Bont Dadansoddeg Cynnyrch yn dileu’r bwlch hwnnw. Mae’n rhedeg y tu mewn i mp.js ac yn cysylltu’r ddwy system yn awtomatig:

Allan: mae pob digwyddiad y mae eich offeryn dadansoddeg yn ei recordio yn cynnwys priodwedd mouseplayer_session_url. Agorwch unrhyw ddigwyddiad, cliciwch y ddolen, gwyliwch y sesiwn.
I mewn: caiff dynodwr yr ymwelydd, distinct_id, ei ddarllen yn ôl a’i storio ar y sesiwn MousePlayer, felly gellir chwilio recordiadau yn ôl yr un hunaniaeth rydych eisoes yn ei defnyddio yn PostHog, Mixpanel neu Amplitude.

Dim angen cod. Mae’r bont yn canfod y SDK dadansoddeg ei hun. Nid ydych yn galw unrhyw swyddogaeth MousePlayer, ac nid oes rhaid newid sut rydych yn tracio digwyddiadau.

2. Actifadu

Dull A: Dangosfwrdd (Heb God)

Agorwch eich prosiect ac ewch i’r tab Integreiddiadau.
Newidiwch Pont PostHog, Mixpanel & Amplitude i ON.
Dewiswch y platfform rydych yn ei ddefnyddio. Cedwir newidiadau’n awtomatig.

Daw’r gosodiad i rym y tro nesaf y llwythir tudalen eich gwefan. Nid effeithir ar sesiynau presennol yn ôl-weithredol.

Dull B: Ffurfweddu’r Sgript â Llaw

Os yw’n well gennych ei ysgrifennu’n uniongyrchol yn y cod, gosodwch y ddau werth yn window.mp_config:

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

3. Beth Sy’n Digwydd ar Bob Platfform

Mae pob platfform yn darparu API gwahanol, felly mae’r bont yn mapio i’r alwad arferol ar gyfer pob un. Nid oes angen i chi ffurfweddu hyn — mae’n dilyn eich dewis darparwr.

Platfform	Allan (URL ailchwarae)	I mewn (hunaniaeth)
PostHog	`posthog.register()` — wedi’i gofrestru fel uwchbriodwedd, felly fe’i hatodir at bob digwyddiad dilynol	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — yr un ymddygiad uwchbriodwedd	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — wedi’i osod fel priodwedd defnyddiwr	`getDeviceId()`, gyda `getInstance().options.deviceId` wrth gefn ar y SDK hŷn

Uwchbriodwedd yn erbyn priodwedd defnyddiwr: yn PostHog a Mixpanel caiff yr URL ailchwarae ei atodi at ddigwyddiadau o hyn ymlaen, felly fe’i cewch ar bob digwyddiad a sbardunir ar ôl i’r bont gychwyn — nid ar ddigwyddiadau a anfonwyd eisoes yn gynharach wrth lwytho’r dudalen.

4. Hunaniaeth: O distinct_id i Sesiwn ag Enw

Yr hanner sy’n dod i mewn yw’r rhan y mae’r rhan fwyaf o dimau’n ei thanbrisio. Hebddi, mae sesiynau MousePlayer yn ddienw: gallwch eu gwylio, ond ni allwch ateb ‘dangoswch recordiadau’r cyfrif a beidiodd â dychwelyd yr wythnos ddiwethaf i mi.’

Unwaith y bydd y bont yn weithredol, ysgrifennir y distinct_id o’ch offeryn dadansoddeg i faes custom_user_id y sesiwn — yr un maes y mae’r alwad SDK â llaw yn ysgrifennu iddo:

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

Os ydych eisoes yn galw mp('set') eich hun, parhewch i wneud hynny. Mae hunaniaeth rydych yn ei darparu’n benodol yn fwy dibynadwy, gan mai eich allwedd gynradd eich hun ydyw yn hytrach na dynodwr dadansoddeg fesul porwr.

Nodyn preifatrwydd: dim ond y dynodwr y mae eich offeryn dadansoddeg eisoes wedi’i neilltuo a drosglwyddir. Ni ddarllenir cyfeiriad e-bost, enw nac unrhyw faes personol arall o’r SDK. Sicrhewch fod eich polisi preifatrwydd eich hun yn cwmpasu’r prosesu hwn, a rhowch y sgript tracio y tu ôl i’ch offeryn cydsynio os ydych yn dibynnu ar gydsyniad fel eich sail gyfreithiol.

5. Ymddygiad Technegol

Mae SDKs dadansoddeg fel arfer yn llwytho’n anghydamserol, yn aml ar ôl i mp.js ddechrau rhedeg eisoes. Felly byddai un cynnig wrth gychwyn yn methu ar y rhan fwyaf o wefannau go iawn.

Mae’r bont yn ailgeisio bob 1.5 eiliad, hyd at ddeg gwaith, ac yn stopio cyn gynted ag y bydd y ddau gyfeiriad wedi’u cwblhau.
Mae pob cyfeiriad yn cwblhau’n annibynnol, felly ni anfonir yr URL ailchwarae ddwywaith byth wrth aros i hunaniaeth ymddangos.
Os nad yw’r SDK byth yn ymddangos, mae’r bont yn rhoi’r gorau iddi’n dawel ar ôl tua 15 eiliad. Ni ysgrifennir dim i’r consol ac mae recordio sesiynau’n parhau heb effaith.
Anwybyddir dynodwyr sy’n hwy na 128 nod yn lle eu cwtogi, er mwyn osgoi storio hanner dynodwr na fyddai byth yn cyfateb i ddim.

6. Gwirio Ei Fod yn Gweithio

Agorwch eich gwefan mewn tab porwr arferol a rhyngweithiwch â hi am ychydig.
Yn eich offeryn dadansoddeg, agorwch y digwyddiad diweddaraf a chwiliwch am y briodwedd mouseplayer_session_url. Dylai ei hagor fynd â chi’n syth at y recordiad.
Yn MousePlayer, agorwch User Explorer. Mae sesiynau sy’n cynnwys hunaniaeth yn ei dangos yn lle’r llysenw ymwelydd a gynhyrchwyd.

Os nad oes dim yn ymddangos

Mae’r briodwedd ar goll o bob digwyddiad: gwiriwch fod y SDK dadansoddeg yn llwytho ar y dudalen mewn gwirionedd, a’ch bod wedi dewis y platfform cyfatebol. Ni fydd dewis PostHog yn darllen Mixpanel.
Dim ond ar ddigwyddiadau diweddarach mae’r briodwedd yn ymddangos: disgwylir hynny, gweler y nodyn yn adran 3.
Mae’r URL yno ond nid yr hunaniaeth: nid yw eich SDK wedi neilltuo distinct_id eto, sy’n arferol cyn adnabod defnyddiwr. Fe’i cesglir wrth lwytho tudalen yn ddiweddarach.
Rydych yn profi fel gweinyddwr wedi mewngofnodi: mae rhai gosodiadau’n eithrio traffig mewnol. Rhowch gynnig ar ffenestr breifat.

Sut gallwn helpu?