PostHog, Mixpanel & Amplitude Köprüsü

Ürün analiz aracınız ne olduğunu söyler. MousePlayer ise nedeninigösterir. Bu köprü ikisini çift yönlü bağlar; hunideki bir ayrılma, onu açıklayan kayıttan bir tık uzaktadır.

1. Sorun: Yüzü Olmayan Sayılar

Ürün analizi size huni verir: 1.000 kullanıcı ödemeye ulaştı, 620 terk etti. Hâlâ göremediğiniz sorunun kesin ölçümüdür. Bu 620 kaydın birkaçını izlemek genellikle soruyu dakikalar içinde yanıtlar — ancak grafikten doğru oturumlara kimlik dışa aktarmadan ve elle aramadan ulaşabiliyorsanız.

Bu Ürün Analiz Köprüsü aradaki boşluğu kaldırır. Çalıştığı yer: mp.js ; iki sistemi otomatik bağlar:

  • Giden: Analiz aracınızın kaydettiği her olayda şu özellik bulunur: mouseplayer_session_url . Herhangi bir olayı açın, bağlantıya tıklayın, oturumu izleyin.
  • Gelen: Ziyaretçinin distinct_id değeri geri okunur ve MousePlayer oturumuna kaydedilir; kayıtlar, PostHog, Mixpanel veya Amplitude'da zaten kullandığınız kimlikle aranabilir.

Kod gerekmez. Köprü analiz SDK'sını kendisi algılar. MousePlayer işlevi çağırmaz, olay takibinizi değiştirmezsiniz.

2. Etkinleştirme

Yöntem A: Gösterge Paneli (Kodsuz)

  1. Projenizi açıp Entegrasyonlar sekmesine gidin.
  2. Şu entegrasyonu açın: PostHog, Mixpanel & Amplitude Köprüsü Durum: ON.
  3. Kullandığınız platformu seçin. Değişiklikler otomatik kaydedilir.

Ayar, web sitenizin sonraki sayfa yüklemesinde geçerli olur. Mevcut oturumlar geriye dönük etkilenmez.

Yöntem B: Elle Betik Yapılandırması

Doğrudan kodlamayı tercih ederseniz iki değeri şu nesnenin içinde ayarlayın: 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. Her Platformda Ne Olur?

Her platform farklı API sunar; köprü her biri için o platforma özgü çağrıyı kullanır. Yapılandırmanız gerekmez — sağlayıcı seçiminizi izler.

PlatformGiden (yeniden oynatma URL'si)Gelen (kimlik)
PostHog posthog.register() — süper özellik olarak kaydedilir ve sonraki her olaya eklenir posthog.get_distinct_id()
Mixpanel mixpanel.register() — aynı süper özellik davranışı mixpanel.get_distinct_id()
Amplitude setUserProperties() — kullanıcı özelliği olarak ayarlanır getDeviceId(); eski SDK'da yedek olarak getInstance().options.deviceId kullanılır

Süper özellik ve kullanıcı özelliği: PostHog ve Mixpanel'de yeniden oynatma URL'si sonraki olaylara eklenir; köprü başladıktan sonra çalışan her olayda bulursunuz — sayfa yüklenirken daha önce gönderilmiş olaylarda değil.

4. Kimlik: distinct_id'den Adlandırılmış Oturuma

Gelen taraf, çoğu ekibin önemini hafife aldığı kısımdır. Onsuz MousePlayer oturumları anonimdir; izleyebilirsiniz ama şu isteği karşılayamazsınız: “Geçen hafta kaybettiğimiz hesabın kayıtlarını göster.”

Köprü etkinken analiz aracınızdaki distinct_id değeri, oturumun custom_user_id alanına yazılır — elle SDK çağrısının yazdığı alanla aynıdır:

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

Zaten kendiniz mp('set') çağırıyorsanız devam edin. Açıkça verdiğiniz kimlik daha güvenilirdir; tarayıcı başına analiz tanımlayıcısı değil, kendi birincil anahtarınızdır.

Gizlilik notu: Yalnızca analiz aracınızın zaten atadığı tanımlayıcı aktarılır. SDK'dan e-posta, ad veya başka kişisel alan okunmaz. Kendi gizlilik politikanızın bu işlemeyi kapsadığından emin olun; hukuki dayanak olarak onaya güveniyorsanız takip betiğini onay aracınızın arkasında tutun.

5. Teknik Davranış

Analiz SDK'ları genellikle eşzamansız, çoğu zaman mp.js çalışmaya başladıktan sonra yüklenir. Bu nedenle başlangıçtaki tek deneme çoğu gerçek web sitesinde başarısız olurdu.

  • Köprü, 1,5 saniyede bir, en fazla on kezyeniden dener; iki yön de tamamlanınca durur.
  • Her yön bağımsız tamamlanır; kimliğin gelmesi beklenirken yeniden oynatma URL'si asla iki kez gönderilmez.
  • SDK hiç görünmezse köprü yaklaşık 15 saniye sonra sessizce vazgeçer. Konsola hiçbir şey yazılmaz, oturum kaydı etkilenmeden sürer.
  • Hiçbir şeyle eşleşmeyecek yarım kimliği saklamamak için 128 karakterden uzun tanımlayıcılar kesilmek yerine yok sayılır.

6. Çalıştığını Doğrulama

  1. Web sitenizi normal tarayıcı sekmesinde açıp kısa süre etkileşimde bulunun.
  2. Analiz aracınızda en yeni olayı açıp şu özelliği arayın: mouseplayer_session_url . Açtığınızda doğrudan kayda gitmelidir.
  3. MousePlayer'da Kullanıcı Gezgininiaçın. Kimlik taşıyan oturumlar, oluşturulan ziyaretçi takma adı yerine onu gösterir.

Hiçbir şey görünmüyorsa

  • Hiçbir olayda özellik yok: Analiz SDK'sının sayfada gerçekten yüklendiğini ve doğru platformu seçtiğinizi kontrol edin. PostHog seçimi Mixpanel okumaz.
  • Özellik yalnızca sonraki olaylarda görünüyor: Bu beklenir; 3. bölümdeki nota bakın.
  • URL var ama kimlik yok: SDK'nız henüz distinct_id atamamıştır; kullanıcı tanımlanmadan önce normaldir. Sonraki sayfa yüklemesinde alınır.
  • Giriş yapmış yönetici olarak test ediyorsunuz: Bazı kurulumlar iç trafiği dışlar. Özel pencere deneyin.

Burada adı geçen tüm ticari markalar ilgili sahiplerine aittir. MousePlayer'ın bu sağlayıcılarla ticari ilişkisi yoktur.