Au-delà de l’auto-capture (pageviews, clics), utilisez track() pour capturer les signaux métier propres à votre produit.

Émettre un événement

Les propriétés atterrissent dans 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, ajoutez data-track sur l’élément : l’auto-capture du core l’utilisera comme identifiant.
Signaux hors scope de l’auto-capture V1 (scroll depth, soumission de formulaire, erreur JS) : émettez-les manuellement avec track().

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.