> ## 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 sur un site Next.js

> Ajoutez le script Radar à un projet Next.js App Router depuis le layout racine, ou via un petit composant qui lit la clé de projet dans une variable d'environnement.

Dans un projet Next.js qui utilise l'App Router (version 13 et suivantes), le script Radar se place dans le layout racine, pour être chargé sur toutes les pages. Utilisez le composant `Script` de `next/script` et remplacez `pk_xxxx` par votre clé de projet.

```tsx src/app/layout.tsx theme={null}
import Script from "next/script";

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <head>
        <Script
          src="https://taap.it/scripts/tracker.js"
          data-project="pk_xxxx"
          data-track-outbound="true"
          data-track-forms="true"
        />
      </head>
      <body>{children}</body>
    </html>
  );
}
```

> [!NOTE]
>
> Cette page ne couvre que l'App Router. Si votre projet n'a pas de dossier `src`, le fichier est `app/layout.tsx`.

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

## Variante : un composant de suivi

Placez le script dans son propre composant si vous voulez lire la clé de projet dans une variable d'environnement. Le composant n'affiche rien quand la clé est absente.

```tsx src/components/RadarTracker.tsx theme={null}
import Script from "next/script";

export default function RadarTracker({ projectKey }: { projectKey?: string }) {
  if (!projectKey) return null;

  return (
    <Script
      src="https://taap.it/scripts/tracker.js"
      data-project={projectKey}
      data-track-outbound="true"
      data-track-forms="true"
    />
  );
}
```

Utilisez-le ensuite dans le layout racine :

```tsx src/app/layout.tsx theme={null}
import RadarTracker from "@/components/RadarTracker";

export default function RootLayout({
  children,
}: {
  children: React.ReactNode;
}) {
  return (
    <html lang="en">
      <head>
        <RadarTracker projectKey={process.env.NEXT_PUBLIC_RADAR_PROJECT_KEY} />
      </head>
      <body>{children}</body>
    </html>
  );
}
```

## Ne pas utiliser la clé en développement

Avec le composant de suivi, définissez la clé pour la production uniquement. Sans clé, le script n'est pas ajouté à la page : Radar ne se charge donc pas pendant que vous développez.

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

Si votre hébergeur gère les variables d'environnement pour vous, définissez plutôt `NEXT_PUBLIC_RADAR_PROJECT_KEY` chez lui. Ne définissez pas la variable dans `.env.local` : Next.js lit aussi ce fichier pour les builds de production, et il est prioritaire sur `.env.production`.

Next.js n'expose une variable au navigateur que si son nom commence par `NEXT_PUBLIC_`.

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