Events custom

Un event custom marque un moment clé du parcours : une commande, un paiement refusé, l’ouverture d’une fonctionnalité. Il apparaît sur la timeline du replay, dans la liste des events sous le lecteur (un clic y amène la lecture), et permet de filtrer les sessions (filtre « Event déclenché »).

capture(name, properties?)

belvdr.capture('paiement', { montant: 25, moyen: 'carte' })
belvdr.capture('newsletter')

• Nom : 1 à 200 caractères. Les noms qui commencent par $ sont réservés ($identify) et ignorés.
• Propriétés (facultatives) : un objet sérialisable en JSON, 10 000 caractères au plus une fois sérialisé. Elles sont envoyées telles que le JSON les garde : une date devient une chaîne, une valeur undefined disparaît.
• Un event invalide est ignoré, avec un avertissement dans la console.

L’event part avec l’envoi suivant de la page, avec son instant et l’URL de la page.

Quand un event est ignoré

capture() n’enregistre rien quand la page n’est pas enregistrée :

• avant startSession(), donc avant le consentement ;
• après stopSession() ;
• quand la session a expiré pour inactivité : un event n’est pas une interaction, il ne prolonge ni ne recrée la session (Cycle de vie).

Envoi

Un envoi porte au plus 100 events : au-delà, le SDK envoie sans attendre les 5 secondes habituelles (Envoi des enregistrements). Un event renvoyé après une erreur réseau n’est enregistré qu’une fois.