Hayot sikli (server tomonida)
Sessiya o‘z mijoz ID’ingizni olishi bilanoq qayta ijro havolasini serverimizdan ActiveCampaign, Mailchimp, Iterable yoki Klaviyo’ga uzating.
1. Brauzer ko‘prigi yonida nega kerak
MousePlayer’da o‘z sahifangizdagi SDK’ga yozadigan hayot sikli ko‘prigi bor — Klaviyo, Braze, Customer.io va oltita boshqa. Bunisi o‘sha ishni serverimizdan qiladi, chunki ikkita eng katta platformada brauzer yo‘li umuman yo‘q:
- ActiveCampaign’da hodisalar uchun brauzer API’si umuman yo‘q. Uning
vgo()hisob va email belgilab, kuzatishni boshlaydi — hodisa yuborolmaydi. Hodisalar alohida hodisa kalitli Event Tracking API orqali, faqat serverdan boradi. - Mailchimp’da bor, ammo lug‘ati yopiq. Sayt kuzatuv pikseli shularni:
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDva bir necha oldindan belgilangan nomni qabul qiladi. Maxsus hodisaga joy yo‘q, ma’lumotimizni shunga tiqish:PAGE_VIEWEDo‘z ma’lumot modelingiz ichida yolg‘on bo‘lardi.
Iterable va Klaviyo uchun server yo‘li shunchaki ishonchliroq: reklama bloklagichi yo‘q, yuklangan-yuklanmagan SDK yo‘q, varaq erta yopilishi yo‘q.
2. Nima kerak
Uch maydon, qaysisini to‘ldirish platformaga bog‘liq.
| Platforma | Hisob maydoni | Kalit |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, hodisa kaliti yonida |
| Mailchimp | Auditoriya ID’si | API kaliti — shu uslubdagi qo‘shimchasini saqlang: -us14 , ma’lumot markazi undan o‘qiladi |
| Iterable | kerak emas — bo‘sh qoldiring | “Allow event track calls” ruxsatli kalit |
| Klaviyo | kerak emas — bo‘sh qoldiring | Shu maxfiy API kaliti |
Uchinchi maydon — ko‘rinadigan hodisa nomi. Qisqa tuting: ko‘pi bilan 32 belgi. Bu bizning emas, API limiti, yuborganda emas, saqlaganda qisqartiramiz — aks holda shakl kelganidan boshqa narsani ko‘rsatardi.
Mailchimp: API kalitingiz qo‘shimchasini saqlang. Oxirgi chiziqchadan keyingi qism (-us14) hisobingiz ma’lumot markazini bildiradi va manzil undan tuziladi. Usiz kalit ko‘rinmas joyda ishlamay qolish o‘rniga aniq xabar bilan rad etiladi.
3. Qachon ishlaydi, qachon yo‘q
Sessiya aniqlanganda: saytingiz shuni chaqirganda: MousePlayer.setUserId(), tahlil ko‘prigimiz distinct ID’ni qayta o‘qiganda yoki serveringiz identify endpoint’ini chaqirganda. Ungacha yozuv kimniki ekanini bilmaymiz.
Faqat email manzili bilan
To‘rttala platforma kontaktni email bilan taniydi. Mijoz ID’ingiz shartnoma raqami bo‘lsa, hech narsa yuborilmaydi — faqat xato beradigan vazifani navbatlash jurnalni shovqinga to‘ldirardi.
Kontakt allaqachon mavjud bo‘lishi kerak. Bu platformalarning hech biri hodisadan kontakt yaratmaydi; ActiveCampaign manzilni tanimasa, hodisani butunlay tashlaydi. Bu ko‘prik mavjud kontaktlarni boyitadi — ro‘yxatingizni yaratmaydi.
Har hodisada ID bor
Shu sababli vazifa qayta urinsa ham, bir sessiya ikki marta sanalmaydi.
4. Boshqa tomonga nima yetadi
Bitta hodisa, qayta ijro havolasi shu nomdagi xususiyatda: mouseplayer_session_url. Ochsangiz, aynan shu sessiya yozuvidasiz.
Keyin platformangizning o‘z mantig‘i: hodisani avtomatlashtirish triggeri, segment sharti sifatida ishlating yoki jamoangiz kontakt ichidan yozuvni ochsin.
Kalit serverimizdan chiqmaydi
AES-256-GCM bilan shifrlab saqlanadi, saqlagach qayta ko‘rsatilmaydi va vazifani tashiydigan ichki navbatga ataylab qo‘yilmaydi — ishchi uni bazadan o‘zi oladi.
HTTP 200 yetkazildi degani emas
ActiveCampaign hodisani rad etganda 200 holati va shuni: {"success":0} qaytaradi. Faqat holatni emas, javob tanasini o‘qiymiz, shunda rad etish yetkazish jurnalida jim muvaffaqiyat emas, xato bo‘lib ko‘rinadi.
5. Braze, Customer.io va Brevo
Server yo‘lida yana uch platforma. Ikkitasiga boshqalarga kerak bo‘lmagan narsa kerak: joy.
| Siz berasiz | Shu bilan aniqlanadi | |
|---|---|---|
| Braze | REST endpoint va API kaliti | email manzili |
| Customer.io | sayt ID’si, API kaliti va hududingiz | o‘z mijoz ID’ingiz |
| Brevo | faqat treker kaliti | email manzili |
Ikkitasi muayyan joyda ishlaydi
Braze nusxaga bog‘langan REST endpoint’larda, Customer.io turli xostli ikki alohida hududda ishlaydi. Hech birini kalitdan bilib bo‘lmaydi, noto‘g‘ri tanlov 401 beradi — siz esa kalitdan sabab izlaysiz. Ikkala maydon faqat shu uchun bor.
Customer.io email talab qilmaydigani
Odamlarni o‘zingiz tayinlagan ID bilan taniydi, shuning uchun email talab qilish uydirma to‘siq bo‘lardi. Qolgan oltitasi email orqali moslaydi va ularda shartnoma raqami bilan aniqlangan sessiya hech narsa yaratmaydi — to‘g‘ri.
Yangi profillar yo‘q
Braze chaqiruvi shuni uzatadi: _update_existing_only. CRM ko‘prigi kabi qaror: brauzer sessiyasi mijozlaringiz kimligining ishonchli bayonoti emas, har anonim tashrifchiga profil yaratadigan hayot sikli platformasi esa integratsiyasizlikdan yomonroq.
Brevo 204, Braze shart bilan 201 qaytaradi
Brevo umuman tana qaytarmaydi — u yerda 2xx butun haqiqat. Braze shuni qaytaradi: "message": "success" va yonida shu errors massivi bo‘lishi mumkin: jiddiy muammo message’da, chidasa bo‘ladigan maydon yo‘qotishlari faqat errors’da. Faqat bittasini o‘qish bir tomonga yoki boshqasiga xato qiladi.
Bu yerda atalgan barcha savdo belgilari o‘z egalariga tegishli. MousePlayer bu provayderlar bilan tijorat aloqasiga ega emas.