Passer au contenu principal
Un événement personnalisé est une action que vous choisissez d’enregistrer dans Radar : une inscription, un clic sur un bouton, un formulaire envoyé. Le script Radar enregistre les pages vues tout seul. Pour tout le reste, le code de votre site appelle visitors.track au moment où l’action a lieu. Ce guide présente l’appel, ses arguments, le bon moment pour l’envoyer et la façon de vérifier qu’il est bien arrivé. Vous n’êtes pas développeur ? L’article du Centre d’aide sur les événements personnalisés explique la même fonctionnalité et la lecture de son rapport, sans code.

Avant de commencer

  • Installez le script Radar. visitors.track est fourni avec le script : le script doit donc être présent sur chaque page qui envoie un événement. Consultez installer le script, puis vérifier votre installation.
  • Sachez ce que le script suit déjà. Les pages vues arrivent toutes seules, et les attributs data-track-outbound et data-track-forms de la balise activent le suivi des clics sur les liens sortants et des envois de formulaire. Consultez le fonctionnement du script.
  • Vérifiez votre plan. Les événements personnalisés sont disponibles à partir du plan Starter. Comparez les plans sur la page des tarifs.
L’objet JavaScript s’appelle visitors. C’est le bon nom : ne le remplacez pas par radar dans votre code.

L’appel

Un troisième argument existe pour un seul cas : le montant d’une vente. Consultez suivre les revenus.

Choisir les noms de vos événements

  • Gardez des noms courts et stables. Radar regroupe les événements par nom : signup aujourd’hui et sign_up le mois prochain apparaissent donc comme deux événements différents.
  • Nommez l’action, pas la page. add_to_cart, book_call et newsletter_subscribe disent ce que le visiteur a fait.
  • Réservez payment aux vraies ventes. Radar traite de façon particulière un événement nommé exactement payment : c’est l’événement qui porte une vente et le nom de l’acheteur. Consultez suivre les revenus.

Ajouter des propriétés

Les propriétés sont facultatives. Vous choisissez les clés et les valeurs :
Quelques clés ont un sens pour Radar : email, name, first_name et last_name décrivent le visiteur, pas l’événement. Un e-mail envoyé sur n’importe quel événement identifie le visiteur. Consultez identifier les visiteurs.
Ne mettez un e-mail dans les propriétés que si vous voulez identifier le visiteur. Identifier des personnes a des conséquences sur le consentement. Consultez confidentialité, cookies et RGPD.

Envoyer l’événement une fois l’action réussie

Appelez visitors.track une fois que l’action a vraiment eu lieu, pas au moment où le visiteur essaie. Le formulaire est le piège classique. Si vous envoyez l’événement au clic sur le bouton d’envoi, vous comptez aussi toutes les tentatives qui échouent : un champ manquant, un e-mail erroné, une erreur du serveur. Votre rapport affiche alors plus d’inscriptions que vous n’en avez réellement obtenu. Attendez la réussite, puis envoyez l’événement.

Exemples

Inscription

N’envoyez l’événement que lorsque le compte existe. Dans cet exemple, createAccount représente votre propre code d’inscription.

Clic sur un bouton

Un bouton qui ouvre quelque chose ou lance un téléchargement n’a ni réussite ni échec à attendre. Envoyez l’événement au clic.

Formulaire

Envoyez le formulaire vous-même, vérifiez la réponse, puis envoyez l’événement. Dans cet exemple, /api/contact représente l’adresse à laquelle votre propre formulaire est envoyé.

Protéger votre code quand le script est absent

Le script Radar se charge avec l’attribut async : le navigateur ne l’attend donc pas. Il peut aussi être retenu par un outil de consentement ou bloqué par une extension de navigateur. Dans ces cas, l’objet visitors n’existe pas, et un appel direct arrête votre code avec une erreur. Si l’événement se trouve dans du code qui doit continuer à s’exécuter, comme une inscription ou un paiement, vérifiez d’abord que l’objet existe :

Vérifier que l’événement arrive

1

Publier votre modification

Testez sur votre site publié, pas sur une copie qui tourne sur votre propre ordinateur.
2

Déclencher l'action vous-même

Faites ce que ferait un visiteur : remplissez le formulaire, cliquez sur le bouton, terminez l’inscription.
3

Regarder le bloc Événements personnalisés

Ouvrez votre projet dans Radar. Sur la vue d’ensemble, le bloc Événements personnalisés affiche une ligne par nom d’événement, avec deux chiffres : Personnes, le nombre de visiteurs différents qui l’ont déclenché, et Événements, le nombre de fois où il a été déclenché.
Vous pouvez aussi lire la même liste depuis vos propres outils avec l’API Radar. Une clé API est un code secret qui permet à un programme de lire vos données. Créez-en une dans les paramètres de votre projet, sous API, et conservez-la sur votre serveur, jamais dans le code d’une page web.
Chaque entrée de la réponse contient event_name, people et events. Consultez l’endpoint des événements personnalisés. L’API Radar est disponible à partir du plan Pro.

L’événement n’apparaît pas

  • Pas de pages vues non plus. Le problème vient de l’installation, pas de votre événement. Une clé de projet erronée (la valeur pk_ dans le script) laisse le tableau de bord vide. Suivez j’ai installé le script mais je ne vois aucune donnée.
  • Les pages vues arrivent, pas l’événement. Vérifiez que votre code atteint bien la ligne visitors.track : un return prématuré, une erreur juste avant ou un objet visitors absent la font sauter. La console du navigateur affiche l’erreur.
  • Toujours rien. Contactez le support depuis le chat de votre tableau de bord ou à l’adresse hello@taap.it.

Utiliser vos événements dans un tunnel

Un tunnel de conversion est un parcours que vous définissez étape par étape, par exemple page d’arrivée, puis formulaire envoyé, puis appel réservé. Radar montre combien de visiteurs passent de chaque étape à la suivante. Vous créez les tunnels dans le tableau de bord Radar, sans code supplémentaire : chaque étape est soit une page, soit l’un de vos événements personnalisés. Les tunnels sont disponibles à partir du plan Starter, comme les événements personnalisés. Votre rôle de développeur est d’envoyer un événement pour chaque action qui n’a pas de page à elle :
Une fois que les deux événements arrivent, ils peuvent être choisis comme étapes d’un tunnel. Consultez créer un tunnel de conversion.

Bon à savoir

  • Chaque événement compte. Chaque événement personnalisé est décompté des événements que votre plan inclut chaque mois. Consultez plans et événements.
  • Pas de webhooks. Radar ne prévient pas vos systèmes quand un événement se produit. Pour utiliser les événements ailleurs, lisez-les avec l’API Radar.
  • Supprimer un projet supprime ses événements. Supprimer un projet Radar supprime toutes ses données, événements personnalisés compris.

Étapes suivantes

Identifier les visiteurs

Associez un e-mail ou un nom à un visiteur avec le même appel.

Suivre les revenus

Envoyez une vente à Radar depuis Stripe ou depuis votre propre page de paiement.