Kitar hayat (bahagian pelayan)
Hantar pautan main semula ke ActiveCampaign, Mailchimp, Iterable atau Klaviyo daripada pelayan kami sebaik sesi mendapat ID pelanggan anda sendiri.
1. Mengapa ini wujud di samping penghubung pelayar
MousePlayer sudah mempunyai penghubung kitar hayat yang menulis ke SDK yang berjalan pada halaman anda sendiri - Klaviyo, Braze, Customer.io dan enam lagi. Yang ini melakukan tugas sama daripada pelayan kami, dan wujud kerana bagi dua platform terbesar, laluan pelayar langsung tidak tersedia:
- ActiveCampaign langsung tiada API pelayar untuk peristiwa.
vgo()boleh menetapkan akaun dan alamat e-mel serta memulakan penjejakan - ia tidak boleh menghantar peristiwa. Peristiwa melalui Event Tracking API dengan kunci peristiwa berasingan, khusus di bahagian pelayan. - Mailchimp mempunyainya, tetapi dengan kosa kata tertutup. Piksel penjejakan lamannya menerima
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDdan beberapa nama lain yang dipratakrifkan. Tiada ruang untuk peristiwa tersuai, dan memaksa data kami ke dalamPAGE_VIEWEDakan menjadi pembohongan dalam model data anda sendiri.
Untuk Iterable dan Klaviyo, laluan pelayan lebih boleh dipercayai: tiada penyekat iklan, tiada SDK yang mungkin dimuatkan atau tidak, tiada tab ditutup awal.
2. Perkara yang diperlukan
Tiga medan, dan medan yang diisi bergantung pada platform.
| Platform | Medan akaun | Kunci |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, di sebelah kunci peristiwa |
| Mailchimp | ID khalayak | Kunci API - kekalkan akhiran bergaya -us14 , pusat data dibaca daripadanya |
| Iterable | tidak diperlukan - biarkan kosong | Kunci dengan kebenaran “Allow event track calls” |
| Klaviyo | tidak diperlukan - biarkan kosong | Kunci API peribadi |
Medan ketiga ialah nama peristiwa yang digunakan untuk memaparkannya. Pastikan pendek: maksimum 32 aksara. Itulah had API, bukan had kami, dan kami memendekkannya ketika anda menyimpan, bukan ketika menghantar - jika tidak, borang akan menunjukkan sesuatu yang berbeza daripada yang diterima.
Mailchimp: kekalkan akhiran pada kunci API anda. Bahagian selepas sempang terakhir (-us14) menamakan pusat data akaun anda, dan alamat dibina daripadanya. Kunci tanpanya ditolak dengan mesej jelas, bukannya gagal di tempat yang tidak dapat anda lihat.
3. Masa ia dicetuskan - dan tidak dicetuskan
Pada saat sesi dikenal pasti: apabila laman anda memanggil MousePlayer.setUserId(), apabila penghubung analitik kami membaca kembali ID tersendiri, atau apabila pelayan anda memanggil titik akhir identify. Sebelum itu, kami tidak mengetahui pemilik rakaman.
Hanya dengan alamat e-mel
Keempat-empat platform mengenal pasti kenalan melalui e-mel. Jika ID pelanggan anda ialah nombor kontrak, tiada apa-apa dihantar - memasukkan tugas yang hanya boleh gagal ke barisan cuma memenuhi log dengan hingar.
Kenalan mesti sudah wujud. Tiada satu pun platform ini menciptanya daripada peristiwa; ActiveCampaign membuang seluruh peristiwa jika tidak mengenali alamat. Penghubung ini memperkaya kenalan sedia ada - bukan membina senarai anda.
Setiap peristiwa membawa ID
Supaya sesi sama tidak boleh dikira dua kali, walaupun tugas dicuba semula.
4. Perkara yang tiba di pihak lain
Satu peristiwa, membawa pautan main semula sebagai sifat bernama mouseplayer_session_url. Bukanya dan anda berada dalam rakaman sesi itu tepat-tepat.
Selepas itu, logik platform anda sendiri: gunakan peristiwa sebagai pencetus automasi, sebagai syarat segmen atau sekadar benarkan pasukan membuka rakaman daripada kenalan.
Kunci tidak pernah meninggalkan pelayan kami
Disimpan dengan penyulitan AES-256-GCM, tidak pernah ditunjukkan semula selepas disimpan dan sengaja tidak dimasukkan ke barisan dalaman yang membawa tugas - pekerja mengambilnya sendiri daripada pangkalan data.
HTTP 200 tidak bermakna dihantar
ActiveCampaign membalas dengan status 200 dan {"success":0} apabila menolak peristiwa. Kami membaca badan respons, bukan status sahaja, jadi penolakan muncul sebagai kegagalan dalam log penghantaran, bukan kejayaan senyap.
5. Braze, Customer.io dan Brevo
Tiga lagi platform pada laluan bahagian pelayan. Dua daripadanya memerlukan sesuatu yang tidak diperlukan yang lain: lokasi.
| Anda memberikan | Dikenal pasti melalui | |
|---|---|---|
| Braze | Titik akhir REST dan kunci API | alamat e-mel |
| Customer.io | ID laman, kunci API dan wilayah anda | ID pelanggan anda sendiri |
| Brevo | kunci penjejak sahaja | alamat e-mel |
Dua daripadanya berada di lokasi khusus
Braze menjalankan titik akhir REST terikat tika; Customer.io menjalankan dua wilayah berasingan dengan hos berbeza. Kedua-duanya tidak boleh diperoleh daripada kunci, dan memilih yang salah membalas 401 - yang membuat anda menyemak kunci. Kedua-dua medan wujud hanya atas sebab itu.
Customer.io satu-satunya yang tidak memerlukan e-mel
Ia mengenali orang melalui ID sama yang anda tetapkan, jadi mewajibkan alamat e-mel akan menjadi halangan rekaan. Enam yang lain memadankan melalui e-mel, dan bagi mereka, sesi dikenal pasti melalui nombor kontrak tidak menghasilkan apa-apa - dengan betul.
Tiada profil baharu
Panggilan Braze membawa _update_existing_only. Keputusan sama seperti penghubung CRM: sesi pelayar bukan pernyataan boleh dipercayai tentang identiti pelanggan anda, dan platform kitar hayat yang menambah profil bagi setiap pelawat tanpa nama lebih buruk daripada tiada integrasi.
Brevo membalas 204, Braze membalas 201 dengan syarat
Brevo langsung tidak mengembalikan badan - di situ, 2xx benar-benar keseluruhan maklumat. Braze mengembalikan "message": "success" dan mungkin turut membawa tatasusunan errors : masalah kritikal muncul dalam message, kehilangan medan yang ditoleransi hanya dalam errors. Membaca salah satu sahaja memberikan kesimpulan salah ke salah satu arah.
Semua tanda dagangan yang disebut di sini milik pemilik masing-masing. MousePlayer tidak mempunyai hubungan perniagaan dengan penyedia ini.