Жизнен цикъл (от страната на сървъра)
Изпращайте връзката за възпроизвеждане към ActiveCampaign, Mailchimp, Iterable или Klaviyo от сървъра ни в момента, когато сесия получи собствения ви клиентски идентификатор.
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 | Уебсайт → Проследяване на сайта, до ключа за събития |
| Mailchimp | Идентификаторът на аудиторията | Ключ за API — запазете суфикса му във формат -us14, от него се прочита центърът за данни |
| Iterable | не е необходимо — оставете празно | Ключ с разрешение „Разрешаване на извиквания за проследяване на събития“ |
| Klaviyo | не е необходимо — оставете празно | Един частен ключ за API |
Третото поле е името на събитието, под което ще се появява. Нека е кратко: най-много 32 знака. Това е ограничението на API, не наше, и го съкращаваме при запазване, а не при изпращане — иначе формулярът би показвал нещо различно от пристигащото.
Mailchimp: запазете суфикса на ключа си за API. Частта след последното тире (-us14) посочва центъра за данни, където е акаунтът ви, и адресът се изгражда от нея. Ключ без нея се отхвърля с ясно съобщение, вместо да се провали някъде, където не виждате.
3. Кога се задейства и кога не
В момента на идентифициране на сесията: когато сайтът ви извика MousePlayer.setUserId(), когато аналитичният ни мост прочете уникален идентификатор обратно или когато сървърът ви извика крайната точка за идентифициране. Преди това не знаем на кого принадлежи записът.
Само с имейл адрес
И четирите платформи адресират контакт по имейла му. Ако клиентският ви идентификатор е номер на договор, не се изпраща нищо — добавянето на задача, която може само да се провали, би напълнило дневника ви с шум.
Контактът трябва вече да съществува. Нито една от тези платформи не създава контакт от събитие; ActiveCampaign изхвърля събитието изцяло, ако не разпознава адреса. Този мост обогатява съществуващите ви контакти — не изгражда списъка ви.
Всяко събитие съдържа идентификатор
Така една и съща сесия не може да бъде преброена два пъти, дори задачата да бъде повторена.
4. Какво пристига от другата страна
Едно събитие с връзката за възпроизвеждане като свойство с име mouseplayer_session_url. Отворете го и сте в записа на точно тази сесия.
Оттам нататък действа логиката на платформата ви: използвайте събитието като задействащо условие за автоматизация, условие за сегмент или просто дайте възможност на екипа да отваря записа от контакта.
Ключът никога не напуска сървъра ни
Съхранява се шифрован с AES-256-GCM, никога не се показва отново след запазване и умишлено не се включва във вътрешната опашка със задачата — работникът го извлича сам от базата данни.
HTTP 200 не означава доставено
ActiveCampaign отговаря със състояние 200 и {"success":0}, когато отхвърля събитие. Прочитаме тялото на отговора, а не само състоянието, за да се появи отхвърлянето като неуспех в дневника за доставяне, вместо като незабележим успех.
5. Braze, Customer.io и Brevo
Още три платформи по сървърния път. Две от тях имат нужда от нещо, което на останалите не трябва: място.
| Вие предоставяте | Идентифициране чрез | |
|---|---|---|
| Braze | REST крайна точка и ключ за API | имейл адрес |
| Customer.io | идентификатор на сайта, ключ за API и вашия регион | собствения ви клиентски идентификатор |
| Brevo | ключа за проследяване, нищо друго | имейл адрес |
Две от тях се намират на конкретно място
Braze използва REST крайни точки, обвързани с конкретна инстанция; Customer.io има два отделни региона с различни хостове. Нито едното може да се изведе от ключа, а изборът на грешното връща 401 — което ви кара да търсите проблем в ключа. Двете полета съществуват само по тази причина.
Customer.io е платформата, която не изисква имейл
Тя познава хората по същия идентификатор, който им задавате, затова изискването за имейл адрес би било измислена пречка. Другите шест съпоставят по имейл и при тях сесия, идентифицирана с номер на договор, не произвежда нищо — правилно.
Без нови профили
Извикването към Braze съдържа _update_existing_only. Същото решение като при CRM моста: браузърната сесия не е надеждно твърдение кои са клиентите ви, а платформа за жизнен цикъл, която създава профил за всеки анонимен посетител, е по-лоша от липса на интеграция.
Brevo отговаря с 204, Braze с 201, но има уловка
Brevo не връща никакво тяло — там 2xx наистина е цялата истина. Braze връща "message": "success" и може да съдържа до него масив errors: фаталните проблеми се появяват в message, а допуснатите загуби на полета — само в errors. Прочитането само на едното води до грешка в едната или другата посока.
Всички споменати тук търговски марки принадлежат на съответните им собственици. MousePlayer няма търговски отношения с тези доставчици.