Životní cyklus (na serveru)
Odešlete odkaz na přehrávání do ActiveCampaign, Mailchimp, Iterable nebo Klaviyo z našeho serveru v okamžiku, kdy relace získá vaše vlastní ID zákazníka.
1. Proč existuje vedle mostu v prohlížeči
MousePlayer už má most pro životní cyklus, který zapisuje do SDK na vaší stránce - Klaviyo, Braze, Customer.io a šesti dalších. Tento dělá totéž z našeho serveru a existuje proto, že u dvou největších platforem cesta přes prohlížeč jednoduše není dostupná:
- ActiveCampaign vůbec nemá API pro události v prohlížeči. Jeho funkce
vgo()umí nastavit účet a e-mailovou adresu a zahájit sledování, ale neumí odeslat událost. Události procházejí přes Event Tracking API se samostatným klíčem událostí, pouze na serveru. - Mailchimp ho má, ale s uzavřenou slovní zásobou. Jeho pixel pro sledování webu přijímá
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDa několik dalších předdefinovaných názvů. Pro vlastní událost zde není místo a vtěsnat naše data doPAGE_VIEWEDby znamenalo lež ve vašem vlastním datovém modelu.
U Iterable a Klaviyo je serverová cesta jednoduše spolehlivější: žádné blokování reklam, žádné SDK, které se možná načetlo a možná ne, a žádné předčasné zavření karty.
2. Co je potřeba
Tři pole; která vyplníte, závisí na platformě.
| Platforma | Pole účtu | Klíč |
|---|---|---|
| ActiveCampaign | actid | Website → Site Tracking, vedle klíče událostí |
| Mailchimp | ID publika | Klíč API - ponechte příponu ve tvaru -us14 , podle které se určuje datové centrum |
| Iterable | není potřeba - ponechte prázdné | Klíč s oprávněním „Allow event track calls“ |
| Klaviyo | není potřeba - ponechte prázdné | Použijte soukromý klíč API |
Třetí pole je název události, pod kterým se zobrazí. Zvolte krátký název: nejvýše 32 znaků. Jde o limit API, nikoli náš, a název zkracujeme při uložení, ne při odeslání - jinak by formulář zobrazoval něco jiného, než co dorazí.
Mailchimp: ponechte příponu klíče API. Část za poslední pomlčkou (-us14) označuje datové centrum vašeho účtu a sestavuje se podle ní adresa. Klíč bez přípony odmítneme s jasnou zprávou, místo aby selhal někde mimo váš dohled.
3. Kdy se most spouští a kdy ne
V okamžiku identifikace relace: když váš web zavolá MousePlayer.setUserId(), když náš analytický most přečte jedinečné ID nebo když váš server zavolá endpoint identify. Předtím nevíme, komu záznam patří.
Pouze s e-mailovou adresou
Všechny čtyři platformy oslovují kontakt podle e-mailu. Pokud je vaše ID zákazníka číslo smlouvy, nic se neodešle - zařadit do fronty úlohu, která může jen selhat, by pouze zaplnilo protokol šumem.
Kontakt už musí existovat. Žádná z těchto platforem ho z události nevytvoří; ActiveCampaign událost zcela zahodí, pokud adresu nezná. Tento most obohacuje stávající kontakty, nevytváří váš seznam.
Každá událost má ID
Stejná relace se tak nemůže započítat dvakrát, ani při opakování úlohy.
4. Co dorazí na druhou stranu
Jedna událost s odkazem na přehrávání ve vlastnosti nazvané mouseplayer_session_url. Otevřete ho a dostanete se k záznamu přesně dané relace.
Dál už rozhoduje logika vaší platformy: použijte událost jako spouštěč automatizace, podmínku segmentu nebo nechte tým otevřít záznam přímo z kontaktu.
Klíč nikdy neopustí náš server
Je uložen zašifrovaný pomocí AES-256-GCM, po uložení se už nezobrazuje a záměrně se nevkládá do interní fronty úloh - worker si ho sám načte z databáze.
HTTP 200 neznamená doručeno
ActiveCampaign při odmítnutí události odpoví stavem 200 a {"success":0} . Čteme tělo odpovědi, nejen stavový kód, takže odmítnutí se v protokolu doručení objeví jako selhání, nikoli jako tichý úspěch.
5. Braze, Customer.io a Brevo
Další tři platformy pro serverovou cestu. Dvě z nich potřebují něco, co ostatní ne: umístění.
| Zadáte | Identifikace podle | |
|---|---|---|
| Braze | endpoint REST a klíč API | e-mailové adresy |
| Customer.io | ID webu, klíč API a region | vašeho vlastního ID zákazníka |
| Brevo | pouze klíč pro sledování | e-mailové adresy |
Dvě platformy mají konkrétní umístění
Braze používá endpointy REST vázané na instanci; Customer.io má dva samostatné regiony s různými hostiteli. Umístění nelze odvodit z klíče a špatná volba vrátí 401, což vás vede ke kontrole klíče. Jen proto obě pole existují.
Customer.io nepotřebuje e-mail
Zná osoby pod stejným ID, které jim přidělujete vy, takže požadavek na e-mail by byl umělou překážkou. Ostatních šest platforem páruje podle e-mailu a relace identifikovaná číslem smlouvy u nich správně nic nevytvoří.
Žádné nové profily
Volání Braze obsahuje _update_existing_only. Stejné rozhodnutí jako u mostu CRM: relace v prohlížeči není spolehlivým údajem o tom, kdo jsou vaši zákazníci, a platforma životního cyklu vytvářející profil pro každého anonymního návštěvníka je horší než žádná integrace.
Brevo odpovídá 204, Braze 201 s výhradou
Brevo nevrací žádné tělo odpovědi - tam stav 2xx opravdu říká vše. Braze vrací "message": "success" a vedle toho může obsahovat pole errors : závažné problémy jsou v message, tolerované ztráty polí jen v errors. Číst pouze jednu část vede k chybnému závěru v jednom či druhém směru.
Všechny uvedené ochranné známky patří příslušným vlastníkům. MousePlayer s těmito poskytovateli nemá obchodní vztah.