Most pro PostHog, Mixpanel & Amplitude

Váš nástroj produktové analytiky vám řekne, co se stalo. MousePlayer vám ukáže proč. Tento most propojuje obojí oběma směry, takže od odchodu z trychtýře je to jen jedno kliknutí k záznamu, který ho vysvětluje.

1. Problém: čísla bez tváří

Produktová analytika vám dá trychtýř: k pokladně došlo 1 000 uživatelů, 620 z nich ji opustilo. To je přesné změření problému, který ale stále nevidíte. Když zhlédnete pár z těch 620 záznamů, máte odpověď obvykle během několika minut — ovšem jen tehdy, když se z grafu dostanete ke správným relacím, aniž byste museli exportovat ID a ručně je dohledávat.

Most pro produktovou analytiku tuto mezeru odstraňuje. Běží uvnitř mp.js a oba systémy propojuje automaticky:

  • Odchozí směr: každá událost, kterou váš analytický nástroj zaznamená, nese vlastnost mouseplayer_session_url. Otevřete libovolnou událost, klikněte na odkaz a sledujte relaci.
  • Příchozí směr: distinct_id návštěvníka se načte zpět a uloží k relaci v MousePlayeru, takže záznamy lze vyhledávat podle stejné identity, kterou už používáte v PostHogu, Mixpanelu nebo Amplitude.

Bez programování. Most si analytické SDK najde sám. Nevoláte žádnou funkci MousePlayeru a nemusíte měnit způsob, jakým měříte události.

2. Aktivace

Způsob A: dashboard (bez kódu)

  1. Otevřete svůj projekt a přejděte na kartu Integrace.
  2. Přepněte Most pro PostHog, Mixpanel & Amplitude na ON.
  3. Vyberte platformu, kterou používáte. Změny se ukládají automaticky.

Nastavení začne platit při příštím načtení stránky vašeho webu. Na už existující relace zpětně nepůsobí.

Způsob B: ruční konfigurace skriptu

Pokud to raději zapíšete napevno do kódu, nastavte obě 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. Co se děje na jednotlivých platformách

Každá platforma nabízí jiné API, a most proto pro každou používá volání, které je pro ni obvyklé. Nic z toho nemusíte nastavovat — řídí se to výběrem poskytovatele.

PlatformaOdchozí směr (URL přehrávání)Příchozí směr (identita)
PostHog posthog.register() — registruje se jako super property, takže se připojí ke každé následující události posthog.get_distinct_id()
Mixpanel mixpanel.register() — stejné chování jako super property mixpanel.get_distinct_id()
Amplitude setUserProperties() — nastaví se jako user property getDeviceId(), u starší verze SDK náhradně getInstance().options.deviceId

Super property vs. user property: v PostHogu a Mixpanelu se URL přehrávání připojuje k událostem od daného okamžiku dál, najdete ji tedy u každé události odeslané po inicializaci mostu — ne u událostí, které odešly už dříve během načítání stránky.

4. Identita: od distinct_id k pojmenované relaci

Příchozí polovinu většina týmů podceňuje. Bez ní jsou relace v MousePlayeru anonymní: můžete je sledovat, ale nedokážete odpovědět na „ukaž mi záznamy účtu, který minulý týden odešel.“

Jakmile je most aktivní, zapíše se distinct_id z vašeho analytického nástroje do pole custom_user_id relace — do stejného pole, do kterého zapisuje i ruční volání SDK:

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

Pokud už mp('set') voláte sami, pokračujte v tom. Identita, kterou předáte výslovně, je spolehlivější, protože jde o váš vlastní primární klíč, a ne o analytický identifikátor vázaný na prohlížeč.

Poznámka k ochraně soukromí: přenáší se jen identifikátor, který váš analytický nástroj už přidělil. Ze SDK se nenačítá žádná e-mailová adresa, jméno ani jiný osobní údaj. Ujistěte se, že toto zpracování pokrývají vaše zásady ochrany osobních údajů, a pokud se jako právním základem řídíte souhlasem, spouštějte měřicí skript až přes svůj nástroj pro správu souhlasu.

5. Technické chování

Analytická SDK se obvykle načítají asynchronně, často až v době, kdy mp.js už běží. Jediný pokus při spuštění by proto na většině skutečných webů selhal.

  • Most to zkouší znovu každých 1,5 sekundy, nejvýše desetkrát, a skončí, jakmile jsou hotové oba směry.
  • Každý směr se vyřizuje samostatně, takže URL přehrávání se nikdy neodešle dvakrát, zatímco se čeká na identitu.
  • Pokud se SDK neobjeví vůbec, most to zhruba po 15 sekundách tiše vzdá. Do konzole se nic nezapíše a nahrávání relace pokračuje beze změny.
  • Identifikátory delší než 128 znaků se ignorují, nezkracují se – aby se neukládala polovina identifikátoru, která by nikdy s ničím neodpovídala.

6. Ověření, že to funguje

  1. Otevřete svůj web v běžné kartě prohlížeče a chvíli s ním pracujte.
  2. Ve svém analytickém nástroji otevřete nejnovější událost a vyhledejte vlastnost mouseplayer_session_url. Po jejím otevření byste se měli dostat rovnou k záznamu.
  3. V MousePlayeru otevřete Průzkumník uživatelů. Relace s identitou ji zobrazují místo vygenerované přezdívky návštěvníka.

Když se nic nezobrazí

  • Vlastnost chybí u všech událostí: zkontrolujte, zda se analytické SDK na stránce skutečně načítá a zda jste vybrali odpovídající platformu. Při výběru PostHogu se Mixpanel nečte.
  • Vlastnost se objevuje až u pozdějších událostí: to je očekávané chování, viz poznámka v oddílu 3.
  • URL je k dispozici, identita ne: vaše SDK zatím nepřidělilo žádné distinct_id, což je před identifikací uživatele normální. Načte se při některém z dalších načtení stránky.
  • Testujete jako přihlášený administrátor: některá nastavení vylučují interní provoz. Zkuste anonymní okno.

Všechny zde uvedené ochranné známky patří jejich příslušným vlastníkům. MousePlayer nemá s těmito poskytovateli žádný obchodní vztah.