> ## Documentation Index
> Fetch the complete documentation index at: https://docs.taap.it/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer Radar dans une application React

> Ajoutez le script Radar à une application React via son fichier HTML, ou chargez-le avec React Helmet ou un hook quand la clé de projet vient d'une variable d'environnement.

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.

```html index.html theme={null}
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <title>React App</title>

    <script
      async
      src="https://taap.it/scripts/tracker.js"
      data-project="pk_xxxx"
      data-track-outbound="true"
      data-track-forms="true"
    ></script>
  </head>
  <body>
    <div id="root"></div>
  </body>
</html>
```

Pour savoir à quoi sert chaque attribut, consultez [le fonctionnement du script](https://docs.taap.it/fr/radar/how-the-script-works.md).

## 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.

```tsx src/App.tsx theme={null}
import { Helmet } from "react-helmet";

const projectKey = process.env.REACT_APP_RADAR_PROJECT_KEY;

export default function App() {
  return (
    <>
      {projectKey && (
        <Helmet>
          <script
            async
            src="https://taap.it/scripts/tracker.js"
            data-project={projectKey}
            data-track-outbound="true"
            data-track-forms="true"
          />
        </Helmet>
      )}

      {/* rest of your app */}
    </>
  );
}
```

## 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.

```ts src/hooks/useRadar.ts theme={null}
import { useEffect } from "react";

export function useRadar(projectKey?: string) {
  useEffect(() => {
    if (!projectKey) return;
    if (document.querySelector("script[data-project]")) return;

    const script = document.createElement("script");
    script.src = "https://taap.it/scripts/tracker.js";
    script.async = true;
    script.setAttribute("data-project", projectKey);
    script.setAttribute("data-track-outbound", "true");
    script.setAttribute("data-track-forms", "true");

    document.head.appendChild(script);
  }, [projectKey]);
}
```

Appelez le hook une seule fois, à la racine de votre application :

```tsx src/App.tsx theme={null}
import { useRadar } from "./hooks/useRadar";

export default function App() {
  useRadar(process.env.REACT_APP_RADAR_PROJECT_KEY);

  return <>{/* rest of your app */}</>;
}
```

## 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.

```bash .env theme={null}
REACT_APP_RADAR_PROJECT_KEY=
```

```bash .env.production theme={null}
REACT_APP_RADAR_PROJECT_KEY=pk_xxxx
```

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](https://docs.taap.it/fr/help/radar/check-your-installation.md). 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.