Мост кон PostHog, Mixpanel & Amplitude

Вашата алатка за аналитика на производот ви кажува што се случило. MousePlayer ви покажува зошто. Овој мост ги поврзува двете во двете насоки, па откажувањето во инката е на еден клик од снимката што го објаснува.

1. Проблемот: бројки без лица

Аналитиката на производот ви дава инка: 1.000 корисници стигнале до наплата, 620 ја напуштиле. Тоа е прецизно мерење на проблем што сè уште не можете да го видите. Гледањето неколку од тие 620 снимки обично одговара на прашањето за неколку минути — но само ако може да стигнете од графиконот до вистинските сесии без извезување ID и рачно пребарување.

Овој мост за аналитика на производот ја отстранува таа празнина. Работи во 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 нема деловен однос со овие даватели.