Siklus Hidup (Sisi Server)
Kirim tautan pemutaran ulang ke ActiveCampaign, Mailchimp, Iterable, atau Klaviyo dari server kami saat sesi mendapatkan ID pelanggan Anda sendiri.
1. Mengapa Ini Ada di Samping Jembatan Browser
MousePlayer sudah memiliki jembatan siklus hidup yang menulis ke SDK yang berjalan pada halaman Anda sendiri — Klaviyo, Braze, Customer.io, dan enam lainnya. Yang ini melakukan pekerjaan sama dari server kami, dan tersedia karena untuk dua platform terbesar, jalur browser memang tidak tersedia:
- ActiveCampaign Sama Sekali Tidak Memiliki API Browser untuk Peristiwa. Fungsi
vgo()miliknya dapat menetapkan akun dan alamat email lalu memulai pelacakan — tetapi tidak dapat mengirim peristiwa. Peristiwa melewati Event Tracking API dengan kunci peristiwa terpisah, hanya di sisi server. - Mailchimp Memilikinya, tetapi dengan Kosakata Tertutup. Piksel pelacakan situsnya menerima
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDdan beberapa nama lain yang telah ditentukan. Tidak ada tempat untuk peristiwa kustom, dan memaksakan data kami kePAGE_VIEWEDakan menjadi kebohongan dalam model data Anda sendiri.
Untuk Iterable dan Klaviyo, jalur server lebih andal: tanpa pemblokir iklan, tanpa SDK yang mungkin sudah dimuat atau belum, tanpa tab yang ditutup terlalu awal.
2. Yang Diperlukan
Tiga kolom, dan kolom yang Anda isi bergantung pada platform.
| Platform | Kolom akun | Kunci |
|---|---|---|
| ActiveCampaign | actid | Situs Web → Pelacakan Situs, di sebelah kunci peristiwa |
| Mailchimp | ID audiens | Kunci API — pertahankan akhiran bergaya -us14, pusat data dibaca darinya |
| Iterable | tidak diperlukan — biarkan kosong | Kunci dengan izin “Izinkan pemanggilan pelacakan peristiwa” |
| Klaviyo | tidak diperlukan — biarkan kosong | Kunci API privat |
Kolom ketiga adalah nama peristiwa yang akan ditampilkan. Buat singkat: maksimum 32 karakter. Itu batas API, bukan batas kami, dan kami memendekkannya saat Anda menyimpan, bukan saat mengirim — jika tidak, formulir akan menampilkan sesuatu yang berbeda dari yang diterima.
Mailchimp: Pertahankan Akhiran pada Kunci API Anda. Bagian setelah tanda hubung terakhir (-us14) menunjukkan pusat data akun Anda, dan alamat dibuat darinya. Kunci tanpanya ditolak dengan pesan yang jelas alih-alih gagal di tempat yang tidak dapat Anda lihat.
3. Kapan Dipicu — dan Kapan Tidak
Saat sesi diidentifikasi: saat situs Anda memanggil MousePlayer.setUserId(), saat jembatan analitik kami membaca ID unik kembali, atau saat server Anda memanggil endpoint identify. Sebelumnya, kami tidak tahu milik siapa rekaman tersebut.
Hanya dengan Alamat Email
Keempat platform mengidentifikasi kontak melalui emailnya. Jika ID pelanggan Anda adalah nomor kontrak, tidak ada yang dikirim — memasukkan tugas yang pasti gagal ke antrean hanya akan memenuhi log dengan gangguan.
Kontak Harus Sudah Ada. Tidak satu pun platform ini membuat kontak dari peristiwa; ActiveCampaign membuang peristiwa sepenuhnya jika tidak mengenali alamat. Jembatan ini memperkaya kontak yang ada — bukan membangun daftar Anda.
Setiap Peristiwa Membawa ID
Agar sesi yang sama tidak dihitung dua kali, bahkan jika tugas dicoba ulang.
4. Yang Diterima di Sisi Lain
Satu peristiwa, membawa tautan pemutaran ulang sebagai properti bernama mouseplayer_session_url. Buka untuk melihat rekaman sesi tersebut secara tepat.
Setelah itu, gunakan logika platform Anda sendiri: gunakan peristiwa sebagai pemicu otomatisasi, syarat segmen, atau cukup biarkan tim membuka rekaman dari kontak.
Kunci Tidak Pernah Meninggalkan Server Kami
Disimpan dengan enkripsi AES-256-GCM, tidak pernah ditampilkan lagi setelah disimpan, dan sengaja tidak dimasukkan ke antrean internal yang membawa tugas — worker mengambilnya sendiri dari basis data.
HTTP 200 Tidak Berarti Terkirim
ActiveCampaign menjawab dengan status 200 dan {"success":0} saat menolak peristiwa. Kami membaca isi respons, bukan hanya status, sehingga penolakan muncul sebagai kegagalan di log pengiriman, bukan keberhasilan diam-diam.
5. Braze, Customer.io, dan Brevo
Tiga platform tambahan pada jalur sisi server. Dua di antaranya memerlukan sesuatu yang tidak diperlukan lainnya: lokasi.
| Yang Anda berikan | Diidentifikasi melalui | |
|---|---|---|
| Braze | Endpoint REST dan kunci API | alamat email |
| Customer.io | ID situs, kunci API, dan wilayah Anda | ID pelanggan Anda sendiri |
| Brevo | kunci pelacak saja | alamat email |
Dua di Antaranya Berada di Lokasi Tertentu
Braze menjalankan endpoint REST yang terikat instans; Customer.io menjalankan dua wilayah terpisah dengan host berbeda. Keduanya tidak dapat ditentukan dari kunci, dan memilih yang salah menghasilkan jawaban 401 — yang membuat Anda memeriksa kunci. Kedua kolom tersedia hanya karena alasan itu.
Customer.io Tidak Memerlukan Email
Platform ini mengenali orang melalui ID yang Anda tetapkan, sehingga mewajibkan alamat email akan menjadi hambatan buatan. Enam lainnya memang mencocokkan email, dan bagi mereka, sesi yang diidentifikasi dengan nomor kontrak tidak menghasilkan apa pun — sebagaimana mestinya.
Tidak Ada Profil Baru
Pemanggilan Braze membawa _update_existing_only. Keputusannya sama seperti jembatan CRM: sesi browser bukan pernyataan andal tentang siapa pelanggan Anda, dan platform siklus hidup yang menambah profil untuk setiap pengunjung anonim lebih buruk daripada tanpa integrasi.
Brevo Menjawab 204, Braze Menjawab 201 dengan Catatan
Brevo sama sekali tidak mengembalikan isi — di sana, 2xx memang menjelaskan semuanya. Braze mengembalikan "message": "success" dan dapat membawa array errors di sebelahnya: masalah fatal muncul dalam message, kehilangan kolom yang ditoleransi hanya dalam errors. Membaca hanya salah satunya akan menghasilkan kesalahan ke satu arah atau arah lainnya.
Semua merek dagang yang disebutkan di sini adalah milik pemiliknya masing-masing. MousePlayer tidak memiliki hubungan bisnis dengan penyedia ini.