track() pour capturer les
signaux métier propres à votre produit.
Émettre un événement
properties.custom. Elles doivent être
JSON-sérialisables.
Nommage
snake_case, verbe au passé
signup_completed, checkout_started, plan_upgraded. Cohérent et lisible
dans le dashboard.Stable et fini
Un ensemble borné de noms d’événements. Évitez de générer des noms dynamiques
(ex.
click_button_{id}).Propriétés
- Privilégiez des valeurs typées et faible cardinalité (
plan: "pro", pas un texte libre long). - Nombres pour les montants/quantités (
amount: 5000). - Pas de PII inutile (voir Sanitize).
Auto-capture par attribut
Pour tracker un clic sans écrire de handler, ajoutezdata-track sur l’élément :
l’auto-capture du core l’utilisera comme identifiant.
Ce que track() n’est pas
- Ce n’est pas un calcul de funnel : le SDK capture, il n’agrège pas.
- Ce n’est pas bloquant : l’appel se résout dès la mise en file, l’envoi se fait en batch en arrière-plan.