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.trackest 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-outboundetdata-track-formsde 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 :
signupaujourd’hui etsign_uple mois prochain apparaissent donc comme deux événements différents. - Nommez l’action, pas la page.
add_to_cart,book_calletnewsletter_subscribedisent ce que le visiteur a fait. - Réservez
paymentaux vraies ventes. Radar traite de façon particulière un événement nommé exactementpayment: 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 :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.
Envoyer l’événement une fois l’action réussie
Appelezvisitors.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’attributasync : 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é.
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: unreturnprématuré, une erreur juste avant ou un objetvisitorsabsent 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 :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.