Passer au contenu principal
Radar s’exécute sur votre site grâce à une seule balise <script>. La balise charge le tracker depuis taap.it et lui indique à quel projet les visites appartiennent. Cette page explique la balise attribut par attribut, où la placer, et quelles données demandent une ligne de code de votre part.

La balise

Ce que fait chaque attribut

Gardez la balise telle que votre tableau de bord vous la donne. Rien ne se place entre la balise ouvrante <script ...> et la balise fermante </script> : un commentaire ou un </body> collé par erreur à l’intérieur la casse.

Trouver votre clé de projet

La clé est la valeur pk_... à l’intérieur du script. Vous n’avez pas besoin de construire la balise à la main : Radar vous donne le script complet, avec votre clé déjà dedans.
  • À la création du projet : la deuxième étape de la configuration affiche le script avec un bouton de copie.
  • Plus tard : ouvrez le projet dans Radar, allez dans ses paramètres et ouvrez la section du script.
Un projet correspond à un site web, et chaque projet a sa propre clé. Si vous gérez plusieurs sites, chacun a un script différent.
Une balise avec la mauvaise clé laisse votre tableau de bord vide. Si rien n’apparaît, comparez la clé présente sur votre site avec celle du projet que vous regardez.
La clé de projet n’est pas un secret. Elle se trouve dans le code de vos pages, où tout le monde peut la lire. Ne la confondez pas avec une clé API Radar, que vous créez dans l’onglet API des paramètres du projet : une clé API lit vos données et ne doit jamais apparaître dans le code d’une page publique. Dans cette documentation, pk_xxxx est une valeur d’exemple. Remplacez-la par votre propre clé.

Où placer la balise

  • Dans le <head>. Placez-la juste avant la balise fermante </head>.
  • Sur chaque page. Une page sans la balise est une page que Radar ne peut pas voir. Dans un framework, placez-la dans le fichier qui englobe toutes les pages, comme le layout racine ou le template HTML. Consultez la page d’installation de votre stack, à partir de démarrer.
  • Une seule fois. Si vous déplacez la balise, par exemple dans un gestionnaire de balises, supprimez l’ancienne copie pour que le script ne se charge pas deux fois.
  • Sur un domaine que le projet connaît. Un projet accepte les données venant du domaine que vous avez saisi à sa création. Pour envoyer des données depuis une autre adresse, ajoutez-la dans la section des domaines supplémentaires des paramètres du projet. Consultez suivre plusieurs sites web ou domaines.
  • Sur votre site publié. Radar ne reçoit rien tant que la modification n’est pas en ligne. Testez sur le site déployé, et non sur une copie qui tourne sur votre propre ordinateur.
Vous pouvez aussi charger le même script depuis un gestionnaire de balises. Consultez installer avec Google Tag Manager.

Ce que Radar collecte tout seul

Une fois la balise présente sur chaque page, ces données arrivent sans aucun autre code :
  • Pages vues, visites et visiteurs. Une visite est un passage sur votre site, aussi appelé session. Un visiteur est une personne, qui peut faire plusieurs visites.
  • D’où viennent les visiteurs : source, canal et référent (le site qui les a envoyés).
  • Où ils se trouvent et ce qu’ils utilisent : pays, appareil, navigateur et système d’exploitation.
  • Les pages qu’ils consultent, y compris la page où une visite commence et celle où elle se termine.
  • Les clics sur les liens sortants et les envois de formulaires, grâce aux deux attributs data-track-... de la balise.

Ce qui demande un événement personnalisé

Radar ne peut pas deviner ce qui se passe dans votre propre code, comme une inscription réussie ou un paiement sur une page que vous avez développée. Dans ces cas, votre code prévient Radar avec un événement personnalisé : une action nommée que vous envoyez vous-même. Le script rend un objet visitors disponible sur la page. Appelez visitors.track avec le nom de l’événement et, si vous le souhaitez, un objet de propriétés :
Pour une vente sur une page de paiement sur mesure, l’événement ressemble à ceci :
Trois choses à savoir :
  • Il n’existe pas de méthode identify séparée. Un visiteur devient identifié lorsque ses informations sont transmises dans un événement personnalisé, ou automatiquement lorsque Stripe est connecté. Consultez identifier les visiteurs, et lisez confidentialité et consentement avant d’identifier des personnes.
  • Stripe Checkout ne demande aucun événement. Si vous connectez Stripe et que vos clients paient sur la page Stripe Checkout, la connexion suffit. L’événement payment sert aux pages de paiement que vous avez développées vous-même. Consultez suivre les revenus.
  • Radar n’a pas de webhooks. Pour récupérer vos événements personnalisés hors de Radar, lisez-les via l’API à l’adresse /api/v1/radar/custom-events. Consultez l’endpoint des événements personnalisés. L’API Radar est disponible à partir du plan Pro.
Les événements personnalisés sont disponibles à partir du plan Starter. Comparez les plans sur la page des tarifs. Le guide pour les développeurs se trouve dans événements personnalisés. Pour savoir comment lire le rapport des événements dans votre tableau de bord, consultez l’article du Centre d’aide sur les événements personnalisés.