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(), ал эми эски SDKда кошумча вариант катары getInstance().options.deviceId колдонулат

Суперкасиет менен колдонуучунун касиетинин айырмасы: 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 бул провайдерлер менен ишкердик байланышта эмес.