Ž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, PURCHASED a několik dalších předdefinovaných názvů. Pro vlastní událost zde není místo a vtěsnat naše data do PAGE_VIEWED by 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ě.

PlatformaPole účtuKlíč
ActiveCampaignactidWebsite → Site Tracking, vedle klíče událostí
MailchimpID publikaKlíč API - ponechte příponu ve tvaru -us14 , podle které se určuje datové centrum
Iterablenení potřeba - ponechte prázdnéKlíč s oprávněním „Allow event track calls“
Klaviyonení 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áteIdentifikace podle
Brazeendpoint REST a klíč APIe-mailové adresy
Customer.ioID webu, klíč API a regionvašeho vlastního ID zákazníka
Brevopouze 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.