Événements personnalisés

Au-delà des pages vues, wheremyflow vous laisse mesurer ce qui compte vraiment : inscriptions, achats, clics sur un bouton clé, lecture d'une vidéo. Ces _événements personnalisés_ se configurent et se lisent au même endroit : l'onglet Comportement du dashboard, section _Configurer les événements_.

#Le principe

Un événement, c'est trois choses :

• Un nom (par exemple signup, purchase, cta_click).
• Une page ou un élément qui le déclenche.
• Optionnellement, des propriétés (max 10 clés) pour qualifier l'événement (ex. plan: pro, value: 49).

#Déclencher un événement

#Méthode 1 — Programmatique (le plus précis)

Depuis votre code JavaScript :

window.wmf('event', 'signup', { plan: 'pro' });

window.wmf est exposé par le snippet w.js. L'événement est posté à /api/event immédiatement, en fire-and-forget.

#Méthode 2 — Attribut HTML (sans toucher au code)

Sur n'importe quel élément cliquable :

<button data-wmf-event="cta_click" data-wmf-cta="hero">Démarrer gratuitement</button>

Le snippet écoute les clics et envoie l'événement automatiquement, avec les propriétés data-wmf-* (préfixe retiré).

#Méthode 3 — Téléchargements et liens sortants

Activés par défaut. Tout clic sur un lien <a href> :

• pointant vers un fichier (.pdf, .zip, .csv, etc.) → événement file_download.
• pointant vers un domaine externe → événement outbound_link.

Voir Téléchargements et Liens sortants.

#Règles strictes côté serveur

Pour éviter le bruit et garder la base saine, le serveur applique :

• 10 propriétés max par événement (le 11ᵉ est rejeté silencieusement).
• Clés : 50 caractères max, [a-z0-9_]+.
• Valeurs : string, number ou boolean ; 200 caractères max pour les strings.
• Pas de PII : ne mettez jamais d'e-mail, de nom, de numéro de téléphone, de jeton dans un événement. C'est interdit par les référentiels européens sur la mesure d'audience et nous tronquons par sécurité.

#Lire les résultats

Les événements remontent en temps réel dans Comportement → Mesures. Ils sont pliés en accordéon : un clic sur un nom d'événement ouvre la liste des occurrences avec leurs propriétés.

Pour les événements à valeur (revenue, panier moyen), passez la propriété value (number) — elle est sommée et moyennée automatiquement.

#Bonnes pratiques

• Standardisez les noms dès le départ (snake_case, verbes au passé : signup_completed, checkout_failed).
• Limitez le nombre de noms distincts (idéal : moins de 30) — au-delà, c'est probablement du logging applicatif, pas de l'analytics.
• Utilisez les propriétés pour qualifier, pas pour multiplier les noms (purchase + plan: pro plutôt que purchase_pro).

#Pour aller plus loin

• Propriétés d'événements
• Téléchargements
• Liens sortants