Penghubung PostHog, Mixpanel & Amplitude

Alat analitik produk anda memberitahu apa yang berlaku. MousePlayer menunjukkan sebabnya. Penghubung ini menyambungkan kedua-duanya dalam dua hala, supaya penghentian dalam corong hanya satu klik daripada rakaman yang menerangkannya.

1. Masalah: angka tanpa wajah

Analitik produk memberikan corong: 1,000 pengguna mencapai pembayaran, 620 meninggalkannya. Itu pengukuran tepat bagi masalah yang masih tidak dapat anda lihat. Menonton beberapa daripada 620 rakaman itu biasanya menjawab soalan dalam beberapa minit — tetapi hanya jika anda dapat beralih daripada carta ke sesi yang betul tanpa mengeksport ID dan mencari secara manual.

Penghubung Analitik Produk menghapuskan jurang itu. Ia berjalan dalam mp.js dan memautkan kedua-dua sistem secara automatik:

  • Keluar: setiap peristiwa yang direkodkan alat analitik anda membawa sifat mouseplayer_session_url . Buka mana-mana peristiwa, klik pautan, tonton sesi.
  • Masuk: pengecam pelawat distinct_id dibaca kembali dan disimpan pada sesi MousePlayer, supaya rakaman boleh dicari melalui identiti yang sama yang sudah anda gunakan dalam PostHog, Mixpanel atau Amplitude.

Tiada kod diperlukan. Penghubung mengesan SDK analitik dengan sendiri. Anda tidak memanggil sebarang fungsi MousePlayer dan tidak perlu mengubah cara anda menjejak peristiwa.

2. Pengaktifan

Cara A: papan pemuka (Tanpa kod)

  1. Buka projek anda dan pergi ke tab Integrasi .
  2. Tukar Penghubung PostHog, Mixpanel & Amplitude kepada ON.
  3. Pilih platform yang anda gunakan. Perubahan disimpan secara automatik.

Tetapan berkuat kuasa pada pemuatan halaman seterusnya laman web anda. Sesi sedia ada tidak terjejas secara retrospektif.

Cara B: konfigurasi skrip manual

Jika anda lebih suka menetapkannya terus dalam kod, tetapkan dua nilai dalam 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. Perkara yang berlaku bagi setiap platform

Setiap platform menyediakan API berbeza, jadi penghubung memetakan kepada panggilan lazim bagi setiap satunya. Anda tidak perlu mengkonfigurasi ini — ia mengikuti pilihan penyedia anda.

PlatformKeluar (URL main semula)Masuk (Identiti)
PostHog posthog.register() — didaftarkan sebagai sifat super, jadi dilampirkan pada setiap peristiwa berikutnya posthog.get_distinct_id()
Mixpanel mixpanel.register() — tingkah laku sifat super yang sama mixpanel.get_distinct_id()
Amplitude setUserProperties() — ditetapkan sebagai sifat pengguna getDeviceId(), menggunakan getInstance().options.deviceId sebagai sandaran pada SDK lama

Sifat super berbanding sifat pengguna: dalam PostHog dan Mixpanel, URL main semula dilampirkan pada peristiwa selepas itu, jadi anda menemuinya pada setiap peristiwa yang dicetuskan selepas penghubung dimulakan — bukan pada peristiwa yang sudah dihantar lebih awal semasa pemuatan halaman.

4. Identiti: daripada distinct_id kepada sesi bernama

Bahagian masuk ialah bahagian yang dipandang ringan oleh kebanyakan pasukan. Tanpanya, sesi MousePlayer tiada nama: anda boleh menontonnya, tetapi tidak boleh menjawab “tunjukkan rakaman akaun yang tidak kembali sejak minggu lalu.”

Setelah penghubung aktif, distinct_id daripada alat analitik anda ditulis ke medan sesi custom_user_id — medan yang sama yang ditulis oleh panggilan SDK manual:

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

Jika anda sudah memanggil mp('set') sendiri, teruskan. Identiti yang anda berikan secara nyata lebih boleh dipercayai kerana ia kunci utama anda sendiri, bukan pengecam analitik bagi setiap pelayar.

Nota privasi: hanya pengecam yang sudah ditetapkan alat analitik anda dipindahkan. Tiada alamat e-mel, nama atau medan peribadi lain dibaca daripada SDK. Pastikan dasar privasi anda sendiri meliputi pemprosesan ini, dan sekat skrip penjejakan melalui alat persetujuan jika anda bergantung pada persetujuan sebagai asas undang-undang.

5. Tingkah laku teknikal

SDK analitik biasanya dimuatkan secara tak segerak, sering selepas mp.js sudah berjalan. Oleh itu, satu percubaan ketika permulaan akan gagal pada kebanyakan laman web sebenar.

  • Penghubung mencuba semula setiap 1.5 saat, sehingga sepuluh kali, dan berhenti sebaik kedua-dua arah selesai.
  • Setiap arah diselesaikan secara berasingan, jadi URL main semula tidak pernah dihantar dua kali semasa menunggu identiti muncul.
  • Jika SDK tidak pernah muncul, penghubung berhenti secara senyap selepas kira-kira 15 saat. Tiada apa-apa ditulis ke konsol dan rakaman sesi diteruskan tanpa terjejas.
  • Pengecam melebihi 128 aksara diabaikan, bukan dipotong, untuk mengelakkan penyimpanan separuh pengecam yang tidak akan sepadan dengan apa-apa.

6. Mengesahkan ia berfungsi

  1. Buka laman web anda dalam tab pelayar biasa dan berinteraksi sebentar.
  2. Dalam alat analitik anda, buka peristiwa terbaharu dan cari sifat mouseplayer_session_url . Membukanya sepatutnya membawa anda terus ke rakaman.
  3. Dalam MousePlayer, buka Peneroka Pengguna. Sesi yang membawa identiti menunjukkannya menggantikan nama samaran pelawat dijana.

Jika tiada apa-apa muncul

  • Sifat tiada pada semua peristiwa: semak bahawa SDK analitik benar-benar dimuatkan pada halaman dan anda memilih platform yang sepadan. Pilihan PostHog tidak akan membaca Mixpanel.
  • Sifat hanya muncul pada peristiwa kemudian: itu dijangka, lihat nota dalam seksyen 3.
  • URL ada tetapi identiti tiada: SDK anda belum menetapkan distinct_id , yang biasa berlaku sebelum pengguna dikenal pasti. Ia akan diambil pada pemuatan halaman kemudian.
  • Anda menguji sebagai pentadbir yang didaftarkan masuk: sesetengah persediaan mengecualikan trafik dalaman. Cuba tetingkap peribadi.

Semua tanda dagangan yang disebut di sini milik pemilik masing-masing. MousePlayer tidak mempunyai hubungan perniagaan dengan penyedia ini.