Мост PostHog, Mixpanel & Amplitude

Інструмент прадуктовай аналітыкі кажа вам, што адбылося. MousePlayer паказвае, чаму. Гэты мост злучае іх у абодвух напрамках, таму сыход у варонцы — за адзін клік ад запісу, які яго тлумачыць.

1. Праблема: лічбы без твараў

Прадуктовая аналітыка дае варонку: 1,000 карыстальнікаў дайшлі да афармлення, 620 пакінулі яго. Гэта дакладнае вымярэнне праблемы, якой вы яшчэ не бачыце. Прагляд некалькіх з тых 620 запісаў звычайна дае адказ за хвіліны — але толькі калі можна перайсці ад графіка да патрэбных сеансаў без экспарту ID і ручнога пошуку.

Гэты мост прадуктовай аналітыкі ліквідуе прабел. Ён працуе ўнутры mp.js і аўтаматычна звязвае дзве сістэмы:

  • Выхад: кожная падзея аналітычнага інструмента мае ўласцівасць mouseplayer_session_url . Адкрыйце падзею, націсніце спасылку і паглядзіце сеанс.
  • Уваход: ідэнтыфікатар наведвальніка distinct_id счытваецца назад і захоўваецца ў сеансе MousePlayer, таму запісы можна шукаць па той жа ідэнтычнасці, што ўжо выкарыстоўваецца ў PostHog, Mixpanel або Amplitude.

Код не патрэбны. Мост сам вызначае SDK аналітыкі. Не трэба выклікаць функцыю MousePlayer або змяняць спосаб адсочвання падзей.

2. Уключэнне

Спосаб A: панэль (без кода)

  1. Адкрыйце праект і перайдзіце ва ўкладку Інтэграцыі .
  2. Пераключыце Мост PostHog, Mixpanel & Amplitude у стан ON.
  3. Выберыце сваю платформу. Змены захоўваюцца аўтаматычна.

Налада дзейнічае з наступнай загрузкі старонкі сайта. Да існых сеансаў заднім чыслом не ўжываецца.

Спосаб B: ручная канфігурацыя скрыпту

Калі хочаце задаць гэта ў кодзе, укажыце два значэнні ў 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. Што адбываецца на кожнай платформе

Кожная платформа мае свой API, таму мост выкарыстоўвае тыповы для яе выклік. Наладжваць гэта не трэба — усё залежыць ад выбранага пастаўшчыка.

ПлатформаВыхад (URL прайгравання)Уваход (ідэнтычнасць)
PostHog posthog.register() — рэгіструецца як суперуласцівасць і дадаецца да кожнай наступнай падзеі posthog.get_distinct_id()
Mixpanel mixpanel.register() — такія ж паводзіны суперуласцівасці mixpanel.get_distinct_id()
Amplitude setUserProperties() — задаецца як уласцівасць карыстальніка getDeviceId(), з пераходам на getInstance().options.deviceId у старым SDK

Суперуласцівасць і ўласцівасць карыстальніка: у PostHog і Mixpanel URL прайгравання дадаецца да будучых падзей; ён будзе ў кожнай падзеі пасля ініцыялізацыі моста — але не ў тых, што ўжо адпраўлены раней падчас загрузкі старонкі.

4. Ідэнтычнасць: ад distinct_id да названага сеанса

Уваходная палова — тое, што большасць каманд недаацэньвае. Без яе сеансы MousePlayer ананімныя: іх можна паглядзець, але немагчыма адказаць на запыт «пакажыце запісы акаўнта, які сышоў на мінулым тыдні».

Калі мост уключаны, значэнне distinct_id з аналітычнага інструмента запісваецца ў поле сеанса custom_user_id — тое ж поле, у якое піша ручны выклік SDK:

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

Калі вы ўжо самі выклікаеце mp('set') , працягвайце. Яўна зададзеная ідэнтычнасць надзейнейшая, бо гэта ваш асноўны ключ, а не аналітычны ідэнтыфікатар асобнага браўзера.

Заўвага пра прыватнасць: перадаецца толькі ўжо прызначаны аналітычным інструментам ідэнтыфікатар. Ні пошта, ні імя, ні іншае асабістае поле з SDK не чытаецца. Пераканайцеся, што палітыка прыватнасці ахоплівае гэту апрацоўку, і блакуйце скрыпт інструментам згоды, калі прававая падстава — згода.

5. Тэхнічныя паводзіны

SDK аналітыкі звычайна загружаюцца асінхронна, часта пасля таго, як mp.js ужо працуе. Таму адна спроба пры запуску не спрацавала б на большасці сапраўдных сайтаў.

  • Мост паўтарае спробу кожныя 1.5 секунды, не больш за дзесяць разоўі спыняецца адразу пасля завяршэння абодвух напрамкаў.
  • Кожны напрамак завяршаецца незалежна, таму URL прайгравання не адпраўляецца двойчы падчас чакання ідэнтычнасці.
  • Калі SDK так і не з'явіцца, мост ціха спыняецца прыкладна праз 15 секунд. У кансоль нічога не пішацца, запіс сеанса працягваецца без змен.
  • Ідэнтыфікатары даўжэйшыя за 128 сімвалаў ігнаруюцца, а не абразаюцца, каб не захоўваць палову, якая ніколі ні з чым не супадзе.

6. Праверка працы

  1. Адкрыйце сайт у звычайнай укладцы браўзера і крыху паўзаемадзейнічайце з ім.
  2. У аналітычным інструменце адкрыйце найноўшую падзею і знайдзіце ўласцівасць mouseplayer_session_url . Яна павінна весці проста да запісу.
  3. У MousePlayer адкрыйце User Explorer. Сеансы з ідэнтычнасцю паказваюць яе замест згенераванай мянушкі.

Калі нічога не з'яўляецца

  • Уласцівасці няма ва ўсіх падзеях: праверце загрузку SDK на старонцы і правільнасць выбранай платформы. Выбар PostHog не прачытае Mixpanel.
  • Уласцівасць ёсць толькі ў пазнейшых падзеях: гэта чакана, гл. заўвагу ў раздзеле 3.
  • URL ёсць, а ідэнтычнасці няма: SDK яшчэ не прызначыў distinct_id , што нармальна да ідэнтыфікацыі карыстальніка. Значэнне будзе атрымана пры пазнейшай загрузцы старонкі.
  • Вы правяраеце як адміністратар, які ўвайшоў: некаторыя канфігурацыі выключаюць унутраны трафік. Паспрабуйце прыватнае акно.

Усе згаданыя таварныя знакі належаць адпаведным уладальнікам. MousePlayer не мае дзелавых адносін з гэтымі пастаўшчыкамі.