Yaşam Döngüsü (sunucu tarafı)
Oturum kendi müşteri kimliğinizi aldığı anda yeniden oynatma bağlantısını sunucumuzdan ActiveCampaign, Mailchimp, Iterable veya Klaviyo'ya gönderin.
1. Tarayıcı köprüsünün yanında neden var?
MousePlayer'da zaten sayfanızdaki SDK'ya yazan yaşam döngüsü köprüsü var: Klaviyo, Braze, Customer.io ve altı araç daha. Bu köprü aynı işi sunucumuzdan yapar; çünkü en büyük iki platformda tarayıcı yolu yoktur:
- ActiveCampaign'in olaylar için hiç tarayıcı API'si yok. Onun
vgo()nesnesi hesap ve e-posta ayarlayıp takibi başlatabilir; olay gönderemez. Olaylar ayrı olay anahtarıyla Event Tracking API üzerinden, yalnızca sunucu tarafında gider. - Mailchimp'te var ama sözlüğü kapalı. Site takip pikseli şunları kabul eder:
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDve az sayıda önceden tanımlanmış ad. Özel olaya yer yoktur; verilerimizi şu olaya zorlamak:PAGE_VIEWEDkendi veri modelinizde yalan olurdu.
Iterable ve Klaviyo için sunucu yolu yalnızca daha güvenilirdir: reklam engelleyici yok, yüklenip yüklenmediği belirsiz SDK yok, erken kapanan sekme yok.
2. Neler gerekir?
Üç alan; hangilerinin dolacağı platforma bağlıdır.
| Platform | Hesap alanı | Anahtar |
|---|---|---|
| ActiveCampaign | actid | Web Sitesi → Site Takibi, olay anahtarının yanında |
| Mailchimp | Hedef kitle kimliği | API anahtarı; şu tür son ekini koruyun: -us14 ; veri merkezi buradan okunur |
| Iterable | gerekmez; boş bırakın | “Allow event track calls” izni olan anahtar |
| Klaviyo | gerekmez; boş bırakın | Bir özel API anahtarı |
Üçüncü alan, olayın görüneceği addır. Kısa tutun: en fazla 32 karakter. Sınır API'nindir, bizim değil. Gönderirken değil, kaydederken kısaltırız; aksi halde form, ulaşandan farklı şey gösterirdi.
Mailchimp: API anahtarınızdaki son eki koruyun. Son tireden sonraki bölüm (-us14) hesabınızın veri merkezini belirtir; adres ondan oluşturulur. Eksikse, göremediğiniz yerde başarısız olmak yerine açık mesajla anahtar reddedilir.
3. Ne zaman çalışır, ne zaman çalışmaz?
Oturum tanımlandığı anda: siteniz MousePlayer.setUserId() çağırdığında, analiz köprümüz benzersiz kimliği geri okuduğunda veya sunucunuz tanımlama uç noktasını çağırdığında. Öncesinde kaydın kime ait olduğunu bilmeyiz.
Yalnızca e-posta adresiyle
Dört platform da kişiyi e-postasıyla bulur. Müşteri kimliğiniz sözleşme numarasıysa hiçbir şey gönderilmez; yalnızca başarısız olabilecek işi kuyruğa almak günlüğü gürültüyle doldurur.
Kişi zaten mevcut olmalıdır. Bu platformların hiçbiri olaydan yeni kişi oluşturmaz; ActiveCampaign adresi tanımazsa olayı tamamen atar. Bu köprü mevcut kişilerinizi zenginleştirir; listenizi oluşturmaz.
Her olay kimlik taşır
Böylece iş yeniden denense bile aynı oturum iki kez sayılamaz.
4. Karşı tarafa ne ulaşır?
Yeniden oynatma bağlantısını şu adlı özellikte taşıyan tek olay: mouseplayer_session_url. Açtığınızda tam o oturumun kaydına girersiniz.
Sonrası platformunuzun kendi mantığıdır: olayı otomasyon tetikleyicisi veya segment koşulu yapın ya da ekibiniz kişi kaydından oynatmayı açsın.
Anahtar sunucumuzdan asla çıkmaz
AES-256-GCM ile şifrelenerek saklanır, kayıttan sonra tekrar gösterilmez ve işi taşıyan iç kuyruğa bilinçli olarak konmaz; işleyici kendisi veritabanından alır.
HTTP 200, teslim edildi demek değildir
ActiveCampaign olayı reddettiğinde 200 durumu ve {"success":0} döndürür. Yalnızca durumu değil yanıt gövdesini okuruz; ret, sessiz başarı yerine gönderim günlüğünde başarısızlık olarak görünür.
5. Braze, Customer.io ve Brevo
Sunucu tarafında üç platform daha. İkisi diğerlerinin istemediği bir şey ister: bir yer.
| Vereceğiniz bilgiler | Tanımlama biçimi | |
|---|---|---|
| Braze | REST uç noktası ve API anahtarı | e-posta adresi |
| Customer.io | site kimliği, API anahtarı ve bölgeniz | kendi müşteri kimliğiniz |
| Brevo | yalnızca izleyici anahtarı | e-posta adresi |
İkisi belirli bir yerde bulunur
Braze, örneğe bağlı REST uç noktaları kullanır; Customer.io farklı sunuculu iki ayrı bölge kullanır. İkisi de anahtardan çıkarılamaz; yanlış seçim 401 döndürerek sizi anahtarı incelemeye yöneltir. İki alan yalnızca bu nedenle vardır.
E-posta gerektirmeyen Customer.io'dur
İnsanları atadığınız kimlikle tanır; e-posta zorunluluğu uydurma engel olurdu. Diğer altısı e-postayla eşleştirir; sözleşme numarasıyla tanımlanan oturum onlar için doğru biçimde hiçbir şey üretmez.
Yeni profil yok
Braze çağrısı şu değeri taşır: _update_existing_only. CRM köprüsüyle aynı karar: tarayıcı oturumu müşterilerinizin kim olduğu hakkında güvenilir beyan değildir; her anonim ziyaretçide profil büyüten yaşam döngüsü platformu, hiç entegrasyon olmamasından kötüdür.
Brevo 204, Braze ise bir koşulla 201 döndürür
Brevo hiç gövde döndürmez; orada 2xx gerçekten tüm gerçektir. Braze şu değeri döndürür: "message": "success" ve yanında errors dizisi bulunabilir: ölümcül sorunlar message içinde, tolere edilen alan kayıpları yalnızca errors içinde görünür. Yalnızca birini okumak bir yönde ya da diğerinde yanılmanıza neden olur.
Burada adı geçen tüm ticari markalar ilgili sahiplerine aittir. MousePlayer'ın bu sağlayıcılarla ticari ilişkisi yoktur.