Une fois que le tracker Zenovay est chargé sur votre page, il expose une fonction globale window.zenovay(). Elle utilise une API de style commande : le premier argument est la commande ('track', 'identify', 'goal', 'revenue', …), suivi par les arguments spécifiques à la commande. Utilisez la commande track pour enregistrer tout ce qui n'est pas un pageview — clics, soumissions de formulaires, événements métier.
L'appel le plus simple
window.zenovay('track', 'cta_clicked');
Cela envoie un événement unique sans propriétés. Il apparaîtra dans l'onglet Analytics de votre dashboard dans ~30 secondes.
Avec des propriétés
window.zenovay('track', 'cta_clicked', {
cta_label: 'Démarrer essai gratuit',
page_section: 'hero',
variant: 'B'
});
Les valeurs de propriété peuvent être des chaînes de caractères, des nombres ou des booléens. Les objets imbriqués et les tableaux ne sont pas supportés — aplatissez-les au point d'appel.
Événements de revenue
Pour les achats, utilisez la commande dédiée revenue. Elle prend le montant et la devise directement :
window.zenovay('revenue', 29.00, 'USD');
Cela enregistre une conversion de revenue qui remplit votre onglet Revenue. Si vous omettez la devise, elle est définie par défaut à USD.
Si vous préférez ajouter un contexte supplémentaire, vous pouvez aussi déclencher un événement ordinaire et inclure le montant et la devise en tant que propriétés :
window.zenovay('track', 'purchase', {
revenue: 29.00,
currency: 'USD',
product_id: 'pro-annual'
});
Identifier un utilisateur
Quand un visiteur se connecte, liez la session à son compte avec la commande identify :
window.zenovay('identify', 'user_42', {
email: '[email protected]',
plan: 'pro'
});
Vous pouvez aussi passer un seul objet si vous préférez :
window.zenovay('identify', {
user_id: 'user_42',
email: '[email protected]',
plan: 'pro'
});
Après cet appel, le profil du visiteur est stocké et les événements ultérieurs sont associés à cette identité.
Conventions de nommage des propriétés
Utilisez snake_case (page_section, pas pageSection). Le dashboard regroupe les propriétés alphabétiquement — un nommage cohérent facilite les filtres.
Le tracker capture automatiquement le contexte tel que l'URL, le référent, la taille de l'écran, le navigateur, le système d'exploitation et la localisation approximative, donc vous n'avez pas besoin de les envoyer vous-même.
Limites des plans
Les événements personnalisés comptent dans votre quota mensuel d'événements :
| Plan | Événements mensuels |
|---|---|
| Free | 10 000 |
| Pro | 100 000 |
| Scale | 1 000 000 |
| Enterprise | Sur mesure |
Pièges courants
- Appel avant le chargement du tracker — entourez les appels d'une vérification
if (window.zenovay), ou mettez-les en file d'attente avant l'exécution du script. Le tracker relit tout ce que vous envoyez surwindow.zenovay.q:window.zenovay = window.zenovay || function(){(window.zenovay.q = window.zenovay.q || []).push(arguments)}; window.zenovay('track', 'cta_clicked'). - Envoyer des PII en propriété — les emails, noms et numéros de téléphone ne doivent pas être envoyés en tant que propriétés d'événements personnalisés. Utilisez la commande
identifypour les données de compte à la place. - Mode cookieless +
identify()— en mode cookieless, l'appel identify fonctionne toujours pour la page actuelle, mais le lien est réinitialisé au prochain chargement de page (pas de stockage persistant).