Životni ciklus (poslužiteljska strana)

Pošaljite poveznicu na reprodukciju u ActiveCampaign, Mailchimp, Iterable ili Klaviyo s našeg poslužitelja čim sesija dobije vaš vlastiti ID kupca.

1. Zašto postoji uz most u pregledniku

MousePlayer već ima most za životni ciklus koji zapisuje u SDK na vašoj stranici – Klaviyo, Braze, Customer.io i još šest drugih. Ovaj radi isto s našeg poslužitelja jer za dvije najveće platforme put kroz preglednik jednostavno nije dostupan:

  • ActiveCampaign uopće nema API za događaje u pregledniku. Njegov vgo() može postaviti račun i adresu e-pošte te pokrenuti praćenje – ne može poslati događaj. Događaji idu putem Event Tracking API-ja sa zasebnim ključem događaja, isključivo s poslužiteljske strane.
  • Mailchimp ga ima, ali sa zatvorenim skupom naziva. Njegov piksel za praćenje web-mjesta prihvaća PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED i nekoliko drugih unaprijed definiranih naziva. Nema mjesta za prilagođeni događaj, a ugurati naše podatke u PAGE_VIEWED bilo bi unošenje neistine u vaš podatkovni model.

Za Iterable i Klaviyo put s poslužitelja jednostavno je pouzdaniji: bez blokatora oglasa, SDK-a koji se možda učitao, a možda nije, i preranog zatvaranja kartice.

2. Što je potrebno

Tri polja, a koja ćete ispuniti ovisi o platformi.

PlatformaPolje računaKljuč
ActiveCampaignactidWeb-mjesto → Praćenje web-mjesta, pokraj ključa događaja
MailchimpID publikeAPI ključ – zadržite nastavak poput -us14 jer se iz njega čita podatkovni centar
Iterablenije potrebno – ostavite praznoKljuč s dopuštenjem „Dopusti pozive za praćenje događaja“
Klaviyonije potrebno – ostavite prazno Privatni API ključ

Treće polje je naziv pod kojim se događaj pojavljuje. Neka bude kratak: najviše 32 znaka. To je ograničenje API-ja, a ne naše; skraćujemo ga pri spremanju, a ne slanju – inače bi obrazac prikazivao nešto drukčije od onoga što stiže.

Mailchimp: zadržite nastavak API ključa. Dio nakon posljednje crtice (-us14) označava podatkovni centar vašeg računa, a iz njega se gradi adresa. Ključ bez njega odbija se jasnom porukom umjesto da zakaže ondje gdje to ne vidite.

3. Kada se pokreće, a kada ne

U trenutku identifikacije sesije: kada vaše web-mjesto pozove MousePlayer.setUserId(), kada naš analitički most pročita jedinstveni ID ili kada vaš poslužitelj pozove krajnju točku za identifikaciju. Prije toga ne znamo kome snimka pripada.

Samo s adresom e-pošte

Sve četiri platforme adresiraju kontakt prema e-pošti. Ako je vaš ID kupca broj ugovora, ništa se ne šalje – dodavanje zadatka koji može samo neuspjeti napunilo bi dnevnik šumom.

Kontakt mora već postojati. Nijedna od ovih platformi ne izrađuje kontakt iz događaja; ActiveCampaign potpuno odbacuje događaj ako ne prepoznaje adresu. Ovaj most obogaćuje postojeće kontakte – ne gradi vaš popis.

Svaki događaj nosi ID

Tako se ista sesija ne može prebrojiti dvaput, čak ni pri ponovnom pokušaju zadatka.

4. Što stiže na drugu stranu

Jedan događaj s poveznicom na reprodukciju kao svojstvom naziva mouseplayer_session_url. Otvorite ga i nalazite se u snimci upravo te sesije.

Zatim vrijedi logika vaše platforme: koristite događaj kao okidač automatizacije, uvjet segmenta ili jednostavno omogućite timu otvaranje snimke iz kontakta.

Ključ nikad ne napušta naš poslužitelj

Pohranjuje se šifriran algoritmom AES-256-GCM, nakon spremanja više se ne prikazuje i namjerno se ne stavlja u interni red sa zadatkom – radni proces sam ga dohvaća iz baze podataka.

HTTP 200 ne znači da je isporučeno

ActiveCampaign odgovara statusom 200 i {"success":0} kada odbije događaj. Čitamo tijelo odgovora, ne samo status, pa se odbijanje pojavljuje kao neuspjeh u dnevniku isporuka umjesto tihog uspjeha.

5. Braze, Customer.io i Brevo

Još tri platforme na poslužiteljskom putu. Dvije trebaju nešto što ostalima ne treba: lokaciju.

NavoditeIdentificira se prema
BrazeREST krajnja točka i API ključadresa e-pošte
Customer.ioID web-mjesta, API ključ i vaša regijavaš vlastiti ID kupca
Brevosamo ključ koda za praćenjeadresa e-pošte

Dvije platforme vezane su uz određenu lokaciju

Braze koristi REST krajnje točke vezane uz instancu; Customer.io ima dvije zasebne regije s različitim poslužiteljima. Nijedno se ne može izvesti iz ključa, a pogrešan odabir vraća 401 – zbog čega počnete provjeravati ključ. Oba polja postoje samo iz tog razloga.

Customer.io ne treba e-poštu

Poznaje ljude prema istom ID-ju koji im dodijelite pa bi zahtjev za e-poštom bio izmišljena prepreka. Ostalih šest uparuje prema e-pošti i za njih sesija identificirana brojem ugovora ne stvara ništa – ispravno.

Bez novih profila

Braze poziv sadrži _update_existing_only. Ista odluka kao u CRM mostu: sesija preglednika nije pouzdana tvrdnja o tome tko su vaši kupci, a platforma za životni ciklus koja stvara profil za svakog anonimnog posjetitelja gora je od nikakve integracije.

Brevo odgovara 204, Braze 201 uz ogradu

Brevo uopće ne vraća tijelo – ondje je 2xx doista cijela istina. Braze vraća "message": "success" i uz to može sadržavati polje errors: kritični problemi pojavljuju se u poruci, a dopušteni gubici polja samo u errors. Čitanje samo jednog daje pogrešnu sliku u jednom ili drugom smjeru.

Svi ovdje navedeni žigovi pripadaju svojim vlasnicima. MousePlayer nema poslovni odnos s tim pružateljima.