Uqhagamshelo lwePostHog, Mixpanel & Amplitude

Isixhobo sakho sohlalutyo lwemveliso sikuxelela okwenzekileyo . IMousePlayer ikubonisa isizathu. Olu qhagamshelo ludibanisa ezi zimbini kumacala omabini, ukuze ukusuka ekuphumeni kwifaneli ukuya ekurekhodweni okukuchazayo kufune ukucofa kube kanye.

1. Ingxaki: amanani angenabuso

Uhlalutyo lwemveliso lukunika ifaneli: abasebenzisi abayi-1,000 bafikelele ekuhlawuleni, abayi-620 bakushiya. Lowo ngumlinganiselo ochanekileyo wengxaki ongakwaziyo ukuyibona. Ukubukela ezimbalwa kwezo rekhodi ziyi-620 kudla ngokuwuphendula umbuzo ngemizuzu — kodwa kuphela xa unokusuka kwitshathi uye kwiiseshoni ezifanelekileyo ngaphandle kokukhupha ii-ID uze uzikhangele ngesandla.

Uqhagamshelo lohlalutyo lwemveliso luvala eso sikhewu. Lusebenza ngaphakathi kwe mp.js luze ludibanise ezi nkqubo zimbini ngokuzenzekelayo:

  • Okuphumayo: isiganeko ngasinye esirekhodwa sisixhobo sakho sohlalutyo sithwala ipropati ethi mouseplayer_session_url . Vula nasiphi na isiganeko, cofa ikhonkco, uze ubukele iseshoni.
  • Okungenayo: isichongi sondwendwe esithi distinct_id sifundwa sigcinwe kwiseshoni yeMousePlayer, ukuze ukurekhoda kukhangelwe ngesichongi esifanayo osele usisebenzisa kwiPostHog, Mixpanel okanye Amplitude.

Akufuneki khowudi. Uqhagamshelo luyibona ngokwalo i-SDK yohlalutyo. Awubizi naliphi na ifankshini yeMousePlayer, kwaye akufuneki utshintshe indlela olandelela ngayo iziganeko.

2. Ukuvula

Indlela A: ideshibhodi (ngaphandle kwekhowudi)

  1. Vula iprojekthi yakho uze uye kwithebhu ethi Uqhagamshelo .
  2. Tshintshela Uqhagamshelo lwePostHog, Mixpanel & Amplitude ku ON.
  3. Khetha iqonga olisebenzisayo. Utshintsho lugcinwa ngokuzenzekelayo.

Olu seto luqala ukusebenza xa iphepha lewebhusayithi yakho lilayishwa kwakhona. Iiseshoni esele zikho azitshintshwa emva kwexesha.

Indlela B: ukuseta isikripthi ngesandla

Ukuba ukhetha ukubhala useto ngqo kwikhowudi, seta amaxabiso amabini ngaphakathi kwe 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. Okwenzekayo kwiqonga ngalinye

Iqonga ngalinye line-API eyahlukileyo, ngoko uqhagamshelo lusebenzisa ubizo olufanelekileyo kwiqonga ngalinye. Akufuneki ukusete oku — kulandela umboneleli omkhethileyo.

IqongaOkuphumayo (i-URL yokudlala kwakhona)Okungenayo (isichongi)
PostHog posthog.register() — ibhaliswa njengepropati ephezulu, ukuze iqhotyoshelwe kwisiganeko ngasinye esilandelayo posthog.get_distinct_id()
Mixpanel mixpanel.register() — indlela efanayo yokusebenza kwepropati ephezulu mixpanel.get_distinct_id()
Amplitude setUserProperties() — isetwa njengepropati yomsebenzisi getDeviceId(), kuze kusetyenziswe getInstance().options.deviceId kwi-SDK endala xa kufuneka

Ipropati ephezulu nepropati yomsebenzisi: kwiPostHog nakwiMixpanel, i-URL yokudlala kwakhona iqhotyoshelwa kwiziganeko ezilandelayo, ngoko uyifumana kwisiganeko ngasinye esithunyelwa emva kokuba uqhagamshelo luqalile — ayikho kwiziganeko esele zithunyelwe ngaphambili xa iphepha belilayishwa.

4. Isichongi: ukusuka kwi-distinct_id ukuya kwiseshoni enegama

Icala lokungenayo lelona maqela amaninzi alijongela phantsi. Ngaphandle kwalo, iiseshoni zeMousePlayer azichongi mntu: unokuzibukela, kodwa awukwazi ukuphendula isicelo esithi “ndibonise ukurekhoda kweakhawunti eyekile ukusebenzisa inkonzo kwiveki ephelileyo.”

Xa uqhagamshelo luvuliwe, isichongi esithi distinct_id esivela kwisixhobo sakho sohlalutyo sibhalwa kwindawo yeseshoni ethi custom_user_id — kwindawo efanayo naleyo ibhalwa lubizo lwe-SDK olwenziwa ngesandla:

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

Ukuba sele ubiza mp('set') ngokwakho, qhubeka njalo. Isichongi osinika ngokucacileyo sithembeke ngakumbi, kuba sisitshixo sakho esisiseko endaweni yesichongi sohlalutyo esahluka ngokwesikhangeli.

Inqaku lobumfihlo: kudluliselwa kuphela isichongi esele sinikwe sisixhobo sakho sohlalutyo. Akukho dilesi yeimeyile, gama okanye enye indawo yedatha yobuqu efundwa kwi-SDK. Qinisekisa ukuba umgaqo-nkqubo wakho wobumfihlo ukuquka oku kusetyenziswa kwedatha, uze ulawule ukuqalisa kwesikripthi sokulandelela ngesixhobo sakho semvume ukuba usebenzisa imvume njengesiseko esisemthethweni.

5. Indlela yokusebenza yobugcisa

Ii-SDK zohlalutyo zidla ngokulayishwa ngokuzimeleyo, amaxesha amaninzi emva kokuba mp.js sele isebenza. Ngoko ukuzama kube kanye ekuqaleni kungasilela kwiiwebhusayithi ezininzi ezisetyenziswayo.

  • Uqhagamshelo luzama kwakhona qho emva kwemizuzwana eyi-1.5, ukuya kutsho kwizihlandlo ezilishumi, luze lume kwakamsinya nje ukuba omabini amacala agqibile.
  • Icala ngalinye ligqiba ngokuzimeleyo, ngoko i-URL yokudlala kwakhona ayithunyelwa kabini ngoxa kusalindwe ukuba isichongi sivele.
  • Ukuba i-SDK ayiveli, uqhagamshelo luyayeka luzolile emva kwemizuzwana emalunga ne-15. Akukho nto ibhalwa kwikhonsoli kwaye ukurekhodwa kweseshoni kuyaqhubeka kungachaphazelekanga.
  • Izichongi ezinde ngaphezu koonobumba abayi-128 azisetyenziswa endaweni yokunqunyulwa, ukuze kungagcinwa isiqingatha sesichongi esingenakuze sihambelane nantoni na.

6. Ukuqinisekisa ukuba iyasebenza

  1. Vula iwebhusayithi yakho kwithebhu yesikhangeli eqhelekileyo uze uyisebenzise kancinane.
  2. Kwisixhobo sakho sohlalutyo, vula esona siganeko sitsha uze ukhangele ipropati ethi mouseplayer_session_url . Ukuyivula kufanele kukuse ngqo ekurekhodweni.
  3. KwiMousePlayer, vula Umhloli wabasebenzisi. Iiseshoni ezinesichongi zisibonisa endaweni yesiteketiso sondwendwe esenziwe ngokuzenzekelayo.

Ukuba akukho nto ivelayo

  • Ipropati ayikho kuzo zonke iziganeko: jonga ukuba i-SDK yohlalutyo iyalayishwa ngokwenene kwiphepha, nokuba ukhethe iqonga elihambelanayo. Ukukhetha iPostHog akuyi kufunda iMixpanel.
  • Ipropati ivela kuphela kwiziganeko zamva: oko kulindelekile, jonga inqaku kwicandelo 3.
  • I-URL ikhona kodwa isichongi asikho: i-SDK yakho ayikaniki isichongi esithi distinct_id , nto leyo eqhelekileyo ngaphambi kokuba umsebenzisi achongwe. Siya kufundwa xa iphepha lilayishwa kamva.
  • Uvavanya njengomlawuli ongene kwiakhawunti: ezinye iindlela zokuseta azibandakanyi utyelelo lwangaphakathi. Zama ifestile yabucala.

Zonke iimpawu zorhwebo ezikhankanywe apha zezabanini bazo. IMousePlayer ayinabudlelwane bezoshishino naba baboneleli.