Passer au contenu principal
Dans une application React monopage, le moyen le plus simple d’installer Radar est de coller le script dans le fichier HTML qui héberge votre application. Tous les écrans de l’application sont servis depuis ce seul fichier : le script se charge donc partout. Remplacez pk_xxxx par votre clé de projet. Ce fichier est index.html à la racine d’un projet Vite, et public/index.html dans un projet Create React App.
index.html
Pour savoir à quoi sert chaque attribut, consultez le fonctionnement du script.

Variante : React Helmet

Si votre application gère déjà le head du document avec React Helmet, ajoutez-y le script. Grâce à la condition, le script n’est pas ajouté quand aucune clé n’est définie.
src/App.tsx

Variante : le charger depuis un hook

Un hook peut ajouter le script à la page au démarrage de votre application. Il ne fait rien quand la clé est absente ou quand le script est déjà sur la page.
src/hooks/useRadar.ts
Appelez le hook une seule fois, à la racine de votre application :
src/App.tsx

Ne pas utiliser la clé en développement

Avec React Helmet ou le hook, stockez la clé dans un fichier d’environnement et laissez-la vide pour le développement. Sans clé, le script n’est pas ajouté à la page : Radar ne se charge donc pas pendant que vous développez.
Create React App n’expose que les variables dont le nom commence par REACT_APP_. Avec Vite, nommez la variable VITE_RADAR_PROJECT_KEY et lisez-la avec import.meta.env.VITE_RADAR_PROJECT_KEY.

Vérifier que tout fonctionne

Déployez votre site, ouvrez la version publiée, chargez deux pages et cliquez sur un lien. Le premier événement doit arriver dans votre tableau de bord Radar en quelques secondes. Si rien n’arrive, suivez les étapes de vérification de votre installation. Quand la balise est ajoutée par JavaScript au lieu d’être écrite dans le HTML, elle n’apparaît pas dans le code source brut de la page : cherchez plutôt tracker.js dans le panneau Éléments des outils de développement de votre navigateur.