PostHog, Mixpanel և Amplitude կամուրջ

1. Խնդիրը. թվեր՝ առանց դեմքերի

Արտադրանքի վերլուծությունը տալիս է ձագարը՝ 1,000 օգտատեր հասել է վճարմանը, 620-ը լքել է այն։ Սա խնդրի ճշգրիտ չափում է, որը դեռ չեք տեսնում։ Այդ 620 ձայնագրություններից մի քանիսը դիտելը սովորաբար րոպեների ընթացքում պատասխանում է հարցին — եթե կարողանում եք գծապատկերից հասնել ճիշտ աշխատաշրջաններին՝ առանց ID-ներ արտահանելու ու ձեռքով որոնելու։

Այս արտադրանքի վերլուծության կամուրջը լրացնում է այդ բացը։ Այն աշխատում է mp.js ներսում և ինքնաբերաբար կապում երկու համակարգերը՝

Ելքային՝ ձեր վերլուծական գործիքի գրանցած յուրաքանչյուր իրադարձություն կրում է mouseplayer_session_url հատկությունը։ Բացեք ցանկացած իրադարձություն, սեղմեք հղումը և դիտեք աշխատաշրջանը։
Մուտքային՝ այցելուի distinct_id նույնացուցիչը կարդացվում և պահվում է MousePlayer-ի աշխատաշրջանում, որպեսզի ձայնագրությունները որոնելի լինեն նույն ինքնությամբ, որն արդեն օգտագործում եք PostHog-ում, Mixpanel-ում կամ Amplitude-ում։

Կոդ պետք չէ։ Կամուրջն ինքն է հայտնաբերում վերլուծության SDK-ն։ Պետք չէ կանչել MousePlayer-ի որևէ գործառույթ կամ փոխել իրադարձություններին հետևելու եղանակը։

2. Ակտիվացում

Եղանակ A. վահանակ՝ առանց կոդի

Բացեք ձեր նախագիծը և անցեք Ինտեգրումներ ներդիր։
Փոխարկեք PostHog, Mixpanel & Amplitude կամուրջը միացված վիճակի՝ ON։
Ընտրեք ձեր օգտագործած հարթակը։ Փոփոխությունները պահվում են ինքնաբերաբար։

Կարգավորումն ուժի մեջ է մտնում ձեր կայքի հաջորդ էջաբեռնման ժամանակ։ Առկա աշխատաշրջանների վրա հետադարձ ազդեցություն չունի։

Եղանակ B. սկրիպտի ձեռքով կարգավորում

Եթե նախընտրում եք կոդում ամրագրել, երկու արժեքները սահմանեք window.mp_configներսում՝

<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. Աշխատանքի ստուգում

Բացեք ձեր կայքը դիտարկիչի սովորական ներդիրում և կարճ փոխազդեք դրա հետ։
Վերլուծական գործիքում բացեք ամենանոր իրադարձությունը և փնտրեք mouseplayer_session_url հատկությունը։ Այն բացելը պետք է անմիջապես տանի ձայնագրությանը։
MousePlayer-ում բացեք Օգտատերերի հետազոտիչը։ Ինքնություն կրող աշխատաշրջանները գեներացված այցելուի մականվան փոխարեն ցույց են տալիս այն։

Եթե ոչինչ չի երևում

Հատկությունը բացակայում է բոլոր իրադարձություններից՝ ստուգեք, որ վերլուծության SDK-ն իսկապես բեռնվում է էջում, և ընտրել եք համապատասխան հարթակը։ PostHog-ի ընտրությունը Mixpanel չի կարդա։
Հատկությունը հայտնվում է միայն հետագա իրադարձություններում՝ սա սպասված վարքն է. տես 3-րդ բաժնի նշումը։
URL-ը կա, բայց ինքնությունը չկա՝ ձեր SDK-ն դեռ չի նշանակել distinct_id , ինչը բնական է մինչև օգտատիրոջ նույնականացումը։ Այն կկարդացվի հաջորդ էջաբեռնման ժամանակ։
Փորձարկում եք որպես մուտք գործած ադմինիստրատոր՝ որոշ կարգավորումներ բացառում են ներքին տրաֆիկը։ Փորձեք մասնավոր պատուհանով։

Այստեղ նշված բոլոր ապրանքային նշանները պատկանում են իրենց տերերին։ MousePlayer-ը գործարար կապ չունի այս մատակարարների հետ։

Ինչպե՞ս կարող ենք օգնել