Ibhuloho lokuhlaziya umkhiqizo

1. Inkinga: izinombolo ezingenabuso

Ukuhlaziya umkhiqizo kukunika ifaneli: abasebenzisi abangu-1,000 bafinyelele ekukhokheni, abangu-620 bakushiya. Lokho kungukulinganisa okunembile kwenkinga ongakayiboni. Ukubuka okumbalwa kulokho okurekhodiwe okungu-620 kuvamise ukuphendula umbuzo ngemizuzu — kodwa kuphela uma ungakwazi ukusuka eshadini uye kumaseshini afanele ngaphandle kokuthekelisa ama-ID nokusesha ngesandla.

Ibhuloho elithi Ukuhlaziya Umkhiqizo livala leso sikhala. Lisebenza ngaphakathi kwe- mp.js bese lixhumanisa izinhlelo ezimbili ngokuzenzakalela:

Okuphumayo: zonke izehlakalo ezirekhodwa yithuluzi lakho lokuhlaziya ziqukethe isici esithi mouseplayer_session_url . Vula noma yisiphi isehlakalo, uchofoze isixhumanisi, ubuke iseshini.
Okungenayo: isihlonzi sesivakashi esithi distinct_id siyafundwa sibuyiswe bese sigcinwa kuseshini ye-MousePlayer, ukuze okurekhodiwe kusesheke ngobunikazi obufanayo osuvele ubusebenzisa ku-PostHog, Mixpanel noma Amplitude.

Akudingeki ikhodi. Ibhuloho lithola i-SDK yokuhlaziya ngokwalo. Awubizi noma yimuphi umsebenzi we-MousePlayer, futhi akudingeki ushintshe indlela olandelela ngayo izehlakalo.

2. Ukuvula

Indlela A: ideshibhodi (ngaphandle kwekhodi)

Vula iphrojekthi yakho uye kuthebhu ethi Ukuhlanganisa .
Shintsha Ibhuloho le-PostHog, Mixpanel & Amplitude kube ON.
Khetha inkundla oyisebenzisayo. Izinguquko zigcinwa ngokuzenzakalela.

Isilungiselelo sisebenza lapho iwebhusayithi yakho ilayisha ikhasi ngokulandelayo. Amaseshini akhona awathinteki ngokubuyela emuva.

Indlela B: ukusetha umbhalo wohlelo ngesandla

Uma ukhetha ukukufaka ngokuqondile kukhodi, setha amanani amabili ngaphakathi kwe- window.mp_config:

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

3. Okwenzeka kunkundla ngayinye

Inkundla ngayinye iveza i-API ehlukile, ngakho ibhuloho lifanisa ukubiza okujwayelekile kwaleyo naleyo. Akudingeki ukusetha lokhu — kulandela umhlinzeki omkhethile.

Inkundla	Okuphumayo (i-URL yokudlala kabusha)	Okungenayo (ubunikazi)
PostHog	`posthog.register()` — kubhaliswa njengesici esikhulu, ngakho kunamathiselwa kuzo zonke izehlakalo ezilandelayo	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — ukusebenza okufanayo kwesici esikhulu	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — kusethwa njengesici somsebenzisi	`getDeviceId()`, kubuyelwe ku- `getInstance().options.deviceId` ku-SDK endala

Isici esikhulu nesici somsebenzisi: ku-PostHog ne-Mixpanel i-URL yokudlala kabusha inamathiselwa ezehlakalweni eziya phambili, ngakho uzoyithola kuzo zonke izehlakalo ezenzeka ngemva kokuqalisa kwebhuloho — hhayi kwezehlakalo ezase zithunyelwe ngaphambili ngesikhathi sokulayisha ikhasi.

4. Ubunikazi: kusuka ku-distinct_id kuya kuseshini enegama

Ingxenye engenayo yiyona amaqembu amaningi ayibukela phansi. Ngaphandle kwayo, amaseshini e-MousePlayer awaziwa: ungawabuka, kodwa awukwazi ukuphendula ukuthi “ngibonise okurekhodiwe kwe-akhawunti eyeka ukubuya ngesonto eledlule.”

Uma ibhuloho selivuliwe, isihlonzi esithi distinct_id esivela ethuluzini lakho lokuhlaziya sibhalwa ku- custom_user_id enkambini yeseshini — yona le nkambu ebhalwa ukubiza ngesandla kwe-SDK:

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

Uma usuvele ubiza mp('set') ngokwakho, qhubeka wenza njalo. Ubunikazi obunikeza ngokusobala buthembeke kakhulu ngoba buwukhiye wakho oyinhloko kunokuba bube isihlonzi sokuhlaziya sesiphequluli ngasinye.

Inothi lobumfihlo: kudluliswa isihlonzi ithuluzi lakho lokuhlaziya eselisabelile kuphela. Akufundwa ikheli le-imeyili, igama noma enye inkambu yomuntu siqu ku-SDK. Qinisekisa ukuthi inqubomgomo yakho yobumfihlo ihlanganisa lokhu kucubungula, futhi ubeke umbhalo wohlelo wokulandelela ngaphansi kwethuluzi lakho lemvume uma uncike emvume njengesisekelo sakho esisemthethweni.

5. Ukusebenza kwezobuchwepheshe

Ama-SDK okuhlaziya ngokuvamile alayishwa ngokuzimela, kaningi ngemva kokuba mp.js isisebenza. Ngakho ukuzama kanye ekuqaleni bekuzohluleka kumawebhusayithi amaningi angempela.

Ibhuloho liphinda lizame njalo ngemva kwemizuzwana engu-1.5, kuze kube izikhathi eziyishumi, bese liyama lapho zombili izinhlangothi seziqedile.
Uhlangothi ngalunye luqeda ngokuzimela, ngakho i-URL yokudlala kabusha ayithunyelwa kabili ngesikhathi kulindwe ubunikazi ukuthi buvele.
Uma i-SDK ingaveli nhlobo, ibhuloho liyayeka buthule ngemva kwemizuzwana ecishe ibe ngu-15. Akubhalwa lutho kukhonsoli futhi ukurekhoda amaseshini kuyaqhubeka kungathintekile.
Izihlonzi ezinde kunezinhlamvu ezingu-128 ziyazitshwa kunokuba zinqanyulwe, ukuze kungagcinwa uhhafu wesihlonzi obungasoze wafana nalutho.

6. Ukuqinisekisa ukuthi kuyasebenza

Vula iwebhusayithi yakho kuthebhu yesiphequluli ejwayelekile bese uxhumana nayo kafushane.
Ethuluzini lakho lokuhlaziya, vula isehlakalo esisha kakhulu bese ubheka isici esithi mouseplayer_session_url . Ukusivula kufanele kukuyise ngqo ekurekhodweni.
Ku-MousePlayer, vula Isihloli Sabasebenzisi. Amaseshini anobunikazi abubonisa esikhundleni sesidlaliso sesivakashi esikhiqiziwe.

Uma kungaveli lutho

Isici asikho kuzo zonke izehlakalo: hlola ukuthi i-SDK yokuhlaziya ilayisha ngempela ekhasini, nokuthi ukhethe inkundla efanayo. Ukukhetha i-PostHog ngeke kufunde i-Mixpanel.
Isici sivela ezehlakalweni zakamuva kuphela: lokho kulindelekile, bheka inothi esigabeni 3.
I-URL ikhona kodwa ubunikazi abukho: i-SDK yakho ayikabeli isihlonzi esithi distinct_id okwamanje, okujwayelekile ngaphambi kokuhlonzwa komsebenzisi. Sizothathwa lapho ikhasi lilayisha kamuva.
Uhlola njengomphathi ongenile: okunye ukusetha akuyifaki ithrafikhi yangaphakathi. Zama iwindi eliyimfihlo.

Singakusiza kanjani?