Životni ciklus (poslužiteljska strana)
Pošaljite poveznicu na reprodukciju u ActiveCampaign, Mailchimp, Iterable ili Klaviyo s našeg poslužitelja čim sesija dobije vaš vlastiti ID kupca.
1. Zašto postoji uz most u pregledniku
MousePlayer već ima most za životni ciklus koji zapisuje u SDK na vašoj stranici – Klaviyo, Braze, Customer.io i još šest drugih. Ovaj radi isto s našeg poslužitelja jer za dvije najveće platforme put kroz preglednik jednostavno nije dostupan:
- ActiveCampaign uopće nema API za događaje u pregledniku. Njegov
vgo()može postaviti račun i adresu e-pošte te pokrenuti praćenje – ne može poslati događaj. Događaji idu putem Event Tracking API-ja sa zasebnim ključem događaja, isključivo s poslužiteljske strane. - Mailchimp ga ima, ali sa zatvorenim skupom naziva. Njegov piksel za praćenje web-mjesta prihvaća
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDi nekoliko drugih unaprijed definiranih naziva. Nema mjesta za prilagođeni događaj, a ugurati naše podatke uPAGE_VIEWEDbilo bi unošenje neistine u vaš podatkovni model.
Za Iterable i Klaviyo put s poslužitelja jednostavno je pouzdaniji: bez blokatora oglasa, SDK-a koji se možda učitao, a možda nije, i preranog zatvaranja kartice.
2. Što je potrebno
Tri polja, a koja ćete ispuniti ovisi o platformi.
| Platforma | Polje računa | Ključ |
|---|---|---|
| ActiveCampaign | actid | Web-mjesto → Praćenje web-mjesta, pokraj ključa događaja |
| Mailchimp | ID publike | API ključ – zadržite nastavak poput -us14 jer se iz njega čita podatkovni centar |
| Iterable | nije potrebno – ostavite prazno | Ključ s dopuštenjem „Dopusti pozive za praćenje događaja“ |
| Klaviyo | nije potrebno – ostavite prazno | Privatni API ključ |
Treće polje je naziv pod kojim se događaj pojavljuje. Neka bude kratak: najviše 32 znaka. To je ograničenje API-ja, a ne naše; skraćujemo ga pri spremanju, a ne slanju – inače bi obrazac prikazivao nešto drukčije od onoga što stiže.
Mailchimp: zadržite nastavak API ključa. Dio nakon posljednje crtice (-us14) označava podatkovni centar vašeg računa, a iz njega se gradi adresa. Ključ bez njega odbija se jasnom porukom umjesto da zakaže ondje gdje to ne vidite.
3. Kada se pokreće, a kada ne
U trenutku identifikacije sesije: kada vaše web-mjesto pozove MousePlayer.setUserId(), kada naš analitički most pročita jedinstveni ID ili kada vaš poslužitelj pozove krajnju točku za identifikaciju. Prije toga ne znamo kome snimka pripada.
Samo s adresom e-pošte
Sve četiri platforme adresiraju kontakt prema e-pošti. Ako je vaš ID kupca broj ugovora, ništa se ne šalje – dodavanje zadatka koji može samo neuspjeti napunilo bi dnevnik šumom.
Kontakt mora već postojati. Nijedna od ovih platformi ne izrađuje kontakt iz događaja; ActiveCampaign potpuno odbacuje događaj ako ne prepoznaje adresu. Ovaj most obogaćuje postojeće kontakte – ne gradi vaš popis.
Svaki događaj nosi ID
Tako se ista sesija ne može prebrojiti dvaput, čak ni pri ponovnom pokušaju zadatka.
4. Što stiže na drugu stranu
Jedan događaj s poveznicom na reprodukciju kao svojstvom naziva mouseplayer_session_url. Otvorite ga i nalazite se u snimci upravo te sesije.
Zatim vrijedi logika vaše platforme: koristite događaj kao okidač automatizacije, uvjet segmenta ili jednostavno omogućite timu otvaranje snimke iz kontakta.
Ključ nikad ne napušta naš poslužitelj
Pohranjuje se šifriran algoritmom AES-256-GCM, nakon spremanja više se ne prikazuje i namjerno se ne stavlja u interni red sa zadatkom – radni proces sam ga dohvaća iz baze podataka.
HTTP 200 ne znači da je isporučeno
ActiveCampaign odgovara statusom 200 i {"success":0} kada odbije događaj. Čitamo tijelo odgovora, ne samo status, pa se odbijanje pojavljuje kao neuspjeh u dnevniku isporuka umjesto tihog uspjeha.
5. Braze, Customer.io i Brevo
Još tri platforme na poslužiteljskom putu. Dvije trebaju nešto što ostalima ne treba: lokaciju.
| Navodite | Identificira se prema | |
|---|---|---|
| Braze | REST krajnja točka i API ključ | adresa e-pošte |
| Customer.io | ID web-mjesta, API ključ i vaša regija | vaš vlastiti ID kupca |
| Brevo | samo ključ koda za praćenje | adresa e-pošte |
Dvije platforme vezane su uz određenu lokaciju
Braze koristi REST krajnje točke vezane uz instancu; Customer.io ima dvije zasebne regije s različitim poslužiteljima. Nijedno se ne može izvesti iz ključa, a pogrešan odabir vraća 401 – zbog čega počnete provjeravati ključ. Oba polja postoje samo iz tog razloga.
Customer.io ne treba e-poštu
Poznaje ljude prema istom ID-ju koji im dodijelite pa bi zahtjev za e-poštom bio izmišljena prepreka. Ostalih šest uparuje prema e-pošti i za njih sesija identificirana brojem ugovora ne stvara ništa – ispravno.
Bez novih profila
Braze poziv sadrži _update_existing_only. Ista odluka kao u CRM mostu: sesija preglednika nije pouzdana tvrdnja o tome tko su vaši kupci, a platforma za životni ciklus koja stvara profil za svakog anonimnog posjetitelja gora je od nikakve integracije.
Brevo odgovara 204, Braze 201 uz ogradu
Brevo uopće ne vraća tijelo – ondje je 2xx doista cijela istina. Braze vraća "message": "success" i uz to može sadržavati polje errors: kritični problemi pojavljuju se u poruci, a dopušteni gubici polja samo u errors. Čitanje samo jednog daje pogrešnu sliku u jednom ili drugom smjeru.
Svi ovdje navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos s tim pružateljima.