Životni ciklus (na strani servera)

1. Zašto postoji pored mosta preglednika

MousePlayer već ima most životnog ciklusa koji piše u SDK na vašoj stranici — Klaviyo, Braze, Customer.io i još šest. Ovaj radi isto s našeg servera, a postoji jer za dvije najveće platforme put preglednika jednostavno nije dostupan:

• ActiveCampaign uopće nema API preglednika za događaje. Njegov vgo() može postaviti račun i e-mail adresu te početi pratiti, ali ne može poslati događaj. Događaji idu putem Event Tracking API-ja sa zasebnim ključem događaja, samo na serveru.
• Mailchimp ga ima, ali sa zatvorenim skupom naziva. Njegov piksel za praćenje sajta prihvata PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED i nekoliko drugih unaprijed definiranih naziva. Nema mjesta za prilagođeni događaj, a ugurati naše podatke u PAGE_VIEWED značilo bi laž unutar vašeg modela podataka.

2. Šta treba

Tri polja, a koja popunjavate zavisi od platforme.

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, ne naše, i skraćujemo ga pri čuvanju, ne pri slanju — inače bi formular pokazivao nešto drugo od onoga što stiže.

3. Kad se aktivira, a kad ne

U trenutku identifikacije sesije: kad vaš sajt pozove MousePlayer.setUserId(), kad analitički most pročita distinct ID ili kad vaš server pozove endpoint identifikacije. Prije toga ne znamo kome snimak pripada.

Samo s e-mail adresom

Sve četiri platforme prepoznaju kontakt po e-mailu. Ako je ID klijenta broj ugovora, ništa se ne šalje — dodavanje zadatka koji može samo zakazati u red samo bi napunilo zapis šumom.

Svaki događaj nosi ID

Zato se ista sesija ne može brojati dvaput čak i ako se zadatak ponovi.

4. Šta stiže na drugu stranu

Jedan događaj s linkom reprodukcije kao svojstvom naziva mouseplayer_session_url. Otvorite ga i u snimku ste upravo te sesije.

Odatle radi logika vaše platforme: koristite događaj kao okidač automatizacije, uslov segmenta ili jednostavno omogućite timu otvaranje snimka iz kontakta.

Ključ nikad ne napušta naš server

Čuva se šifriran uz AES-256-GCM, nikad se ponovo ne prikazuje nakon čuvanja i namjerno ne ulazi u interni red zadataka — izvršilac ga sam preuzima iz baze podataka.

HTTP 200 ne znači dostavljeno

ActiveCampaign odgovara statusom 200 i {"success":0} kad odbije događaj. Čitamo tijelo odgovora, ne samo status, pa se odbijanje pojavljuje kao greška u zapisu dostava, a ne kao tihi uspjeh.