Lewensiklus (bedienerkant)
Stuur die herspeelskakel vanaf ons bediener na ActiveCampaign, Mailchimp, Iterable of Klaviyo sodra 'n sessie u eie klant-ID kry.
1. Waarom dit langs die blaaierbrug bestaan
MousePlayer het reeds 'n lewensiklusbrug wat na die SDK op u eie bladsy skryf — Klaviyo, Braze, Customer.io en ses ander. Hierdie een doen dieselfde werk vanaf ons bediener omdat die blaaierroete vir twee van die grootste platforms eenvoudig nie beskikbaar is nie:
- ActiveCampaign het glad geen blaaier-API vir gebeure nie. Sy
vgo()kan 'n rekening en e-posadres stel en nasporing begin — dit kan nie 'n gebeurtenis stuur nie. Gebeure gaan deur die Event Tracking API met 'n aparte gebeurtenissleutel, slegs aan die bedienerkant. - Mailchimp het een, maar met 'n geslote woordeskat. Sy webwerfnasporingspixel aanvaar
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDen 'n handvol ander voorafbepaalde name. Daar is geen plek vir 'n pasgemaakte gebeurtenis nie en om ons data in 'nPAGE_VIEWEDte dwing, sou 'n leuen in u eie datamodel wees.
Vir Iterable en Klaviyo is die bedienerroete bloot betroubaarder: geen advertensieblokker, geen SDK wat dalk nog nie gelaai het nie en geen oortjie wat te vroeg sluit nie.
2. Wat dit benodig
Drie velde; watter u invul, hang van die platform af.
| Platform | Rekeningveld | Sleutel |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, langs die gebeurtenissleutel |
| Mailchimp | Die gehoor-ID | 'n API-sleutel — behou die -us14 -tipe agtervoegsel; die datasentrum word daaruit gelees |
| Iterable | nie nodig nie — laat leeg | 'n Sleutel met die toestemming “Allow event track calls” |
| Klaviyo | nie nodig nie — laat leeg | 'n private API-sleutel |
Die derde veld is die gebeurtenisnaam waaronder dit verskyn. Hou dit kort: hoogstens 32 karakters. Dit is die API se limiet, nie ons s'n nie; ons verkort dit by stoor eerder as by versending — anders sou die vorm iets anders wys as wat aankom.
Mailchimp: behou die agtervoegsel op u API-sleutel. Die deel ná die laaste koppelteken (-us14) dui u rekening se datasentrum aan en die adres word daaruit gebou. 'n Sleutel daarsonder word met 'n duidelike boodskap geweier eerder as om onsigbaar te misluk.
3. Wanneer dit aktiveer — en wanneer nie
Sodra 'n sessie geïdentifiseer word: wanneer u webwerf MousePlayer.setUserId()aanroep, ons ontledingsbrug 'n unieke ID teruglees of u bediener die identify-eindpunt aanroep. Voor dit weet ons nie aan wie die opname behoort nie.
Net met 'n e-posadres
Al vier platforms spreek 'n kontak volgens e-pos aan. As u klant-ID 'n kontraknommer is, word niks gestuur nie — om 'n taak wat net kan misluk in die ry te plaas, sou bloot u logboek met geraas vul.
Die kontak moet reeds bestaan. Geen platform skep een uit 'n gebeurtenis nie; ActiveCampaign gooi die hele gebeurtenis weg as dit die adres nie herken nie. Hierdie brug verryk bestaande kontakte — dit bou nie u lys nie.
Elke gebeurtenis bevat 'n ID
Só kan dieselfde sessie nie twee keer getel word nie, selfs as 'n taak weer probeer word.
4. Wat aan die ander kant aankom
Een gebeurtenis met die herspeelskakel as 'n eienskap genaamd mouseplayer_session_url. Maak dit oop en u is in presies daardie sessie se opname.
Daarna geld u platform se eie logika: gebruik die gebeurtenis as outomatiseringsneller, segmentvoorwaarde of laat u span bloot die opname vanaf die kontak oopmaak.
Die sleutel verlaat nooit ons bediener nie
Dit word AES-256-GCM-geënkripteer gestoor, ná stoor nooit weer gewys nie en doelbewus nie in die interne taakry geplaas nie — die werker haal dit self uit die databasis.
HTTP 200 beteken nie afgelewer nie
ActiveCampaign antwoord met status 200 en {"success":0} wanneer dit 'n gebeurtenis weier. Ons lees die antwoordliggaam, nie net die status nie, sodat weiering as mislukking in die afleweringslogboek verskyn eerder as stille sukses.
5. Braze, Customer.io en Brevo
Nog drie platforms op die bedienerroete. Twee benodig iets wat die ander nie nodig het nie: 'n plek.
| U verskaf | Geïdentifiseer deur | |
|---|---|---|
| Braze | REST-eindpunt en API-sleutel | e-posadres |
| Customer.io | webwerf-ID, API-sleutel en u streek | u eie klant-ID |
| Brevo | net die nasporingsleutel | e-posadres |
Twee woon op 'n spesifieke plek
Braze gebruik instansiegebonde REST-eindpunte; Customer.io het twee afsonderlike streke met verskillende gashere. Nie een kan uit die sleutel afgelei word nie en die verkeerde keuse antwoord 401 — wat u na die sleutel laat kyk. Albei velde bestaan net daarom.
Customer.io is die een wat nie 'n e-posadres benodig nie
Dit ken mense onder dieselfde ID wat u toeken, dus sou 'n e-posvereiste 'n versinde hindernis wees. Die ander ses pas wel volgens e-pos en vir hulle lewer 'n sessie met 'n kontraknommer niks op nie — korrek.
Geen nuwe profiele nie
Die Braze-oproep bevat _update_existing_only. Dieselfde besluit as die CRM-brug: 'n blaaiersessie is nie 'n betroubare verklaring van wie u klante is nie en 'n lewensiklusplatform wat 'n profiel vir elke anonieme besoeker skep, is erger as geen integrasie nie.
Brevo antwoord 204, Braze antwoord 201 met 'n voorbehoud
Brevo stuur glad geen liggaam terug nie — daar is 'n 2xx werklik die hele waarheid. Braze stuur "message": "success" en kan 'n errors skikking daarby bevat: noodlottige probleme verskyn in die boodskap, gedulde veldverliese net in errors. Om net een te lees, gee in die een of ander rigting die verkeerde uitslag.
Alle handelsmerke wat hier genoem word, behoort aan hul onderskeie eienaars. MousePlayer het geen sakeverhouding met hierdie verskaffers nie.