Propriétés d'événements

Les propriétés enrichissent un événement avec des données structurées. Elles permettent de filtrer, regrouper et analyser sans multiplier les noms d'événements.

#Format

window.wmf('event', 'purchase', {
  plan: 'pro',
  value: 49,
  currency: 'EUR',
  trial_days: 30,
});

#Règles strictes côté serveur

• Maximum 10 clés par événement. La 11ᵉ et au-delà sont droppées silencieusement.
• Clé : 50 caractères max, [a-z0-9_]+ (lowercase + chiffres + underscore).
• Valeur : string, number ou boolean. Les objets, tableaux et null sont rejetés.
• String : 200 caractères max. Au-delà, troncature.
• Pas de PII : pas d'e-mail, pas de nom, pas de numéro de téléphone, pas de jeton. La règle est imposée par notre engagement RGPD — voir Conformité.

#Bonnes pratiques

• Préférez value (number) pour les montants : agrégé automatiquement (somme + moyenne).
• currency (string ISO 4217 sur 3 caractères) : si présente, affichée à côté de value.
• Utilisez des valeurs énumérées courtes (plan: 'pro' plutôt que plan: 'Plan Pro avec accès illimité').
• Ne dupliquez pas l'information : si vous passez page_url, sachez qu'on la stocke déjà au niveau de l'événement.

#Pourquoi ces limites ?

Les events bruts vivent 90 jours dans une table jsonb avec un index GIN. Les limites garantissent :

1. Une taille de payload bornée (16 Ko côté serveur).
2. Une cardinalité raisonnable (sinon les agrégats deviennent ingérables).
3. Une conformité RGPD (impossible d'utiliser le payload pour fingerprinter).