Kliento gyvavimo ciklas (serveryje)
Siųskite atkūrimo nuorodą į ActiveCampaign, Mailchimp, Iterable ar Klaviyo iš mūsų serverio, vos seansui priskiriamas jūsų kliento ID.
1. Kodėl tai yra greta naršyklės tilto
MousePlayer jau turi kliento gyvavimo ciklo tiltą, rašantį į jūsų puslapyje veikiantį SDK: Klaviyo, Braze, Customer.io ir dar šešis. Šis atlieka tą patį iš mūsų serverio ir reikalingas todėl, kad dviejose didžiausiose platformose naršyklės kelias tiesiog neprieinamas:
- ActiveCampaign apskritai neturi naršyklės įvykių API. Jo
vgo()gali nustatyti paskyrą ir el. pašto adresą bei pradėti sekimą, tačiau negali siųsti įvykio. Įvykiai siunčiami tik serveryje per Event Tracking API su atskiru įvykių raktu. - Mailchimp ją turi, tačiau tik su baigtiniu žodynu. Jo svetainės sekimo pikselis priima
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDir kelis kitus iš anksto apibrėžtus pavadinimus. Pasirinktiniam įvykiui vietos nėra, o mūsų duomenų pateikimas kaipPAGE_VIEWEDbūtų melas jūsų pačių duomenų modelyje.
Iterable ir Klaviyo serverio kelias tiesiog patikimesnis: netrukdo reklamos blokavimas, galbūt neįkeltas SDK ar per anksti uždaryta kortelė.
2. Ko reikia
Trijų laukų; kuriuos pildysite, priklauso nuo platformos.
| Platforma | Paskyros laukas | Raktas |
|---|---|---|
| ActiveCampaign | actid | Svetainė → Svetainės sekimas, šalia įvykių rakto |
| Mailchimp | Auditorijos ID | API raktas; palikite jo -us14 tipo priesagą, pagal kurią nustatomas duomenų centras |
| Iterable | nereikia, palikite tuščią | Raktas su teise „Allow event track calls“ |
| Klaviyo | nereikia, palikite tuščią | Šis privatus API raktas |
Trečiasis laukas yra įvykio pavadinimas, kuriuo jis bus rodomas. Trumpai: ne daugiau kaip 32 ženklai. Tai API, o ne mūsų apribojimas; trumpiname išsaugant, o ne siunčiant, kitaip forma rodytų ką kita nei gaunamas rezultatas.
Mailchimp: palikite API rakto priesagą. Dalis po paskutinio brūkšnelio (-us14) nurodo paskyros duomenų centrą; pagal ją sudaromas adresas. Raktas be jos atmetamas aiškiu pranešimu, o ne tyliai sugenda ten, kur nematysite.
3. Kada suveikia ir kada ne
Seanso identifikavimo momentu: kai svetainė iškviečia MousePlayer.setUserId(), kai analitikos tiltas nuskaito unikalų ID arba kai jūsų serveris iškviečia identifikavimo galinį adresą. Iki tol nežinome, kam priklauso įrašas.
Tik su el. pašto adresu
Visos keturios platformos kontaktą nurodo pagal el. paštą. Jei jūsų kliento ID yra sutarties numeris, nieko nesiunčiama: užduotis, kuri gali tik nepavykti, tik užterštų žurnalą.
Kontaktas jau turi egzistuoti. Nė viena šių platformų nekuria kontakto iš įvykio; ActiveCampaign visai atmeta įvykį, jei adreso neatpažįsta. Šis tiltas papildo esamus kontaktus, o ne kuria jūsų sąrašą.
Kiekvienas įvykis turi ID
Todėl tas pats seansas negali būti įskaitytas du kartus, net jei užduotis kartojama.
4. Kas gaunama kitoje pusėje
Vienas įvykis su atkūrimo nuoroda savybėje, pavadintoje mouseplayer_session_url. Atidarę ją matysite būtent to seanso įrašą.
Toliau galioja jūsų platformos logika: naudokite įvykį automatizavimo suveikimui, kaip segmento sąlygą arba tiesiog leiskite komandai atidaryti įrašą iš kontakto.
Raktas niekada neišeina iš mūsų serverio
Saugomas užšifruotas naudojant AES-256-GCM, išsaugojus daugiau nerodomas ir sąmoningai neįtraukiamas į vidinę užduočių eilę: vykdytojas pats paima jį iš duomenų bazės.
HTTP 200 nereiškia pristatymo
Atmesdamas įvykį ActiveCampaign atsako būsena 200 ir {"success":0}. Skaitome atsakymo turinį, o ne vien būseną, todėl atmetimas siuntimų žurnale rodomas kaip klaida, o ne tyliai laikomas sėkme.
5. Braze, Customer.io ir Brevo
Dar trys platformos serverio kelyje. Dviem reikia to, ko kitoms nereikia: vietos.
| Pateikiate | Identifikuojama pagal | |
|---|---|---|
| Braze | REST galinis adresas ir API raktas | el. pašto adresą |
| Customer.io | svetainės ID, API raktas ir regionas | jūsų kliento ID |
| Brevo | tik sekimo raktas, nieko daugiau | el. pašto adresą |
Dvi turi konkrečią vietą
Braze naudoja su egzemplioriumi susietus REST galinius adresus; Customer.io veikia dviejuose atskiruose regionuose su skirtingais serveriais. Nė vieno negalima nustatyti pagal raktą, o pasirinkus neteisingą gaunama 401, todėl imama ieškoti rakto klaidos. Abu laukai yra būtent dėl to.
Customer.io nereikia el. pašto
Žmonės atpažįstami pagal tą patį jūsų priskirtą ID, todėl el. pašto reikalavimas būtų išgalvota kliūtis. Kitos šešios platformos sieja pagal el. paštą; joms sutarties numeriu identifikuotas seansas nieko nesukuria, kaip ir turi būti.
Jokių naujų profilių
Braze kvietimas perduoda _update_existing_only. Sprendimas toks pat kaip CRM tilte: naršyklės seansas nėra patikimas teiginys apie tai, kas yra jūsų klientai, o kiekvienam anonimui profilį kurianti kliento gyvavimo ciklo platforma blogesnė už jokios integracijos nebuvimą.
Brevo grąžina 204, Braze – 201 su išlyga
Brevo negrąžina jokio turinio: ten 2xx iš tikrųjų pasako viską. Braze grąžina "message": "success" ir šalia gali turėti masyvą errors: kritinės problemos pateikiamos pranešime, toleruojami laukų praradimai – tik errors. Skaitant tik vieną, klaidingai įvertinama viena arba kita pusė.
Visi čia paminėti prekių ženklai priklauso jų savininkams. MousePlayer su šiais teikėjais neturi verslo ryšių.