Міст PostHog, Mixpanel & Amplitude

Ваш інструмент продуктової аналітики показує, що сталося. MousePlayer показує, чому. Цей міст з’єднує обидві системи в обох напрямках: від запису, який пояснює вихід із воронки, вас відділяє лише один клік.

1. Проблема: цифри без облич

Продуктова аналітика показує воронку: 1 000 користувачів перейшли до оформлення замовлення, 620 покинули його. Це точний вимір проблеми, якої ви досі не бачите. Перегляд кількох записів цих 620 користувачів зазвичай дає відповідь за лічені хвилини — але лише якщо від діаграми можна перейти до потрібних сеансів без експорту ідентифікаторів і ручного пошуку.

Цей міст продуктової аналітики усуває розрив. Він працює всередині 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 відкрийте Провідник користувачів. Сеанси з ідентичністю показують її замість згенерованого псевдоніма відвідувача.

Якщо нічого не з’являється

  • Властивість відсутня в усіх подіях: перевірте, чи справді SDK аналітики завантажується на сторінці та чи вибрано відповідну платформу. Налаштування PostHog не зчитуватиме Mixpanel.
  • Властивість з’являється лише в пізніших подіях: це очікувана поведінка, див. примітку в розділі 3.
  • URL є, а ідентичності немає: ваш SDK ще не призначив distinct_id. До ідентифікації користувача це нормально. Ідентичність буде отримано під час подальшого завантаження сторінки.
  • Ви перевіряєте як адміністратор, що увійшов у систему: деякі конфігурації виключають внутрішній трафік. Спробуйте приватне вікно.

Усі згадані тут торговельні марки належать їхнім відповідним власникам. MousePlayer не має ділових відносин із цими постачальниками.