Ciclo de vida (servidor)
Envíe el enlace de reproducción a ActiveCampaign, Mailchimp, Iterable o Klaviyo desde nuestro servidor en cuanto una sesión reciba su propio ID de cliente.
1. Por qué existe junto al puente del navegador
MousePlayer ya tiene un puente de ciclo de vida que escribe en el SDK de su página: Klaviyo, Braze, Customer.io y otros seis. Este hace lo mismo desde nuestro servidor, porque en dos de las mayores plataformas la vía del navegador no está disponible:
- ActiveCampaign no tiene ninguna API de eventos para el navegador. Su
vgo()permite definir una cuenta, un correo e iniciar el seguimiento, pero no enviar eventos. Los eventos pasan por la Event Tracking API con una clave independiente, solo desde el servidor. - Mailchimp tiene una, pero con un vocabulario cerrado. Su píxel de seguimiento del sitio acepta
PAGE_VIEWED,PRODUCT_VIEWED,PURCHASEDy unos pocos nombres predefinidos más. No admite eventos personalizados, y forzar nuestros datos dentro de unPAGE_VIEWEDfalsearía su propio modelo de datos.
Para Iterable y Klaviyo, la vía del servidor es simplemente más fiable: sin bloqueadores de anuncios, sin depender de si se cargó el SDK y sin pestañas cerradas antes de tiempo.
2. Qué necesita
Tres campos, que se rellenan según la plataforma.
| Plataforma | Campo de cuenta | Clave |
|---|---|---|
| ActiveCampaign | actid | Sitio web → Seguimiento del sitio, junto a la clave de eventos |
| Mailchimp | El ID de audiencia | Una clave API: conserve su sufijo de tipo -us14 , que permite identificar el centro de datos |
| Iterable | no se necesita; déjelo vacío | Una clave con el permiso «Permitir llamadas de seguimiento de eventos» |
| Klaviyo | no se necesita; déjelo vacío | Una clave privada de API |
El tercer campo es el nombre con el que aparecerá el evento. Manténgalo corto: 32 caracteres como máximo. Es el límite de la API, no el nuestro; lo acortamos al guardar y no al enviar, para que el formulario muestre lo mismo que llega.
Mailchimp: conserve el sufijo de su clave API. La parte tras el último guion (-us14) identifica el centro de datos de su cuenta y se usa para construir la dirección. Una clave sin sufijo se rechaza con un mensaje claro, en lugar de fallar en un lugar que no puede ver.
3. Cuándo se activa y cuándo no
En el momento de identificar una sesión: cuando su sitio llama a MousePlayer.setUserId(), cuando nuestro puente de análisis recupera un ID distinto o cuando su servidor llama al endpoint de identificación. Antes no sabemos a quién pertenece la grabación.
Solo con un correo electrónico
Las cuatro plataformas identifican a los contactos por correo. Si su ID de cliente es un número de contrato, no se envía nada: poner en cola una tarea destinada a fallar solo llenaría su registro de ruido.
El contacto ya debe existir. Ninguna de estas plataformas crea un contacto a partir de un evento; ActiveCampaign descarta el evento por completo si no reconoce la dirección. Este puente enriquece contactos existentes, no construye su lista.
Cada evento lleva un ID
Así, la misma sesión no puede contarse dos veces, aunque se reintente una tarea.
4. Qué llega al otro lado
Un evento con el enlace de reproducción en una propiedad llamada mouseplayer_session_url. Ábralo para acceder a la grabación de esa sesión concreta.
A partir de ahí se aplica la lógica de su plataforma: use el evento como activador de automatización, condición de segmento o permita simplemente que su equipo abra la grabación desde el contacto.
La clave nunca sale de nuestro servidor
Se almacena cifrada con AES-256-GCM, no vuelve a mostrarse tras guardar y se excluye deliberadamente de la cola interna que transporta la tarea: el proceso de trabajo la obtiene directamente de la base de datos.
HTTP 200 no significa entregado
ActiveCampaign responde con estado 200 y {"success":0} cuando rechaza un evento. Leemos el cuerpo, no solo el estado: un rechazo aparece como fallo en el registro de entregas, en lugar de como éxito silencioso.
5. Braze, Customer.io y Brevo
Tres plataformas más disponibles desde el servidor. Dos necesitan algo que las otras no: una ubicación.
| Debe proporcionar | Identificación mediante | |
|---|---|---|
| Braze | Endpoint REST y clave API | correo electrónico |
| Customer.io | ID del sitio, clave API y su región | su propio ID de cliente |
| Brevo | solo la clave de seguimiento | correo electrónico |
Dos tienen una ubicación específica
Braze usa endpoints REST vinculados a cada instancia; Customer.io tiene dos regiones independientes con hosts distintos. Ninguno se puede deducir de la clave, y elegir mal devuelve 401, lo que le lleva a revisar la clave. Ambos campos existen por ese único motivo.
Customer.io no necesita correo electrónico
Conoce a las personas por el mismo ID que usted les asigna, así que exigir un correo sería un obstáculo inventado. Las otras seis sí comparan por correo y, para ellas, una sesión identificada por número de contrato no produce nada, correctamente.
Sin perfiles nuevos
La llamada a Braze incluye _update_existing_only. Es la misma decisión que en el puente CRM: una sesión del navegador no determina de forma fiable quiénes son sus clientes, y una plataforma de ciclo de vida que crea un perfil por visitante anónimo es peor que no tener integración.
Brevo responde 204; Braze responde 201 con un matiz
Brevo no devuelve cuerpo: ahí, un 2xx sí basta. Braze devuelve "message": "success" y puede incluir además un array errors : los problemas fatales aparecen en el mensaje; las pérdidas de campos toleradas, solo en errors. Leer uno sin el otro lleva a conclusiones erróneas en uno u otro sentido.
Todas las marcas mencionadas pertenecen a sus respectivos propietarios. MousePlayer no mantiene ninguna relación comercial con estos proveedores.