Életciklus (szerveroldali)
A visszajátszási linket szerverünkről küldheti az ActiveCampaign, Mailchimp, Iterable vagy Klaviyo rendszerébe, amint egy munkamenet megkapja saját ügyfélazonosítóját.
1. Miért létezik a böngészős híd mellett
A MousePlayernek már van életciklus-hídja, amely az Ön oldalán futó SDK-ba ír — Klaviyo, Braze, Customer.io és hat másik rendszer esetén. Ez a híd ugyanazt végzi szerverünkről, mert két legnagyobb platformnál a böngészős út egyszerűen nem elérhető:
- Az ActiveCampaignnek egyáltalán nincs böngészős esemény-API-ja. A
vgo()beállíthat fiókot és e-mail-címet, elindíthatja a követést — eseményt viszont nem küldhet. Az események külön eseménykulccsal, kizárólag szerveroldalon, az Event Tracking API-n át mennek. - A Mailchimpnek van, de zárt szókészlettel. Webhelykövető pixelje a
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDés néhány más előre megadott nevet fogadja el. Egyedi eseménynek nincs helye, adatainkat pedig egyPAGE_VIEWEDeseménybe préselni valótlanság lenne saját adatmodelljében.
Az Iterable és a Klaviyo esetén a szerveroldali út egyszerűen megbízhatóbb: nincs reklámblokkoló, esetleg be sem töltött SDK vagy túl korán bezárt lap.
2. Mire van szükség
Három mező van; a platformtól függ, melyeket kell kitölteni.
| Platform | Fiókmező | Kulcs |
|---|---|---|
| ActiveCampaign | actid | Webhely → Webhelykövetés, az eseménykulcs mellett |
| Mailchimp | A célközönség azonosítója | Egy API-kulcs — tartsa meg a -us14 jellegű végződést, ebből olvassuk ki az adatközpontot |
| Iterable | nem szükséges — hagyja üresen | „Eseménykövetési hívások engedélyezése” jogosultságú kulcs |
| Klaviyo | nem szükséges — hagyja üresen | Egy privát API-kulcs |
A harmadik mező az eseménynév, amely alatt megjelenik. Legyen rövid: legfeljebb 32 karakter. Ez az API korlátja, nem a miénk; mentéskor rövidítjük, nem küldéskor — máskülönben az űrlap mást mutatna, mint ami megérkezik.
Mailchimp: hagyja meg API-kulcsa végződését. Az utolsó kötőjel utáni rész (-us14) azonosítja fiókja adatközpontját, és ebből állítjuk össze a címet. E rész nélküli kulcsot világos üzenettel utasítunk el, így nem valahol észrevétlenül hibásodik meg.
3. Mikor aktiválódik — és mikor nem
A munkamenet azonosításának pillanatában: amikor webhelye meghívja ezt: MousePlayer.setUserId(), amikor analitikai hidunk visszaolvas egy egyedi azonosítót, vagy amikor szervere meghívja az azonosítási végpontot. Addig nem tudjuk, kihez tartozik a felvétel.
Csak e-mail-címmel
Mind a négy platform e-mail-címmel azonosítja a névjegyet. Ha ügyfélazonosítója szerződésszám, semmit nem küldünk — egy eleve sikertelen feladat várólistába állítása csak zajjal töltené meg a naplót.
A névjegynek már léteznie kell. Egyik platform sem hoz létre névjegyet eseményből; az ActiveCampaign teljesen eldobja az eseményt, ha nem ismeri fel a címet. Ez a híd meglévő névjegyeit gazdagítja — nem listát épít.
Minden eseményhez azonosító tartozik
Így ugyanaz a munkamenet nem számolható kétszer, újrapróbált feladatnál sem.
4. Mi érkezik a másik oldalra
Egy esemény, benne a visszajátszási link ezzel a tulajdonságnévvel: mouseplayer_session_url. Nyissa meg, és pontosan annak a munkamenetnek a felvételére jut.
Innentől platformja saját logikáját használja: az esemény lehet automatizálás indítója vagy szegmensfeltétel, vagy egyszerűen lehetővé teheti csapatának, hogy a névjegyből nyissa meg a felvételt.
A kulcs soha nem hagyja el a szerverünket
AES-256-GCM titkosítással tároljuk, mentés után többé nem mutatjuk meg, és szándékosan nem tesszük a feladatot hordozó belső várólistába — a feldolgozó maga kéri le az adatbázisból.
A HTTP 200 nem jelent kézbesítést
Az ActiveCampaign 200-as állapottal és {"success":0} értékkel válaszol, ha elutasít egy eseményt. A válasz törzsét olvassuk, nem csupán az állapotkódot, így az elutasítás hibaként jelenik meg a kézbesítési naplóban, nem észrevétlen sikerként.
5. Braze, Customer.io és Brevo
További három platform a szerveroldali úton. Kettő olyasmit kér, amit a többi nem: helyet.
| Mit kell megadnia | Azonosítás alapja | |
|---|---|---|
| Braze | REST-végpont és API-kulcs | e-mail-cím |
| Customer.io | webhelyazonosító, API-kulcs és régió | saját ügyfélazonosítója |
| Brevo | csak a követőkulcs, semmi más | e-mail-cím |
Kettő meghatározott helyen működik
A Braze példányhoz kötött REST-végpontokat használ; a Customer.io két külön régióban, eltérő kiszolgálókkal működik. Egyik sem állapítható meg a kulcsból, és hibás választásnál 401 a válasz — amitől a kulcsban keresné a hibát. Mindkét mező kizárólag ezért létezik.
A Customer.io az, amelynek nem kell e-mail-cím
Az Ön által kiosztott azonosítóval ismeri az embereket, ezért az e-mail-cím megkövetelése kitalált akadály lenne. A többi hat valóban e-mail-cím alapján egyeztet; náluk a szerződésszámmal azonosított munkamenet nem eredményez semmit — helyesen.
Nincsenek új profilok
A Braze-hívás tartalmazza ezt: _update_existing_only. Ugyanaz a döntés, mint a CRM-hídnál: egy böngészős munkamenet nem megbízható állítás arról, kik az ügyfelei, és a névtelen látogatónként új profilt létrehozó életciklus-platform rosszabb, mint az integráció hiánya.
A Brevo 204-gyel válaszol, a Braze 201-gyel, de van egy csavar
A Brevo egyáltalán nem küld választörzset — ott a 2xx valóban a teljes igazság. A Braze ezt adja vissza: "message": "success", és mellette egy errors tömb is lehet: a végzetes problémák a message mezőben jelennek meg, az elfogadott mezőkiesések csak az errors mezőben. Ha csak az egyiket olvassa, valamelyik irányban hibás következtetésre jut.
Az itt említett védjegyek a tulajdonosaikhoz tartoznak. A MousePlayer nem áll üzleti kapcsolatban ezekkel a szolgáltatókkal.