<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 valeurpk_... à 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.
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.
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 objetvisitors 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 :
- 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
paymentsert 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.