PostHog, Mixpanel & Amplitude tilts

Jūsu produktu analītikas rīks parāda, kas notika. MousePlayer parāda, kāpēc. Šis tilts savieno abas sistēmas abos virzienos, lai no atbiruma piltuvē līdz ierakstam, kas to izskaidro, būtu tikai viens klikšķis.

1. Problēma: skaitļi bez sejām

Produktu analītika sniedz piltuvi: 1 000 lietotāju sasniedza norēķināšanos, bet 620 to pameta. Tas ir precīzs mērījums problēmai, kuru joprojām nevarat redzēt. Noskatoties dažus no šiem 620 ierakstiem, atbildi parasti var atrast dažu minūšu laikā — taču tikai tad, ja no diagrammas varat nokļūt līdz vajadzīgajām sesijām bez ID eksportēšanas un manuālas meklēšanas.

Šo plaisu novērš produktu analītikas tilts. Tas darbojas mp.js un automātiski sasaista abas sistēmas:

  • Izejošais virziens: katram notikumam, ko reģistrē jūsu analītikas rīks, ir mouseplayer_session_url rekvizīts. Atveriet jebkuru notikumu, noklikšķiniet uz saites un skatieties sesiju.
  • Ienākošais virziens: apmeklētāja distinct_id tiek nolasīts un saglabāts MousePlayer sesijā, lai ierakstus varētu meklēt pēc tās pašas identitātes, kuru jau izmantojat PostHog, Mixpanel vai Amplitude.

Kods nav nepieciešams. Tilts pats atrod analītikas SDK. Jums nav jāizsauc neviena MousePlayer funkcija un nav jāmaina notikumu izsekošanas veids.

2. Aktivizēšana

A metode: informācijas panelis (bez koda)

  1. Atveriet savu projektu un pārejiet uz cilni Integrācijas.
  2. Pārslēdziet PostHog, Mixpanel & Amplitude tiltu uz ON.
  3. Izvēlieties izmantoto platformu. Izmaiņas tiek saglabātas automātiski.

Iestatījums stājas spēkā nākamajā jūsu vietnes lapas ielādē. Tas neietekmē jau esošās sesijas ar atpakaļejošu spēku.

B metode: manuāla skripta konfigurācija

Ja vēlaties vērtības ierakstīt tieši kodā, iestatiet abas vērtības objektā 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. Katras platformas darbība

Katra platforma nodrošina atšķirīgu API, tāpēc tilts katrai izmanto tai ierasto izsaukumu. Tas nav jākonfigurē — izsaukums atbilst jūsu izvēlētajam nodrošinātājam.

PlatformaIzejošais virziens (atskaņojuma URL)Ienākošais virziens (identitāte)
PostHog posthog.register() — reģistrēts kā superrekvizīts, tāpēc tiek pievienots katram nākamajam notikumam posthog.get_distinct_id()
Mixpanel mixpanel.register() — tāda pati superrekvizīta darbība mixpanel.get_distinct_id()
Amplitude setUserProperties() — iestatīts kā lietotāja rekvizīts getDeviceId(), izmantojot getInstance().options.deviceId kā rezerves variantu vecākajā SDK

Superrekvizīts un lietotāja rekvizīts: PostHog un Mixpanel atskaņojuma URL tiek pievienots turpmākajiem notikumiem, tāpēc to atradīsiet katrā notikumā, kas nosūtīts pēc tilta inicializēšanas — taču ne notikumos, kas tika nosūtīti agrāk šīs lapas ielādes laikā.

4. Identitāte: no distinct_id līdz sesijai ar nosaukumu

Ienākošo daļu lielākā daļa komandu novērtē par zemu. Bez tās MousePlayer sesijas ir anonīmas: tās varat skatīties, bet nevarat atbildēt uz pieprasījumu „parādiet man ierakstus par kontu, kura klients pagājušajā nedēļā aizgāja“.

Kad tilts ir aktīvs, jūsu analītikas rīka distinct_id tiek ierakstīts sesijas custom_user_id laukā — tajā pašā laukā, kurā raksta manuālais SDK izsaukums:

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

Ja jau paši izsaucat mp('set'), turpiniet to darīt. Jūsu skaidri norādīta identitāte ir uzticamāka, jo tā ir jūsu pašu primārā atslēga, nevis pārlūkam piesaistīts analītikas identifikators.

Piezīme par privātumu: tiek pārsūtīts tikai identifikators, kuru jūsu analītikas rīks jau ir piešķīris. No SDK netiek nolasīta e-pasta adrese, vārds vai citi personas datu lauki. Pārliecinieties, ka jūsu privātuma politika aptver šo apstrādi, un, ja par tiesisko pamatu izmantojat piekrišanu, ļaujiet izsekošanas skriptam darboties tikai pēc piekrišanas saņemšanas jūsu piekrišanas rīkā.

5. Tehniskā darbība

Analītikas SDK parasti tiek ielādēti asinhroni, bieži vien pēc tam, kad mp.js jau darbojas. Tāpēc viens mēģinājums palaišanas brīdī vairumā reālu vietņu būtu neveiksmīgs.

  • Tilts atkārto mēģinājumu ik pēc 1,5 sekundēm, līdz desmit reizēm, un pārtrauc, tiklīdz abi virzieni ir pabeigti.
  • Katrs virziens tiek pabeigts neatkarīgi, tāpēc atskaņojuma URL nekad netiek nosūtīts divreiz, gaidot, līdz parādīsies identitāte.
  • Ja SDK tā arī neparādās, tilts pēc aptuveni 15 sekundēm klusi pārtrauc mēģinājumus. Konsolē nekas netiek ierakstīts, un sesijas ierakstīšana turpinās bez izmaiņām.
  • Identifikatori, kas garāki par 128 rakstzīmēm, tiek ignorēti, nevis saīsināti, lai netiktu saglabāta identifikatora daļa, kas nekad nekam neatbilstu.

6. Darbības pārbaude

  1. Atveriet savu vietni parastā pārlūka cilnē un īsu brīdi to izmantojiet.
  2. Savā analītikas rīkā atveriet jaunāko notikumu un meklējiet mouseplayer_session_url rekvizītu. Atverot to, jums vajadzētu nokļūt tieši pie ieraksta.
  3. MousePlayer atveriet lietotāju pārlūku. Sesijās ar identitāti tā tiek parādīta ģenerētās apmeklētāja iesaukas vietā.

Ja nekas neparādās

  • Rekvizīta nav nevienā notikumā: pārbaudiet, vai lapā tiešām tiek ielādēts analītikas SDK un vai esat izvēlējušies atbilstošo platformu. Izvēloties PostHog, Mixpanel dati netiks nolasīti.
  • Rekvizīts parādās tikai vēlākajos notikumos: tā ir paredzētā darbība; skatiet piezīmi 3. sadaļā.
  • URL ir, bet identitātes nav: jūsu SDK vēl nav piešķīris distinct_id, un tas ir normāli, pirms lietotājs ir identificēts. Identitāte tiks nolasīta kādā no nākamajām lapas ielādēm.
  • Pārbaudāt kā pieteicies administrators: dažās konfigurācijās iekšējā datplūsma tiek izslēgta. Izmēģiniet privāto logu.

Visas šeit minētās preču zīmes pieder to attiecīgajiem īpašniekiem. MousePlayer nav darījumu attiecību ar šiem nodrošinātājiem.