Životni ciklus (na strani servera)
Pošaljite link do snimka u ActiveCampaign, Mailchimp, Iterable ili Klaviyo sa našeg servera čim sesija dobije vaš ID kupca.
1. Zašto ovo postoji uz most pregledača
MousePlayer već ima most životnog ciklusa koji upisuje u SDK na vašoj stranici — Klaviyo, Braze, Customer.io i šest drugih. Ovaj umesto toga radi isti posao sa našeg servera i postoji jer za dve najveće platforme put preko pregledača jednostavno nije dostupan:
- ActiveCampaign uopšte nema API pregledača za događaje. Njegov
vgo()može da postavi nalog i imejl adresu i pokrene praćenje — ne može da pošalje događaj. Događaji idu preko Event Tracking API-ja sa zasebnim ključem događaja, isključivo sa servera. - Mailchimp ga ima, ali sa zatvorenim rečnikom. Njegov piksel praćenja sajta prihvata
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDi nekoliko drugih unapred definisanih naziva. Nema mesta za prilagođeni događaj, a guranje naših podataka uPAGE_VIEWEDbila bi laž unutar vašeg modela podataka.
Za Iterable i Klaviyo serverski put je jednostavno pouzdaniji: nema blokatora oglasa, SDK-a koji se možda učitao, a možda nije, ni preranog zatvaranja kartice.
2. Šta je potrebno
Tri polja; koja popunjavate zavisi od platforme.
| Platforma | Polje naloga | Ključ |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, pored ključa događaja |
| Mailchimp | ID publike | API ključ — zadržite njegov sufiks u stilu -us14, iz njega se čita centar podataka |
| Iterable | nije potrebno — ostavite prazno | Ključ sa dozvolom „Allow event track calls“ |
| Klaviyo | nije potrebno — ostavite prazno | Jedan privatni API ključ |
Treće polje je naziv događaja pod kojim će se pojaviti. Neka bude kratak: najviše 32 znaka. To je ograničenje API-ja, a ne naše, i skraćujemo ga pri čuvanju, a ne slanju — inače bi obrazac prikazivao nešto drugo od onoga što stiže.
Mailchimp: zadržite sufiks API ključa. Deo iza poslednje crtice (-us14) imenuje centar podataka vašeg naloga i iz njega se gradi adresa. Ključ bez njega odbija se jasnom porukom umesto da propadne negde gde ne vidite.
3. Kada se pokreće — a kada ne
U trenutku identifikacije sesije: kada vaš sajt pozove MousePlayer.setUserId(), kada naš analitički most pročita distinct ID ili kada vaš server pozove endpoint za identifikaciju. Pre toga ne znamo kome snimak pripada.
Samo sa imejl adresom
Sve četiri platforme pristupaju kontaktu preko imejla. Ako je vaš ID kupca broj ugovora, ništa se ne šalje — stavljanje zadatka koji može samo da propadne u red čekanja samo bi zatrpalo evidenciju šumom.
Kontakt već mora da postoji. Nijedna od ovih platformi ga ne pravi iz događaja; ActiveCampaign potpuno odbacuje događaj ako ne prepozna adresu. Ovaj most obogaćuje postojeće kontakte — ne gradi vašu listu.
Svaki događaj sadrži ID
Tako ista sesija ne može da se broji dvaput čak ni pri ponovnom pokušaju zadatka.
4. Šta stiže na drugu stranu
Jedan događaj sa linkom snimka kao svojstvom nazvanim mouseplayer_session_url. Otvorite ga i nalazite se u snimku upravo te sesije.
Odatle važi logika vaše platforme: koristite događaj kao okidač automatizacije, uslov segmenta ili jednostavno omogućite timu da otvori snimak iz kontakta.
Ključ nikada ne napušta naš server
Čuva se šifrovano pomoću AES-256-GCM, nikada se ne prikazuje nakon čuvanja i namerno se ne stavlja u interni red čekanja koji prenosi zadatak — radni proces ga sam preuzima iz baze.
HTTP 200 ne znači isporučeno
ActiveCampaign odgovara statusom 200 i {"success":0} kada odbija događaj. Čitamo telo odgovora, a ne samo status, pa se odbijanje pojavljuje kao neuspeh u evidenciji isporuke umesto kao neprimetan uspeh.
5. Braze, Customer.io i Brevo
Još tri platforme na serverskom putu. Dvema je potrebno nešto što drugima nije: mesto.
| Vi dajete | Identifikacija putem | |
|---|---|---|
| Braze | REST endpoint i API ključ | imejl adrese |
| Customer.io | ID sajta, API ključ i vaš region | vašeg ID-ja kupca |
| Brevo | samo ključ skripte za praćenje | imejl adrese |
Dve se nalaze na određenom mestu
Braze koristi REST endpoint-e vezane za instancu; Customer.io koristi dva odvojena regiona sa različitim hostovima. Nijedno ne može da se izvede iz ključa, a pogrešan izbor vraća 401 — što vas navodi da proveravate ključ. Oba polja postoje samo iz tog razloga.
Customer.io ne zahteva imejl
Poznaje ljude pod istim ID-jem koji im vi dodelite, pa bi zahtev za imejl adresom bio izmišljena prepreka. Ostalih šest povezuje preko imejla i kod njih sesija identifikovana brojem ugovora ne proizvodi ništa — ispravno.
Bez novih profila
Braze poziv sadrži _update_existing_only. Ista odluka kao kod CRM mosta: sesija pregledača nije pouzdana izjava o tome ko su vaši klijenti, a platforma životnog ciklusa koja stvara profil za svakog anonimnog posetioca gora je od odsustva integracije.
Brevo odgovara sa 204, Braze sa 201 uz zamku
Brevo ne vraća telo — tamo je 2xx zaista cela istina. Braze vraća "message": "success" i može da sadrži niz errors uz njega: fatalni problemi se pojavljuju u message, tolerisani gubici polja samo u errors. Čitanje samo jednog od njih daje pogrešan zaključak u jednom ili drugom smeru.
Svi ovde navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos sa ovim pružaocima usluga.