Ciclu de viață (pe server)
Trimiteți linkul redării în ActiveCampaign, Mailchimp, Iterable sau Klaviyo de pe server imediat ce sesiunea primește ID-ul propriu de client.
1. De ce există alături de puntea din browser
MousePlayer are deja o punte de ciclu de viață care scrie în SDK-ul paginii — Klaviyo, Braze, Customer.io și încă șase. Aceasta face același lucru de pe server, fiindcă două platforme mari nu au cale prin browser:
- ActiveCampaign nu are deloc API de browser pentru evenimente. Funcția sa
vgo()poate seta contul și e-mailul și porni urmărirea, dar nu trimite evenimente. Acestea folosesc Event Tracking API cu cheie separată, exclusiv pe server. - Mailchimp are, dar cu vocabular închis. Pixelul de urmărire acceptă
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDși câteva alte nume predefinite. Nu există loc pentru un eveniment personalizat, iar comprimarea datelor noastre într-unPAGE_VIEWEDar falsifica propriul model de date.
Pentru Iterable și Klaviyo, serverul este mai fiabil: fără blocator de reclame, SDK posibil neîncărcat sau filă închisă prea devreme.
2. Ce necesită
Trei câmpuri, completate în funcție de platformă.
| Platformă | Câmpul contului | Cheie |
|---|---|---|
| ActiveCampaign | actid | Site web → Urmărirea site-ului, lângă cheia evenimentelor |
| Mailchimp | ID-ul audienței | Cheie API — păstrați sufixul de tip -us14, din care se citește centrul de date |
| Iterable | nu este necesar — lăsați gol | O cheie cu permisiunea „Permiteți apelurile de urmărire a evenimentelor” |
| Klaviyo | nu este necesar — lăsați gol | O cheie API privată este necesară |
Al treilea câmp este numele evenimentului afișat. Păstrați-l scurt: cel mult 32 de caractere. Este limita API-ului, nu a noastră; scurtăm la salvare, nu la trimitere, altfel formularul ar afișa altceva decât se livrează.
Mailchimp: păstrați sufixul cheii API. Partea după ultima cratimă (-us14) indică centrul de date al contului, din care se construiește adresa. Fără sufix, cheia este respinsă cu mesaj clar, nu eșuează invizibil.
3. Când se declanșează și când nu
La identificarea sesiunii: când site-ul apelează MousePlayer.setUserId(), puntea analitică citește un identificator distinct sau serverul apelează endpointul de identificare. Până atunci nu știm cui îi aparține înregistrarea.
Doar cu adresă de e-mail
Toate cele patru platforme găsesc contactul prin e-mail. Dacă ID-ul de client este număr de contract, nu se trimite nimic — o sarcină sigur eșuată ar umple jurnalul inutil.
Contactul trebuie să existe deja. Niciuna nu îl creează din eveniment; ActiveCampaign elimină evenimentul dacă nu recunoaște adresa. Puntea îmbogățește contactele existente, nu construiește lista.
Fiecare eveniment are un ID
Aceeași sesiune nu poate fi numărată de două ori, nici la reîncercarea sarcinii.
4. Ce ajunge la destinație
Un eveniment cu linkul redării în proprietatea mouseplayer_session_url. Deschiderea ei duce la înregistrarea acelei sesiuni.
De acolo decide logica platformei: folosiți evenimentul ca declanșator automat, condiție de segment sau lăsați echipa să deschidă înregistrarea din contact.
Cheia nu părăsește serverul nostru
Se stochează criptat cu AES-256-GCM, nu se reafișează și nu se introduce în coada internă a sarcinii — procesul o preia singur din baza de date.
HTTP 200 nu înseamnă livrat
ActiveCampaign răspunde cu 200 și {"success":0} la respingerea evenimentului. Citim conținutul, nu doar starea, astfel respingerea apare ca eșec în jurnal, nu reușită tăcută.
5. Braze, Customer.io și Brevo
Trei platforme suplimentare pe server. Două necesită ceva diferit: locația.
| Furnizați | Identificat prin | |
|---|---|---|
| Braze | Endpoint REST și cheie API | adresă de e-mail |
| Customer.io | ID site, cheie API și regiune | ID-ul propriu de client |
| Brevo | doar cheia scriptului de urmărire | adresă de e-mail |
Două au locații specifice
Braze folosește endpointuri REST legate de instanță; Customer.io are două regiuni distincte cu gazde diferite. Niciuna nu se deduce din cheie, iar alegerea greșită răspunde 401 și vă trimite să verificați cheia. De aceea există câmpurile.
Customer.io nu necesită e-mail
Cunoaște persoanele prin ID-ul atribuit chiar de dumneavoastră, deci e-mailul ar fi un obstacol artificial. Celelalte șase îl folosesc; o sesiune identificată cu număr de contract nu produce nimic acolo — corect.
Fără profiluri noi
Apelul Braze conține _update_existing_only. Aceeași decizie ca la CRM: sesiunea din browser nu dovedește cine sunt clienții, iar o platformă care creează profil pentru fiecare anonim este mai rea decât lipsa integrării.
Brevo răspunde 204, Braze 201 cu o particularitate
Brevo nu returnează deloc conținut — acolo 2xx spune tot. Braze returnează "message": "success" și poate include alături un tablou errors. Problemele fatale sunt în mesaj, pierderile tolerate de câmpuri doar în errors. Citirea unuia singur greșește într-o direcție sau alta.
Toate mărcile menționate aici aparțin proprietarilor lor. MousePlayer nu are relații comerciale cu acești furnizori.