Cycle de vie (côté serveur)

1. Pourquoi cette passerelle existe à côté de celle du navigateur

MousePlayer dispose déjà d’une passerelle de cycle de vie qui écrit dans le SDK exécuté sur votre page : Klaviyo, Braze, Customer.io et six autres. Celle-ci accomplit la même tâche depuis notre serveur. Elle existe parce que, pour deux des plus grandes plateformes, la voie du navigateur est tout simplement indisponible :

• ActiveCampaign n’a aucune API d’événements pour le navigateur. Son vgo() permet de définir un compte et une adresse e-mail et de démarrer le suivi, mais pas d’envoyer un événement. Les événements passent par l’Event Tracking API avec une clé d’événement distincte, uniquement côté serveur.
• Mailchimp en a une, mais avec un vocabulaire fermé. Son pixel de suivi de site accepte PAGE_VIEWED, PRODUCT_VIEWED, PURCHASED et quelques autres noms prédéfinis. Aucun emplacement n’est prévu pour un événement personnalisé ; forcer nos données dans un PAGE_VIEWED fausserait votre propre modèle de données.

2. Les éléments nécessaires

Trois champs, à remplir selon la plateforme.

Le troisième champ est le nom sous lequel l’événement apparaîtra. Choisissez un nom court : 32 caractères au maximum. C’est la limite de l’API, pas la nôtre. Nous le raccourcissons lors de l’enregistrement plutôt qu’à l’envoi, pour que le formulaire affiche bien ce qui arrivera.

3. Quand l’envoi se déclenche, et quand il ne se déclenche pas

Au moment où une session est identifiée : lorsque votre site appelle MousePlayer.setUserId(), lorsque notre passerelle analytique récupère un identifiant distinct ou lorsque votre serveur appelle le point de terminaison d’identification. Avant cela, nous ne savons pas à qui appartient l’enregistrement.

Uniquement avec une adresse e-mail

Les quatre plateformes identifient un contact par son adresse e-mail. Si votre identifiant client est un numéro de contrat, rien n’est envoyé : mettre en file une tâche vouée à échouer ne ferait qu’encombrer votre journal.

Chaque événement porte un identifiant

Ainsi, la même session ne peut pas être comptée deux fois, même si une tâche fait l’objet d’une nouvelle tentative.

4. Ce qui arrive de l’autre côté

Un événement qui contient le lien de relecture dans une propriété nommée mouseplayer_session_url. Ouvrez-le pour accéder à l’enregistrement de cette session précise.

La suite relève de la logique de votre plateforme : utilisez l’événement comme déclencheur d’automatisation, comme condition de segment ou laissez simplement votre équipe ouvrir l’enregistrement depuis le contact.

La clé ne quitte jamais notre serveur

Elle est stockée sous forme chiffrée avec AES-256-GCM, n’est plus affichée après l’enregistrement et n’est volontairement pas placée dans la file interne qui transporte la tâche : le processus de traitement la récupère lui-même dans la base de données.

HTTP 200 ne signifie pas que la livraison a réussi

ActiveCampaign répond avec un statut 200 et {"success":0} lorsqu’il refuse un événement. Nous lisons le corps de la réponse, pas seulement le statut : un refus apparaît donc comme un échec dans le journal de livraison, plutôt que comme une réussite silencieuse.