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. Қолданатын платформаны таңдаңыз. Өзгерістер автоматты сақталады.

Баптау веб-сайтыңыздың келесі бет жүктелуінде күшіне енеді. Бұрынғы сеанстарға кері әсер етпейді.

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 осы қызмет жеткізушілерімен іскерлік қатынаста емес.