Jembatan PostHog, Mixpanel & Amplitude

1. Masalahnya: Angka Tanpa Wajah

Analitik produk memberikan funnel: 1.000 pengguna mencapai checkout, 620 meninggalkannya. Itu adalah pengukuran tepat atas masalah yang masih belum dapat Anda lihat. Menonton beberapa dari 620 rekaman tersebut biasanya menjawab pertanyaan dalam hitungan menit — tetapi hanya jika Anda dapat berpindah dari grafik ke sesi yang tepat tanpa mengekspor ID dan mencari secara manual.

Jembatan Analitik Produk menghilangkan celah itu. Berjalan di dalam mp.js dan menghubungkan kedua sistem secara otomatis:

Keluar: setiap peristiwa yang direkam alat analitik Anda membawa properti mouseplayer_session_url. Buka peristiwa apa pun, klik tautannya, tonton sesinya.
Masuk: pengenal pengunjung distinct_id dibaca kembali dan disimpan pada sesi MousePlayer, sehingga rekaman dapat dicari dengan identitas yang sama seperti yang sudah Anda gunakan di PostHog, Mixpanel, atau Amplitude.

Tidak memerlukan kode. Jembatan mendeteksi SDK analitik sendiri. Anda tidak perlu memanggil fungsi MousePlayer apa pun atau mengubah cara pelacakan peristiwa.

2. Aktivasi

Metode A: Dasbor (Tanpa Kode)

Buka proyek Anda dan masuk ke tab Integrasi.
Alihkan Jembatan PostHog, Mixpanel & Amplitude ke ON.
Pilih platform yang Anda gunakan. Perubahan disimpan otomatis.

Pengaturan berlaku pada pemuatan halaman situs web Anda berikutnya. Sesi yang sudah ada tidak terpengaruh secara retroaktif.

Metode B: Konfigurasi Skrip Manual

Jika Anda lebih memilih menetapkannya langsung dalam kode, atur kedua nilai di dalam window.mp_config:

<script> window.mp_config = { channel: 'YOUR_CHANNEL_ID', analytics_bridge_active: true, analytics_provider: 'posthog' // 'posthog', 'mixpanel' or 'amplitude' }; </script>

3. Yang Terjadi pada Setiap Platform

Setiap platform menyediakan API yang berbeda, sehingga jembatan memetakan ke pemanggilan yang lazim untuk masing-masing. Anda tidak perlu mengonfigurasinya — mengikuti pilihan penyedia Anda.

Platform	Keluar (URL pemutaran ulang)	Masuk (identitas)
PostHog	`posthog.register()` — didaftarkan sebagai super property, sehingga dilampirkan pada setiap peristiwa berikutnya	`posthog.get_distinct_id()`
Mixpanel	`mixpanel.register()` — perilaku super property yang sama	`mixpanel.get_distinct_id()`
Amplitude	`setUserProperties()` — ditetapkan sebagai user property	`getDeviceId()`, beralih ke `getInstance().options.deviceId` pada SDK lama

Super property dan user property: di PostHog dan Mixpanel, URL pemutaran ulang dilampirkan pada peristiwa berikutnya, sehingga Anda menemukannya pada setiap peristiwa yang dipicu setelah jembatan diinisialisasi — bukan pada peristiwa yang sudah dikirim sebelumnya saat halaman dimuat.

4. Identitas: Dari distinct_id ke Sesi Bernama

Bagian masuk adalah bagian yang paling sering diremehkan tim. Tanpanya, sesi MousePlayer anonim: Anda dapat menontonnya, tetapi tidak dapat menjawab “tampilkan rekaman akun yang berhenti menggunakan layanan minggu lalu.”

Setelah jembatan aktif, pengenal distinct_id dari alat analitik Anda ditulis ke kolom sesi custom_user_id — kolom yang sama dengan yang ditulis oleh pemanggilan 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, lanjutkan. Identitas yang Anda berikan secara eksplisit lebih andal karena merupakan kunci utama Anda sendiri, bukan pengenal analitik per browser.

Catatan privasi: hanya pengenal yang sudah ditetapkan alat analitik Anda yang dipindahkan. Tidak ada alamat email, nama, atau kolom pribadi lain yang dibaca dari SDK. Pastikan kebijakan privasi Anda mencakup pemrosesan ini, dan batasi skrip pelacakan melalui alat persetujuan jika Anda mengandalkan persetujuan sebagai dasar hukum.

5. Perilaku Teknis

SDK analitik biasanya dimuat secara asinkron, sering kali setelah mp.js sudah berjalan. Karena itu, satu upaya saat mulai akan gagal pada sebagian besar situs web nyata.

Jembatan mencoba lagi setiap 1,5 detik, hingga sepuluh kali, dan berhenti segera setelah kedua arah selesai.
Setiap arah diselesaikan secara mandiri, sehingga URL pemutaran ulang tidak pernah dikirim dua kali saat menunggu identitas tersedia.
Jika SDK tidak pernah muncul, jembatan berhenti diam-diam setelah sekitar 15 detik. Tidak ada yang ditulis ke konsol dan perekaman sesi berlanjut tanpa terpengaruh.
Pengenal yang lebih panjang dari 128 karakter diabaikan alih-alih dipotong, agar tidak menyimpan setengah pengenal yang tidak akan pernah cocok dengan apa pun.

6. Memverifikasi Fungsinya

Buka situs web Anda pada tab browser biasa dan berinteraksilah sebentar.
Di alat analitik Anda, buka peristiwa terbaru dan cari properti mouseplayer_session_url. Membukanya seharusnya membawa Anda langsung ke rekaman.
Di MousePlayer, buka Penjelajah Pengguna. Sesi yang memiliki identitas menampilkannya sebagai pengganti nama panggilan pengunjung yang dihasilkan.

Jika tidak ada yang muncul

Properti tidak ada pada semua peristiwa: periksa apakah SDK analitik benar-benar dimuat di halaman dan apakah Anda memilih platform yang sesuai. Pilihan PostHog tidak akan membaca Mixpanel.
Properti hanya muncul pada peristiwa berikutnya: itu memang sesuai harapan, lihat catatan pada bagian 3.
URL ada tetapi identitas tidak ada: SDK Anda belum menetapkan distinct_id, yang normal sebelum pengguna diidentifikasi. Pengenal akan diambil pada pemuatan halaman berikutnya.
Anda menguji sebagai administrator yang sudah masuk: beberapa konfigurasi mengecualikan lalu lintas internal. Coba jendela privat.

Ada yang bisa kami bantu?