Мост за PostHog, Mixpanel & Amplitude

Инструментът ви за продуктов анализ ви казва какво се е случило. MousePlayer ви показва защо. Този мост свързва двете в двете посоки, така че отпадането във фуния е на едно кликване от записа, който го обяснява.

1. Проблемът: числа без лица

Продуктовият анализ ви дава фуния: 1000 потребители са стигнали до завършване на поръчката, 620 са я изоставили. Това е точно измерване на проблем, който все още не виждате. Гледането на няколко от тези 620 записа обикновено отговаря на въпроса за минути — но само ако можете да преминете от диаграмата към правилните сесии, без да експортирате идентификатори и да търсите ръчно.

Този мост за продуктов анализ премахва тази празнина. Работи в mp.js и свързва двете системи автоматично:

  • Изходящо: всяко събитие, записано от аналитичния ви инструмент, носи свойство mouseplayer_session_url. Отворете произволно събитие, натиснете връзката и гледайте сесията.
  • Входящо: идентификаторът на посетителя distinct_id се прочита обратно и се съхранява в сесията на MousePlayer, така че записите стават откриваеми по същата идентичност, която вече използвате в PostHog, Mixpanel или Amplitude.

Без необходимост от код. Мостът сам открива аналитичния SDK. Не извиквате функция на MousePlayer и не трябва да променяте начина, по който проследявате събития.

2. Активиране

Метод А: табло (без код)

  1. Отворете проекта си и отидете в раздела Интеграции.
  2. Превключете Мост за PostHog, Mixpanel & Amplitude на ON.
  3. Изберете платформата, която използвате. Промените се запазват автоматично.

Настройката влиза в сила при следващото зареждане на страница от сайта ви. Съществуващите сесии не се засягат със задна дата.

Метод Б: ръчно конфигуриране на скрипта

Ако предпочитате да зададете настройките в кода, задайте двете стойности в 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 няма търговски отношения с тези доставчици.