Жыццёвы цыкл (серверны)
Адпраўляйце спасылку прайгравання ў ActiveCampaign, Mailchimp, Iterable або Klaviyo з сервера, як толькі сеанс атрымае ваш ID кліента.
1. Навошта гэта побач з браўзерным мостам
MousePlayer ужо мае мост жыццёвага цыкла, які піша ў SDK на старонцы — Klaviyo, Braze, Customer.io і шэсць іншых. Гэты робіць тое ж з сервера, бо для дзвюх найбуйнейшых платформаў браўзернага шляху няма:
- ActiveCampaign наогул не мае браўзернага API падзей. Яго
vgo()можа задаць акаўнт і пошту і пачаць адсочванне, але не адправіць падзею. Падзеі ідуць праз Event Tracking API з асобным ключом, толькі серверна. - Mailchimp мае яго, але з закрытым слоўнікам. Піксель сайта прымае
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDі некалькі іншых зададзеных назваў. Для ўласнай падзеі месца няма, а ўціснуць нашы даныя ўPAGE_VIEWEDазначала б хлусню ва ўласнай мадэлі даных.
Для Iterable і Klaviyo серверны шлях проста надзейнейшы: без блакіроўшчыкаў, непрадказальнай загрузкі SDK і ранняга закрыцця ўкладкі.
2. Што патрэбна
Тры палі; запаўненне залежыць ад платформы.
| Платформа | Поле акаўнта | Ключ |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, побач з ключом падзей |
| Mailchimp | ID аўдыторыі | API-ключ — захавайце суфікс у стылі -us14 , з яго вызначаецца дата-цэнтр |
| Iterable | не патрэбна — пакіньце пустым | Ключ з дазволам «Allow event track calls» |
| Klaviyo | не патрэбна — пакіньце пустым | Гэта прыватны API-ключ |
Трэцяе поле — назва падзеі, пад якой яна з'явіцца. Кароткая: не больш за 32 сімвалы. Гэта ліміт API, не наш. Мы скарачаем пры захаванні, не адпраўцы, інакш форма паказвала б не тое, што прыходзіць.
Mailchimp: захавайце суфікс API-ключа. Частка пасля апошняга злучка (-us14) называе дата-цэнтр акаўнта, з яе будуецца адрас. Ключ без яе адхіляецца са зразумелым паведамленнем замест нябачнага збою.
3. Калі спрацоўвае і калі не
Пры ідэнтыфікацыі сеанса: калі сайт выклікае MousePlayer.setUserId(), мост чытае асобны ID або сервер выклікае identify. Да гэтага мы не ведаем, каму належыць запіс.
Толькі з электроннай поштай
Усе чатыры платформы адрасуюць кантакт па пошце. Калі ID — нумар дагавора, нічога не адпраўляецца: задача, якая можа толькі праваліцца, засмеціла б журнал.
Кантакт ужо павінен існаваць. Ніводная платформа не стварае яго з падзеі; ActiveCampaign цалкам адкідае падзею для невядомай пошты. Мост узбагачае існыя кантакты, а не будуе спіс.
Кожная падзея мае ID
Таму сеанс нельга палічыць двойчы, нават пры паўторнай задачы.
4. Што паступае на іншы бок
Адна падзея са спасылкай прайгравання ва ўласцівасці mouseplayer_session_url. Адкрыйце яе, каб трапіць у запіс менавіта гэтага сеанса.
Далей працуе логіка платформы: выкарыстоўвайце падзею як трыгер аўтаматызацыі, умову сегмента або проста дайце камандзе адкрыць запіс з кантакту.
Ключ ніколі не пакідае сервер
Ён захоўваецца з AES-256-GCM, не паказваецца пасля захавання і наўмысна не трапляе ў чаргу задач — воркер сам атрымлівае яго з базы.
HTTP 200 не азначае дастаўку
ActiveCampaign пры адмове падзеі адказвае статусам 200 і {"success":0} . Мы чытаем цела, таму адмова паказваецца ў журнале як збой, а не ціхае паспяховае выкананне.
5. Braze, Customer.io і Brevo
Яшчэ тры серверныя платформы. Дзвюм патрэбна тое, чаго не трэба іншым: месца.
| Вы задаяце | Ідэнтыфікацыя па | |
|---|---|---|
| Braze | REST-кропцы і API-ключы | электроннай пошце |
| Customer.io | ID сайта, API-ключы і рэгіёне | вашым уласным ID кліента |
| Brevo | толькі ключы трэкера | электроннай пошце |
Дзве знаходзяцца ў канкрэтным месцы
Braze мае REST-кропкі, звязаныя з асобнікам; Customer.io — два рэгіёны з рознымі хостамі. Іх не вызначыць з ключа, а няправільны выбар дае 401 і прымушае правяраць ключ. Толькі таму існуюць гэтыя палі.
Customer.io не патрабуе пошты
Ён ведае людзей па вашым ID, таму патрабаваць пошту было б выдуманай перашкодай. Іншыя шэсць супастаўляюць па пошце, і для іх сеанс з нумарам дагавора правільна нічога не стварае.
Без новых профіляў
Выклік Braze перадае _update_existing_only. Як і ў мосце CRM, сеанс браўзера не з'яўляецца надзейнай інфармацыяй пра кліентаў; платформа з профілем на кожнага ананімнага наведвальніка горшая за адсутнасць інтэграцыі.
Brevo адказвае 204, Braze — 201 з агаворкай
Brevo не вяртае цела; тут 2xx сапраўды дастаткова. Braze вяртае "message": "success" і можа мець побач масіў errors : фатальныя праблемы ў message, дапушчальныя страты палёў толькі ў errors. Чытанне чагосьці аднаго дасць памылку ў адзін з бакоў.
Усе згаданыя таварныя знакі належаць адпаведным уладальнікам. MousePlayer не мае дзелавых адносін з гэтымі пастаўшчыкамі.