Ž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, PURCHASED i nekoliko drugih unapred definisanih naziva. Nema mesta za prilagođeni događaj, a guranje naših podataka u PAGE_VIEWED bila 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.

PlatformaPolje nalogaKljuč
ActiveCampaignactidWebsite → Site Tracking, pored ključa događaja
MailchimpID publikeAPI ključ — zadržite njegov sufiks u stilu -us14, iz njega se čita centar podataka
Iterablenije potrebno — ostavite praznoKljuč sa dozvolom „Allow event track calls“
Klaviyonije potrebno — ostavite praznoJedan 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 dajeteIdentifikacija putem
BrazeREST endpoint i API ključimejl adrese
Customer.ioID sajta, API ključ i vaš regionvašeg ID-ja kupca
Brevosamo ključ skripte za praćenjeimejl 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.