PostHog, Mixpanel & Amplitude körpüsü

Məhsul analitikası alətiniz sizə nə baş verdiyini deyir. MousePlayer isə niyəbaş verdiyini göstərir. Bu körpü ikisini hər iki istiqamətdə birləşdirir, beləliklə qıfdakı ayrılma onu izah edən qeyddən bir klik uzaqdadır.

1. Problem: simasız rəqəmlər

Məhsul analitikası sizə qıf verir: 1,000 istifadəçi ödənişə çatıb, 620-si tərk edib. Bu, hələ görə bilmədiyiniz problemin dəqiq ölçüsüdür. Həmin 620 qeyddən bir neçəsinə baxmaq adətən suala dəqiqələr içində cavab verir — amma yalnız ID-ləri ixrac edib əl ilə axtarmadan qrafikdən doğru seanslara keçə bilsəniz.

Bu Məhsul analitikası körpüsü həmin boşluğu aradan qaldırır. O, bu skriptin daxilində işləyir: mp.js və iki sistemi avtomatik bağlayır:

  • Çıxış: analitika alətinizin qeydə aldığı hər hadisədə bu xüsusiyyət olur: mouseplayer_session_url . İstənilən hadisəni açın, keçidə klikləyin, seansa baxın.
  • Giriş: ziyarətçinin bu identifikatoru: distinct_id geri oxunub MousePlayer seansında saxlanılır, beləliklə qeydlər artıq PostHog, Mixpanel və ya Amplitude-da istifadə etdiyiniz eyni kimliklə axtarıla bilir.

Kod tələb olunmur. Körpü analitika SDK-sını özü aşkarlayır. Heç bir MousePlayer funksiyası çağırmırsınız və hadisələri izləmə üsulunuzu dəyişməli deyilsiniz.

2. Aktivləşdirmə

Üsul A: idarə paneli (kodsuz)

  1. Layihənizi açın və bu bölməyə keçin: İnteqrasiyalar .
  2. Bu körpünü: PostHog, Mixpanel & Amplitude körpüsü bu vəziyyətə keçirin: ON.
  3. İstifadə etdiyiniz platformanı seçin. Dəyişikliklər avtomatik saxlanılır.

Parametr saytınızın növbəti səhifə yüklənməsində qüvvəyə minir. Mövcud seanslara geriyə tətbiq edilmir.

Üsul B: skriptin əl ilə tənzimlənməsi

Kodda birbaşa təyin etmək istəyirsinizsə, bu obyektin daxilində iki dəyəri təyin edin: 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. Hər platformada nə baş verir

Hər platforma fərqli API təqdim edir, buna görə körpü hər birində onun standart çağırışından istifadə edir. Bunu tənzimləməyə ehtiyac yoxdur — provayder seçiminizə uyğunlaşır.

PlatformaÇıxış (təkrar oynatma URL-si)Giriş (kimlik)
PostHog posthog.register() — super xüsusiyyət kimi qeydiyyata alınır, buna görə bütün sonrakı hadisələrə əlavə olunur posthog.get_distinct_id()
Mixpanel mixpanel.register() — eyni super xüsusiyyət davranışı mixpanel.get_distinct_id()
Amplitude setUserProperties() — istifadəçi xüsusiyyəti kimi təyin edilir getDeviceId(), köhnə SDK-da isə bu üsula keçir: getInstance().options.deviceId .

Super xüsusiyyət və istifadəçi xüsusiyyəti: PostHog və Mixpanel-də təkrar oynatma URL-si sonrakı hadisələrə əlavə olunur, buna görə körpü başladıqdan sonra göndərilmiş hər hadisədə onu tapacaqsınız — səhifə yüklənməsinin əvvəlində artıq göndərilmiş hadisələrdə deyil.

4. Kimlik: distinct_id-dən adlandırılmış seansa

Giriş tərəfi əksər komandaların dəyərini az qiymətləndirdiyi hissədir. Onsuz MousePlayer seansları anonimdir: onlara baxa bilərsiniz, amma bu suala cavab verə bilməzsiniz: “Keçən həftə ayrılmış hesabın qeydlərini göstər.”

Körpü aktiv olduqda analitika alətinizdən gələn distinct_id seansdakı bu sahəyə yazılır: custom_user_id — SDK-nın əl ilə çağırışı da eyni sahəyə yazır:

// The manual equivalent - you do NOT need this when the bridge is active mp('set', { user_id: 'your-internal-id' });

Əgər artıq bu çağırışdan: mp('set') özünüz istifadə edirsinizsə, davam edin. Açıq şəkildə verdiyiniz kimlik daha etibarlıdır, çünki o, brauzerə görə analitika identifikatoru deyil, öz əsas açarınızdır.

Məxfilik qeydi: yalnız analitika alətinizin artıq təyin etdiyi identifikator ötürülür. SDK-dan e-poçt ünvanı, ad və ya başqa şəxsi sahə oxunmur. Öz məxfilik siyasətinizin bu emalı əhatə etdiyinə əmin olun və hüquqi əsas kimi razılığa söykənirsinizsə, izləmə skriptini razılıq alətinizlə bloklayın.

5. Texniki davranış

Analitika SDK-ları adətən asinxron yüklənir, çox vaxt bu skript: mp.js artıq işlədikdən sonra. Buna görə başlanğıcda tək cəhd əksər real saytlarda uğursuz olardı.

  • Körpü bu intervalla yenidən cəhd edir: 1.5 saniyə, ən çox on dəfəvə hər iki istiqamət tamamlanan kimi dayanır.
  • Hər istiqamət müstəqil tamamlanır, buna görə kimliyin görünməsini gözləyərkən təkrar oynatma URL-si heç vaxt iki dəfə göndərilmir.
  • SDK heç görünməzsə, körpü təxminən 15 saniyədən sonra səssizcə dayanır. Konsola heç nə yazılmır və seans qeydi təsirlənmədən davam edir.
  • Heç nə ilə uyğun gəlməyəcək yarımçıq identifikator saxlamamaq üçün 128 simvoldan uzun identifikatorlar kəsilmir, nəzərə alınmır.

6. İşlədiyini yoxlamaq

  1. Saytınızı adi brauzer vərəqində açın və qısa müddət onunla qarşılıqlı əlaqədə olun.
  2. Analitika alətinizdə ən yeni hadisəni açın və bu xüsusiyyəti axtarın: mouseplayer_session_url . Onu açmaq sizi birbaşa qeydə aparmalıdır.
  3. MousePlayer-də bu bölməni açın: İstifadəçi araşdırıcısı. Kimliyi olan seanslar yaradılmış ziyarətçi ləqəbi əvəzinə onu göstərir.

Heç nə görünmürsə

  • Xüsusiyyət bütün hadisələrdə yoxdur: analitika SDK-sının həqiqətən səhifədə yükləndiyini və uyğun platformanı seçdiyinizi yoxlayın. PostHog seçimi Mixpanel-i oxumayacaq.
  • Xüsusiyyət yalnız sonrakı hadisələrdə görünür: bu gözləniləndir, 3-cü bölmədəki qeydə baxın.
  • URL var, amma kimlik yoxdur: SDK-nız hələ bu identifikatoru: distinct_id təyin etməyib, istifadəçi müəyyənləşdirilməzdən əvvəl bu normaldır. Sonrakı səhifə yüklənməsində alınacaq.
  • Daxil olmuş administrator kimi sınaq aparırsınız: bəzi quraşdırmalar daxili trafiki istisna edir. Məxfi pəncərədə sınayın.

Burada adı çəkilən bütün ticarət nişanları müvafiq sahiblərinə məxsusdur. MousePlayer-in bu provayderlərlə işgüzar əlaqəsi yoxdur.