PostHog, Mixpanel & Amplitude integracijos tiltas

Jūsų produkto analitikos įrankis parodo, kas įvyko. MousePlayer parodo, kodėl. Šis tiltas sujungia abi puses abiem kryptimis, todėl nuo pasitraukimo piltuvėlyje iki jį paaiškinančio įrašo lieka vienas paspaudimas.

1. Problema: skaičiai be veidų

Produkto analitika pateikia piltuvėlį: atsiskaitymą pasiekė 1 000 naudotojų, 620 jį paliko. Tai tikslus problemos, kurios vis dar nematote, matavimas. Peržiūrėjus kelis iš tų 620 įrašų, atsakymas dažniausiai paaiškėja per kelias minutes — bet tik jei nuo diagramos iki reikiamų seansų galite pereiti neeksportuodami ID ir neieškodami rankomis.

Šis produkto analitikos integracijos tiltas pašalina spragą. Jis veikia mp.js ir automatiškai susieja abi sistemas:

  • Į išorę: kiekvienas jūsų analitikos įrankio įrašomas įvykis turi mouseplayer_session_url savybę. Atidarykite bet kurį įvykį, spustelėkite nuorodą ir žiūrėkite seansą.
  • Į vidų: lankytojo distinct_id nuskaitomas ir saugomas MousePlayer seanse, todėl įrašų galima ieškoti pagal tą pačią tapatybę, kurią jau naudojate PostHog, Mixpanel ar Amplitude.

Kodo nereikia. Tiltas pats aptinka analitikos SDK. Jokių MousePlayer funkcijų kviesti nereikia ir įvykių sekimo keisti nereikia.

2. Aktyvavimas

A būdas: suvestinė (be kodo)

  1. Atidarykite projektą ir pereikite į kortelę Integracijos.
  2. Nustatykite PostHog, Mixpanel & Amplitude integracijos tiltą į ON.
  3. Pasirinkite naudojamą platformą. Pakeitimai išsaugomi automatiškai.

Nustatymas įsigalioja kitą kartą įkėlus jūsų svetainės puslapį. Esamiems seansams atgaline data netaikomas.

B būdas: rankinis scenarijaus konfigūravimas

Jei norite įrašyti tiesiogiai kode, nustatykite šias dvi reikšmes 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. Kas vyksta kiekvienoje platformoje

Kiekviena platforma pateikia skirtingą API, todėl tiltas kiekvienai naudoja įprastą jai kvietimą. To konfigūruoti nereikia — tai priklauso nuo pasirinkto teikėjo.

PlatformaĮ išorę (atkūrimo URL)Į vidų (tapatybė)
PostHog posthog.register() — registruojama kaip super property, todėl pridedama prie kiekvieno vėlesnio įvykio posthog.get_distinct_id()
Mixpanel mixpanel.register() — toks pats super property veikimas mixpanel.get_distinct_id()
Amplitude setUserProperties() — nustatoma kaip naudotojo savybė getDeviceId(), o senajame SDK naudojama getInstance().options.deviceId kaip atsarginis būdas

Super property ir naudotojo savybė: PostHog ir Mixpanel atkūrimo URL pridedamas prie būsimų įvykių, todėl jį rasite kiekviename įvykyje po tilto inicijavimo — ne įvykiuose, kurie jau išsiųsti ankstesniame puslapio įkėlimo etape.

4. Tapatybė: nuo distinct_id iki įvardyto seanso

Įeinanti dalis yra ta, kurią dauguma komandų nuvertina. Be jos MousePlayer seansai anoniminiai: galite juos žiūrėti, bet negalite atsakyti į užklausą „parodykite praėjusią savaitę prarastos paskyros įrašus“.

Kai tiltas aktyvus, jūsų analitikos įrankio distinct_id įrašomas į seanso lauką custom_user_id — tą patį lauką, į kurį rašo rankinis SDK kvietimas:

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

Jei jau patys kviečiate mp('set'), ir toliau tai darykite. Jūsų aiškiai pateikta tapatybė patikimesnė, nes tai jūsų pirminis raktas, o ne atskiros naršyklės analitikos identifikatorius.

Privatumo pastaba: perduodamas tik identifikatorius, kurį analitikos įrankis jau priskyrė. Iš SDK nenuskaitomas el. pašto adresas, vardas ar kitas asmens duomenų laukas. Įsitikinkite, kad jūsų privatumo politika apima šį tvarkymą, ir užblokuokite sekimo scenarijų sutikimo įrankiu, jei sutikimas yra jūsų teisinis pagrindas.

5. Techninis veikimas

Analitikos SDK paprastai įkeliami asinchroniškai, dažnai tada, kai mp.js jau veikia. Todėl vienas bandymas paleidžiant daugumoje tikrų svetainių nepavyktų.

  • Tiltas bando kas 1,5 sekundės, iki dešimties kartų, ir sustoja, kai baigtos abi kryptys.
  • Kiekviena kryptis baigiama atskirai, todėl atkūrimo URL niekada nesiunčiamas du kartus laukiant tapatybės.
  • Jei SDK taip ir nepasirodo, tiltas po maždaug 15 sekundžių tyliai nustoja bandyti. Į konsolę nieko nerašoma, o seanso įrašymas tęsiasi nepaveiktas.
  • Ilgesni nei 128 ženklų identifikatoriai ignoruojami, o ne trumpinami, kad nebūtų saugoma pusė identifikatoriaus, kuri niekada nieko neatitiktų.

6. Veikimo patikrinimas

  1. Atidarykite savo svetainę įprastoje naršyklės kortelėje ir trumpai su ja sąveikaukite.
  2. Analitikos įrankyje atidarykite naujausią įvykį ir ieškokite savybės mouseplayer_session_url. Atidarius ją turėtų būti iš karto parodytas įrašas.
  3. MousePlayer atidarykite Naudotojų naršyklę. Seansai su tapatybe ją rodo vietoje sugeneruoto lankytojo slapyvardžio.

Jei nieko nerodoma

  • Savybės nėra nė viename įvykyje: patikrinkite, ar analitikos SDK iš tikrųjų įkeliamas puslapyje ir ar pasirinkote atitinkamą platformą. Pasirinkus PostHog nebus skaitoma Mixpanel.
  • Savybė rodoma tik vėlesniuose įvykiuose: tai numatyta, žr. pastabą 3 skyriuje.
  • URL yra, bet tapatybės nėra: jūsų SDK dar nepriskyrė distinct_id; tai normalu, kol naudotojas neidentifikuotas. Jis bus paimtas vėliau įkėlus puslapį.
  • Bandote prisijungę kaip administratorius: kai kurios sąrankos neįtraukia vidinio srauto. Bandykite privačiame lange.

Visi čia paminėti prekių ženklai priklauso jų savininkams. MousePlayer su šiais teikėjais neturi verslo ryšių.