Most pre PostHog, Mixpanel & Amplitude

Váš nástroj produktovej analytiky vám povie, čo sa stalo. MousePlayer vám ukáže, prečo. Tento most prepája oba systémy obojsmerne, takže od odchodu v lieviku vás delí jediné kliknutie k záznamu, ktorý ho vysvetľuje.

1. Problém: Čísla bez tvárí

Produktová analytika vám ukáže lievik: 1 000 používateľov sa dostalo do pokladne, 620 ju opustilo. Je to presné meranie problému, ktorý stále nevidíte. Pozretie niekoľkých z týchto 620 záznamov zvyčajne odpovie na otázku za pár minút — ale iba vtedy, ak sa z grafu dostanete k správnym reláciám bez exportu ID a ručného hľadania.

Tento most produktovej analytiky túto medzeru odstraňuje. Beží v rámci mp.js a automaticky prepája oba systémy:

  • Smerom von: každá udalosť zaznamenaná vaším analytickým nástrojom nesie vlastnosť mouseplayer_session_url. Otvorte ľubovoľnú udalosť, kliknite na odkaz a pozrite si reláciu.
  • Smerom dnu: identifikátor návštevníka distinct_id sa spätne načíta a uloží do relácie MousePlayer, takže záznamy možno vyhľadávať podľa rovnakej identity, akú už používate v PostHog, Mixpanel alebo Amplitude.

Bez potreby kódu. Most sám rozpozná analytické SDK. Nevoláte žiadnu funkciu MousePlayer a nemusíte meniť spôsob sledovania udalostí.

2. Aktivácia

Metóda A: Prehľad (bez kódu)

  1. Otvorte projekt a prejdite na kartu Integrácie.
  2. Prepnite Most pre PostHog, Mixpanel & Amplitude na ON.
  3. Vyberte platformu, ktorú používate. Zmeny sa ukladajú automaticky.

Nastavenie sa prejaví pri ďalšom načítaní stránky vášho webu. Existujúce relácie spätne neovplyvní.

Metóda B: Ručná konfigurácia skriptu

Ak uprednostňujete pevné nastavenie v kóde, nastavte tieto dve hodnoty v 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. Čo sa deje na jednotlivých platformách

Každá platforma sprístupňuje iné API, preto most používa zodpovedajúce bežné volanie pre každú z nich. Nemusíte to konfigurovať — riadi sa výberom poskytovateľa.

PlatformaSmerom von (URL prehrávania)Smerom dnu (identita)
PostHog posthog.register() — registruje sa ako spoločná vlastnosť, takže sa pripája ku každej nasledujúcej udalosti posthog.get_distinct_id()
Mixpanel mixpanel.register() — rovnaké správanie spoločnej vlastnosti mixpanel.get_distinct_id()
Amplitude setUserProperties() — nastavuje sa ako vlastnosť používateľa getDeviceId() s náhradným použitím getInstance().options.deviceId v staršom SDK

Spoločná vlastnosť oproti vlastnosti používateľa: v PostHog a Mixpanel sa URL prehrávania pripája k budúcim udalostiam, takže ju nájdete pri každej udalosti odoslanej po inicializácii mosta — nie pri udalostiach odoslaných skôr počas načítavania stránky.

4. Identita: Od distinct_id k pomenovanej relácii

Prichádzajúci smer je časť, ktorú väčšina tímov podceňuje. Bez nej sú relácie MousePlayer anonymné: môžete si ich pozrieť, ale neviete odpovedať na požiadavku „ukážte mi záznamy účtu, ktorý minulý týždeň odišiel.“

Keď je most aktívny, identifikátor distinct_id z vášho analytického nástroja sa zapíše do poľa relácie custom_user_id — rovnakého poľa, do ktorého zapisuje ručné volanie SDK:

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

Ak už sami voláte mp('set'), pokračujte v tom. Identita, ktorú zadáte výslovne, je spoľahlivejšia, pretože ide o váš vlastný primárny kľúč, a nie o analytický identifikátor prehliadača.

Poznámka k súkromiu: prenáša sa iba identifikátor, ktorý už pridelil váš analytický nástroj. Zo SDK sa nečíta e-mailová adresa, meno ani iné osobné pole. Uistite sa, že vaše oznámenie o ochrane osobných údajov pokrýva toto spracúvanie, a ak je vaším právnym základom súhlas, podmieňte spustenie sledovacieho skriptu súhlasom vo svojom nástroji.

5. Technické správanie

Analytické SDK sa zvyčajne načítavajú asynchrónne, často až keď mp.js už beží. Jediný pokus pri spustení by preto na väčšine skutočných webov zlyhal.

  • Most opakuje pokus každých 1,5 sekundy, najviac desaťkrát, a zastaví sa hneď, ako sa dokončia oba smery.
  • Každý smer sa dokončuje nezávisle, takže sa URL prehrávania pri čakaní na identitu nikdy neodošle dvakrát.
  • Ak sa SDK vôbec neobjaví, most po približne 15 sekundách potichu skončí. Do konzoly sa nič nezapíše a zaznamenávanie relácií pokračuje bez zmeny.
  • Identifikátory dlhšie než 128 znakov sa ignorujú namiesto skracovania, aby sa neukladala polovica identifikátora, ktorá by sa nikdy s ničím nezhodovala.

6. Overenie funkčnosti

  1. Otvorte web v bežnej karte prehliadača a krátko s ním pracujte.
  2. Vo svojom analytickom nástroji otvorte najnovšiu udalosť a vyhľadajte vlastnosť mouseplayer_session_url. Jej otvorenie by vás malo preniesť priamo na záznam.
  3. V MousePlayer otvorte Prieskumník používateľov. Relácie s identitou ju zobrazujú namiesto vygenerovanej prezývky návštevníka.

Ak sa nič nezobrazuje

  • Vlastnosť chýba pri všetkých udalostiach: skontrolujte, či sa analytické SDK na stránke skutočne načítava a či ste vybrali zodpovedajúcu platformu. Výber PostHog nebude čítať Mixpanel.
  • Vlastnosť sa objavuje iba pri neskorších udalostiach: to je očakávané, pozrite poznámku v oddiele 3.
  • URL je prítomná, no identita nie: vaše SDK ešte nepridelilo identifikátor distinct_id, čo je pred identifikáciou používateľa bežné. Načíta sa pri neskoršom načítaní stránky.
  • Testujete ako prihlásený administrátor: niektoré konfigurácie vylučujú internú návštevnosť. Skúste súkromné okno.

Všetky uvedené ochranné známky patria príslušným vlastníkom. MousePlayer nemá s týmito poskytovateľmi obchodný vzťah.