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-ს ამ პროვაიდერებთან საქმიანი კავშირი არ აქვს.