Elinkaari (palvelinpuoli)
Lähetä toistolinkki ActiveCampaigniin, Mailchimpiin, Iterableen tai Klaviyoon palvelimeltamme heti, kun istunto saa oman asiakastunnuksen.
1. Miksi tämä on selainsillan rinnalla
MousePlayerissa on jo elinkaarisilta, joka kirjoittaa omalla sivulla toimivaan SDK-ohjelmistoon — Klaviyo, Braze, Customer.io ja kuusi muuta. Tämä tekee saman palvelimeltamme, koska kahdella suurimmalla alustalla selainreittiä ei yksinkertaisesti ole:
- ActiveCampaignilla ei ole lainkaan selain-API:a tapahtumille. Sen
vgo()voi asettaa tilin ja sähköpostin sekä aloittaa seurannan — ei lähettää tapahtumaa. Tapahtumat kulkevat Event Tracking API:n kautta erillisellä tapahtuma-avaimella vain palvelinpuolella. - Mailchimpilla on, mutta sanasto on suljettu. Sen sivustoseurantapikseli hyväksyy
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDja muutaman muun ennalta määritetyn nimen. Mukautetulle tapahtumalle ei ole paikkaa, ja tietojemme puristaminen muotoonPAGE_VIEWEDolisi valhe omassa tietomallissa.
Iterablelle ja Klaviyolle palvelinreitti on yksinkertaisesti luotettavampi: ei mainosestoa, ehkä latautunutta SDK:ta tai liian aikaisin suljettua välilehteä.
2. Mitä tarvitaan
Kolme kenttää, joiden täyttö riippuu alustasta.
| Alusta | Tilikenttä | Avain |
|---|---|---|
| ActiveCampaign | actid | Sivusto → Sivustoseuranta, tapahtuma-avaimen vieressä |
| Mailchimp | Yleisötunnus | API-avain — säilytä sen -us14-tyylinen pääte, sillä palvelinkeskus luetaan siitä |
| Iterable | ei tarvita — jätä tyhjäksi | Avain, jolla on oikeus ”Salli tapahtumaseurantakutsut” |
| Klaviyo | ei tarvita — jätä tyhjäksi | Tarvitaan yksityinen API-avain |
Kolmas kenttä on tapahtuman näkyvä nimi. Pidä lyhyenä: enintään 32 merkkiä. Se on API:n raja, ei meidän, ja lyhennämme jo tallennuksessa emmekä lähetyksessä — muuten lomake näyttäisi muuta kuin perille saapuu.
Mailchimp: säilytä API-avaimen pääte. Viimeisen viivan jälkeinen osa (-us14) nimeää tilin palvelinkeskuksen, ja osoite rakennetaan siitä. Ilman päätettä avain hylätään selkeällä viestillä näkymättömän virheen sijaan.
3. Milloin laukeaa ja milloin ei
Istunnon tunnistushetkellä: kun sivusto kutsuu MousePlayer.setUserId(), analytiikkasiltamme lukee yksilöivän tunnuksen takaisin tai palvelin kutsuu tunnistuspäätepistettä. Sitä ennen emme tiedä tallenteen omistajaa.
Vain sähköpostiosoitteella
Kaikki neljä alustaa kohdistavat kontaktin sähköpostin perusteella. Jos asiakastunnus on sopimusnumero, mitään ei lähetetä — vain epäonnistuvan tehtävän jonotus täyttäisi lokin turhaan.
Kontaktin täytyy olla jo olemassa. Mikään näistä alustoista ei luo kontaktia tapahtumasta; ActiveCampaign hylkää tapahtuman kokonaan, jos osoite on tuntematon. Silta täydentää nykyisiä kontakteja, ei rakenna listaa.
Jokaisessa tapahtumassa on tunnus
Samaa istuntoa ei lasketa kahdesti, vaikka tehtävää yritetään uudelleen.
4. Mitä toiselle puolelle saapuu
Yksi tapahtuma, jonka toistolinkki on ominaisuudessa mouseplayer_session_url. Sen avaaminen vie juuri kyseisen istunnon tallenteeseen.
Siitä eteenpäin alustan oma logiikka: käytä tapahtumaa automaatiolaukaisimena, segmenttiehtona tai anna tiimin avata tallenne kontaktilta.
Avain ei koskaan poistu palvelimeltamme
Säilytetään AES-256-GCM-salattuna eikä näytetä tallennuksen jälkeen uudelleen. Sitä ei tarkoituksella laiteta sisäiseen tehtäväjonoon — työprosessi hakee sen itse tietokannasta.
HTTP 200 ei tarkoita toimitettua
ActiveCampaign vastaa tilalla 200 ja {"success":0} hylätessään tapahtuman. Luemme vastaussisällön, emme vain tilaa, joten hylkäys näkyy toimituslokissa virheenä eikä hiljaisena onnistumisena.
5. Braze, Customer.io ja Brevo
Kolme alustaa lisää palvelinreitille. Kaksi tarvitsee jotakin, mitä muut eivät: sijainnin.
| Annettavat tiedot | Tunnistuksen peruste | |
|---|---|---|
| Braze | REST-päätepiste ja API-avain | sähköposti |
| Customer.io | sivustotunnus, API-avain ja alue | oma asiakastunnus |
| Brevo | vain seuranta-avain | sähköposti |
Kaksi sijaitsee tietyssä paikassa
Braze käyttää instanssikohtaisia REST-päätepisteitä; Customer.io toimii kahdella erillisellä alueella eri isännillä. Kumpaakaan ei voi päätellä avaimesta, ja väärä valinta vastaa 401 — mikä ohjaa tutkimaan avainta. Kentät ovat olemassa juuri tästä syystä.
Customer.io ei tarvitse sähköpostia
Se tuntee henkilöt samalla itse annetulla tunnuksella, joten sähköpostivaatimus olisi keksitty este. Kuusi muuta yhdistää sähköpostilla, eikä sopimusnumerolla tunnistettu istunto tuota niissä mitään — oikein.
Ei uusia profiileja
Braze-kutsu sisältää _update_existing_only. Sama päätös kuin CRM-sillassa: selainistunto ei ole luotettava tieto asiakkaista, ja joka anonyymistä kävijästä profiilin luova elinkaarialusta on huonompi kuin integraation puuttuminen.
Brevo vastaa 204, Braze 201 varauksella
Brevo ei palauta sisältöä lainkaan — siinä 2xx todella on koko totuus. Braze palauttaa "message": "success" ja voi sisältää lisäksi errors-taulukon: vakavat ongelmat ovat viestissä, sallitut kenttämenetykset vain errors-kohdassa. Vain toisen lukeminen antaa väärän tuloksen suuntaan tai toiseen.
Kaikki tässä mainitut tavaramerkit kuuluvat omistajilleen. MousePlayerilla ei ole liikesuhdetta näihin toimittajiin.