Bridge ng PostHog, Mixpanel at Amplitude

1. Ang Problema: Mga Bilang na Walang Mukha

Nagbibigay ang pagsusuri ng produkto ng funnel: 1,000 user ang umabot sa checkout, 620 ang umalis. Tumpak nitong sinusukat ang problemang hindi pa ninyo nakikita. Karaniwang nasasagot ang tanong sa ilang minuto sa panonood ng ilan sa 620 recording na iyon — basta makapunta kayo mula sa chart sa tamang mga session nang hindi nag-e-export ng mga ID at manu-manong naghahanap.

Inaalis ng Product Analytics Bridge ang puwang na iyon. Gumagana ito sa loob ng mp.js at awtomatikong inuugnay ang dalawang sistema:

Papalabas: bawat event na itinatala ng inyong analytics tool ay may property na mouseplayer_session_url. Buksan ang anumang event, i-click ang link, at panoorin ang session.
Papasok: binabasa ang distinct_id ng bisita at iniimbak sa session ng MousePlayer, kaya mahahanap ang mga recording gamit ang pagkakakilanlang ginagamit na ninyo sa PostHog, Mixpanel o Amplitude.

Walang kailangang code. Kusang nakikita ng bridge ang analytics SDK. Hindi ninyo kailangang tumawag ng anumang function ng MousePlayer o baguhin kung paano ninyo sinusubaybayan ang mga event.

2. Pag-activate

Paraan A: Dashboard (Walang Code)

Buksan ang inyong project at pumunta sa tab na Mga Integration.
Itakda ang Bridge ng PostHog, Mixpanel & Amplitude sa ON.
Piliin ang ginagamit ninyong platform. Awtomatikong nai-save ang mga pagbabago.

Magkakabisa ang setting sa susunod na pag-load ng pahina ng inyong website. Hindi nito binabago ang mga naunang session.

Paraan B: Manu-manong Configuration ng Script

Kung mas gusto ninyong ilagay ito sa code, itakda ang dalawang value sa loob ng window.mp_config:

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

3. Ano ang Nangyayari sa Bawat Platform

Magkakaiba ang API ng bawat platform, kaya ginagamit ng bridge ang karaniwang tawag para sa bawat isa. Hindi ninyo ito kailangang i-configure — sinusunod nito ang napili ninyong provider.

Platform	Papalabas (URL ng replay)	Papasok (pagkakakilanlan)
PostHog	`posthog.register()` — nirerehistro bilang super property, kaya kasama ito sa bawat susunod na event	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — kaparehong asal ng super property	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — itinatakda bilang user property	`getDeviceId()`, at gumagamit ng `getInstance().options.deviceId` sa lumang SDK kung kailangan

Super property at user property: sa PostHog at Mixpanel, idinadagdag ang URL ng replay sa mga susunod na event, kaya makikita ninyo ito sa bawat event na ipinadala matapos magsimula ang bridge — hindi sa mga event na naipadala na bago iyon sa pag-load ng pahina.

4. Pagkakakilanlan: Mula sa distinct_id Patungo sa Session na May Pangalan

Madalas maliitin ng mga team ang papasok na bahagi. Kung wala ito, anonymous ang mga session ng MousePlayer: mapapanood ninyo ang mga ito, ngunit hindi ninyo masasagot ang “ipakita ang mga recording ng account na hindi na bumalik noong nakaraang linggo.”

Kapag aktibo na ang bridge, ang distinct_id mula sa inyong analytics tool ay isinusulat sa field ng session na custom_user_id — ang field ding sinusulatan ng manu-manong tawag sa SDK:

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

Kung tinatawag na ninyo mismo ang mp('set'), ipagpatuloy iyon. Mas maaasahan ang pagkakakilanlang tahasan ninyong ibinibigay, dahil sarili ninyong primary key iyon sa halip na analytics identifier na nakabatay sa browser.

Paalala sa privacy: ang identifier lamang na naitalaga na ng inyong analytics tool ang inililipat. Walang binabasang email address, pangalan o ibang personal na field mula sa SDK. Tiyaking saklaw ito ng inyong patakaran sa privacy, at patakbuhin lamang ang tracking script pagkatapos ng pahintulot mula sa inyong consent tool kung pahintulot ang inyong legal na batayan.

5. Teknikal na Asal

Karaniwang asynchronous ang pag-load ng mga analytics SDK, at madalas ay pagkatapos nang tumakbo ang mp.js. Kaya mabibigo sa karamihan ng tunay na website ang isang pagtatangka lamang sa pagsisimula.

Muling sumusubok ang bridge tuwing 1.5 segundo, hanggang sampung beses, at humihinto kapag natapos na ang parehong direksiyon.
Hiwalay na natatapos ang bawat direksiyon, kaya hindi naipapadala nang dalawang beses ang URL ng replay habang hinihintay ang pagkakakilanlan.
Kung hindi kailanman lumitaw ang SDK, tahimik na humihinto ang bridge pagkalipas ng humigit-kumulang 15 segundo. Walang isinusulat sa console at nagpapatuloy ang recording ng session.
Binabalewala ang mga identifier na lampas sa 128 character sa halip na putulin, upang hindi mag-imbak ng kalahating identifier na wala namang tutugma.

6. Pagsuri Kung Gumagana

Buksan ang inyong website sa karaniwang tab ng browser at gamitin ito sandali.
Sa inyong analytics tool, buksan ang pinakabagong event at hanapin ang property na mouseplayer_session_url. Kapag binuksan ito, dapat kayong mapunta agad sa recording.
Sa MousePlayer, buksan ang User Explorer. Ipinapakita ng mga session na may pagkakakilanlan iyon sa halip na ang awtomatikong palayaw ng bisita.

Kung walang lumilitaw

Wala ang property sa lahat ng event: tiyaking talagang nilo-load ang analytics SDK sa pahina at napili ninyo ang katugmang platform. Hindi babasahin ng napiling PostHog ang Mixpanel.
Sa mga susunod na event lamang lumilitaw ang property: inaasahan ito; tingnan ang paliwanag sa seksiyon 3.
May URL ngunit walang pagkakakilanlan: hindi pa nagtatalaga ang inyong SDK ng distinct_id, na karaniwan bago matukoy ang user. Makukuha ito sa susunod na pag-load ng pahina.
Nagsusuri kayo bilang naka-login na administrator: may mga setup na hindi isinasama ang internal na trapiko. Subukan ang pribadong window.

Paano kami makakatulong?