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, PURCHASED dan beberapa nama lain yang dipratakrifkan. Tiada ruang untuk peristiwa tersuai, dan memaksa data kami ke dalam PAGE_VIEWED akan 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.

PlatformMedan akaunKunci
ActiveCampaignactidWebsite → Site Tracking, di sebelah kunci peristiwa
MailchimpID khalayakKunci API - kekalkan akhiran bergaya -us14 , pusat data dibaca daripadanya
Iterabletidak diperlukan - biarkan kosongKunci dengan kebenaran “Allow event track calls”
Klaviyotidak diperlukan - biarkan kosongKunci 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 memberikanDikenal pasti melalui
BrazeTitik akhir REST dan kunci APIalamat e-mel
Customer.ioID laman, kunci API dan wilayah andaID pelanggan anda sendiri
Brevokunci penjejak sahajaalamat 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.