Ciclo di vita (lato server)

1. Perché esiste accanto al connettore browser

MousePlayer ha già un connettore di ciclo di vita che scrive nell’SDK sulla sua pagina: Klaviyo, Braze, Customer.io e altri sei. Questo fa lo stesso dal nostro server, perché per due delle piattaforme maggiori il percorso browser non è disponibile:

• ActiveCampaign non ha API browser per gli eventi. Il suo vgo() può impostare account ed e-mail e avviare il monitoraggio, ma non inviare eventi. Gli eventi passano dall’Event Tracking API con una chiave distinta, solo lato server.
• Mailchimp ne ha una, ma con un vocabolario chiuso. Il pixel di monitoraggio del sito accetta PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED e pochi altri nomi predefiniti. Non c’è spazio per eventi personalizzati e forzare i nostri dati in un PAGE_VIEWED falserebbe il suo modello di dati.

2. Cosa serve

Tre campi, da compilare in base alla piattaforma.

Il terzo campo è il nome con cui apparirà l’evento. Lo mantenga breve: al massimo 32 caratteri. È il limite dell’API, non il nostro; lo accorciamo al salvataggio invece che all’invio, per evitare che il modulo mostri qualcosa di diverso da ciò che arriva.

3. Quando si attiva e quando no

Quando una sessione viene identificata: quando il suo sito chiama MousePlayer.setUserId(), quando il connettore di analisi recupera un ID distinto o quando il server chiama l’endpoint di identificazione. Prima non sappiamo a chi appartiene la registrazione.

Solo con un indirizzo e-mail

Tutte e quattro le piattaforme identificano i contatti tramite e-mail. Se l’ID cliente è un numero di contratto, non viene inviato nulla: accodare un’attività destinata a fallire riempirebbe solo il registro.

Ogni evento contiene un ID

Così la stessa sessione non può essere conteggiata due volte, neppure in caso di nuovo tentativo.

4. Cosa arriva dall’altra parte

Un evento con il link di riproduzione in una proprietà chiamata mouseplayer_session_url. Lo apra per vedere la registrazione di quella precisa sessione.

Da lì vale la logica della piattaforma: usi l’evento come attivatore di automazione, condizione di segmento o lasci che il team apra la registrazione dal contatto.

La chiave non lascia mai il nostro server

È conservata cifrata con AES-256-GCM, mai più mostrata dopo il salvataggio e deliberatamente esclusa dalla coda interna: il processo di lavoro la recupera direttamente dal database.

HTTP 200 non significa consegnato

ActiveCampaign risponde con stato 200 e {"success":0} quando rifiuta un evento. Leggiamo il corpo della risposta, non solo lo stato, così il rifiuto appare come errore nel registro delle consegne, non come successo silenzioso.