Životný cyklus (na strane servera)

1. Prečo existuje popri moste v prehliadači

MousePlayer už má most životného cyklu, ktorý zapisuje do SDK bežiaceho na vašej stránke – Klaviyo, Braze, Customer.io a šiestich ďalších. Tento robí rovnakú prácu z nášho servera a existuje preto, že pri dvoch najväčších platformách cesta cez prehliadač jednoducho nie je dostupná:

• ActiveCampaign vôbec nemá API pre udalosti v prehliadači. Jeho vgo() môže nastaviť účet a e-mailovú adresu a spustiť sledovanie – nemôže odoslať udalosť. Udalosti sa posielajú cez Event Tracking API so samostatným kľúčom udalostí, iba na strane servera.
• Mailchimp ho má, no s uzavretým zoznamom názvov. Jeho pixel na sledovanie webu prijíma PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED a niekoľko ďalších preddefinovaných názvov. Vlastná udalosť nemá vyhradené miesto a vtesnať naše údaje do udalosti PAGE_VIEWED by bolo klamstvom vo vašom vlastnom dátovom modeli.

2. Čo potrebuje

Tri polia a ich vyplnenie závisí od platformy.

Tretie pole je názov udalosti, pod ktorým sa zobrazí. Nech je krátky: najviac 32 znakov. Je to limit API, nie náš, a názov skracujeme pri uložení, nie pri odoslaní – inak by formulár ukazoval niečo iné, než čo dorazí.

3. Kedy sa spúšťa – a kedy nie

V okamihu identifikácie relácie: keď váš web zavolá MousePlayer.setUserId(), keď náš analytický most spätne načíta jedinečný identifikátor alebo keď váš server zavolá koncový bod identifikácie. Dovtedy nevieme, komu záznam patrí.

Iba s e-mailovou adresou

Všetky štyri platformy oslovujú kontakt pomocou e-mailu. Ak je vaše ID zákazníka číslom zmluvy, nič sa neodošle – zaradenie úlohy, ktorá môže iba zlyhať, do frontu by len zaplnilo denník šumom.

Každá udalosť nesie ID

Aby sa rovnaká relácia nezapočítala dvakrát ani pri opakovaní úlohy.

4. Čo dorazí na druhú stranu

Jedna udalosť s odkazom na prehrávanie vo vlastnosti s názvom mouseplayer_session_url. Otvorte ju a ste v zázname presne tejto relácie.

Ďalej už platí logika vašej platformy: použite udalosť ako spúšťač automatizácie, podmienku segmentu alebo jednoducho nechajte tím otvoriť záznam z kontaktu.

Kľúč nikdy neopustí náš server

Ukladá sa šifrovaný pomocou AES-256-GCM, po uložení sa už nezobrazuje a zámerne sa nevkladá do interného frontu prenášajúceho úlohu – proces spracovania si ho načíta priamo z databázy.

HTTP 200 neznamená doručenie

ActiveCampaign odpovedá stavom 200 a {"success":0} pri odmietnutí udalosti. Čítame telo odpovede, nie iba stav, preto sa odmietnutie v denníku doručení zobrazí ako zlyhanie namiesto tichého úspechu.