Lifecycle (sa server)
Ipadala ang link ng replay sa ActiveCampaign, Mailchimp, Iterable o Klaviyo mula sa aming server sa sandaling matanggap ng session ang sarili ninyong customer ID.
1. Bakit Mayroon Nito Kasabay ng Bridge sa Browser
May lifecycle bridge na ang MousePlayer na sumusulat sa SDK na tumatakbo sa sarili ninyong pahina - Klaviyo, Braze, Customer.io at anim pang iba. Pareho ang ginagawa nito mula sa aming server, dahil sa dalawa sa pinakamalalaking platform, walang paraan sa browser:
- Walang browser API para sa mga event ang ActiveCampaign. Maaaring magtakda ang
vgo()nito ng account at email address at magsimula ng pagsubaybay - hindi ito makapagpapadala ng event. Sa Event Tracking API dumadaan ang mga event gamit ang hiwalay na event key, sa server lamang. - Mayroon ang Mailchimp, ngunit limitado ang mga pangalan. Tumatanggap ang site-tracking pixel nito ng
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDat ilang iba pang paunang tinukoy na pangalan. Walang lugar para sa custom event, at pagsisinungaling sa sarili ninyong modelo ng datos ang ipilit ang aming datos saPAGE_VIEWED.
Para sa Iterable at Klaviyo, mas maaasahan lamang ang paraan sa server: walang ad blocker, walang SDK na maaaring hindi nag-load, walang tab na maagang nagsara.
2. Ano ang Kailangan
Tatlong field; ayon sa platform kung alin ang pupunan.
| Platform | Field ng Account | Key |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, sa tabi ng event key |
| Mailchimp | Ang audience ID | API key - panatilihin ang hulaping may anyong -us14, dahil dito binabasa ang data centre |
| Iterable | hindi kailangan - iwang walang laman | Key na may pahintulot na “Allow event track calls” |
| Klaviyo | hindi kailangan - iwang walang laman | Isang pribadong API key |
Ang ikatlong field ay pangalan ng event na lilitaw. Gawing maikli: hindi lalampas sa 32 character. Limitasyon iyon ng API, hindi namin, at pinaiikli namin ito sa pag-save kaysa sa pagpapadala - kung hindi, magkaiba ang nasa form at ang dumarating.
Mailchimp: panatilihin ang hulapi ng API key. Ang bahaging kasunod ng huling gitling (-us14) ang tumutukoy sa data centre ng inyong account, at mula rito binubuo ang address. Tinatanggihan ang key na wala nito kasama ng malinaw na mensahe sa halip na pumalya sa hindi ninyo nakikita.
3. Kailan Ito Gumagana - at Kailan Hindi
Sa sandaling matukoy ang session: kapag tinawag ng inyong site ang MousePlayer.setUserId(), kapag binasa ng aming analytics bridge ang distinct ID, o kapag tinawag ng inyong server ang identify endpoint. Bago iyon, hindi namin alam kung kanino ang recording.
May email address lamang
Email ang gamit ng apat na platform sa pagtukoy ng contact. Kung numero ng kontrata ang inyong customer ID, walang ipinapadala - ingay lamang sa log ang pag-queue ng gawaing tiyak na mabibigo.
Kailangang mayroon nang contact. Walang platform dito ang gumagawa ng contact mula sa event; itinatapon ng ActiveCampaign ang buong event kung hindi nito kilala ang address. Pinayayaman ng bridge ang dati ninyong mga contact - hindi nito binubuo ang inyong listahan.
Bawat event ay may ID
Upang hindi mabilang nang dalawang beses ang parehong session, kahit ulitin ang gawain.
4. Ano ang Dumarating sa Kabilang Panig
Isang event, na may link ng replay bilang property na mouseplayer_session_url. Buksan iyon upang mapunta sa recording ng mismong session.
Mula roon, lohika na ng inyong platform ang masusunod: gamitin ang event bilang automation trigger, kondisyon ng segment, o hayaang buksan lamang ng inyong team ang recording mula sa contact.
Hindi umaalis sa aming server ang key
Naka-encrypt ito gamit ang AES-256-GCM, hindi na ipinapakita matapos i-save, at sadyang hindi isinasama sa internal na queue na may gawain - kinukuha mismo ito ng worker mula sa database.
Hindi nangangahulugang naihatid ang HTTP 200
Sumasagot ang ActiveCampaign ng status 200 at {"success":0} kapag tinatanggihan ang event. Binabasa namin ang response body, hindi lamang status, kaya makikita ang pagtanggi bilang pagkabigo sa delivery log sa halip na tahimik na tagumpay.
5. Braze, Customer.io at Brevo
Tatlo pang platform sa paraan sa server. Dalawa sa mga ito ang nangangailangan ng hindi kailangan ng iba: lokasyon.
| Ibinibigay Ninyo | Tinutukoy Gamit ang | |
|---|---|---|
| Braze | REST endpoint at API key | email address |
| Customer.io | site ID, API key at inyong rehiyon | sarili ninyong customer ID |
| Brevo | tracker key lamang | email address |
May Tiyak na Lokasyon ang Dalawa
May mga REST endpoint ang Braze na nakatali sa instance; may dalawang hiwalay na rehiyon na magkaiba ang host ang Customer.io. Hindi matutukoy mula sa key ang alinman, at 401 ang sagot sa maling pagpili - na magtutulak sa inyong suriin ang key. Iyon lamang ang dahilan kung bakit may parehong field.
Hindi Nangangailangan ng Email ang Customer.io
Kilala nito ang mga tao sa parehong ID na itinalaga ninyo, kaya dagdag na hadlang lamang ang paghingi ng email address. Email ang gamit ng anim na iba pa, at para sa kanila, walang ipinapadala mula sa session na tinukoy gamit ang numero ng kontrata - tama lamang iyon.
Walang Bagong Profile
Kasama sa tawag sa Braze ang _update_existing_only. Kapareho ng pasiya sa CRM bridge: hindi maaasahang pahayag kung sino ang inyong mga customer ang session sa browser, at mas masama kaysa sa walang integration ang lifecycle platform na lumilikha ng profile sa bawat anonymous na bisita.
Sumasagot ng 204 ang Brevo, 201 ang Braze na may Kailangang Pansinin
Walang body ang sagot ng Brevo - doon, buong katotohanan na ang 2xx. Nagbabalik ang Braze ng "message": "success" at maaaring may kasamang array na errors: nasa mensahe ang mga malulubhang problema, nasa errors lamang ang mga pinahihintulutang pagkawala ng field. Mali sa alinmang direksiyon kung isa lamang ang babasahin.
Ang lahat ng trademark dito ay pag-aari ng kani-kanilang may-ari. Walang ugnayang pangnegosyo ang MousePlayer sa mga provider na ito.