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

> Ajoutez le script Radar au layout de base d'un site Astro, ou via un petit composant qui lit la clé de projet dans une variable d'environnement.

Dans un projet Astro, le script Radar se place dans le layout qui englobe toutes vos pages, pour être chargé partout. Remplacez `pk_xxxx` par votre clé de projet. La directive `is:inline` indique à Astro de laisser la balise exactement telle qu'elle est écrite.

```astro src/layouts/BaseLayout.astro theme={null}
---
export interface Props {
  title: string;
}
const { title } = Astro.props;
---

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>{title}</title>

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

Si votre site a plusieurs layouts, ajoutez la balise à chacun, ou utilisez le composant ci-dessous.

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, ou le réutiliser dans plusieurs layouts. Le composant ajoute le script depuis le navigateur. Il ne fait rien quand la clé est absente ou quand le script est déjà sur la page.

```astro src/components/RadarTracker.astro theme={null}
---
export interface Props {
  projectKey?: string;
}

const { projectKey = "" } = Astro.props;
---

<script is:inline define:vars={{ projectKey }}>
  (function () {
    if (!projectKey) return;
    if (document.querySelector("script[data-project]")) return;

    var s = document.createElement("script");
    s.src = "https://taap.it/scripts/tracker.js";
    s.async = true;
    s.setAttribute("data-project", projectKey);
    s.setAttribute("data-track-outbound", "true");
    s.setAttribute("data-track-forms", "true");
    document.head.appendChild(s);
  })();
</script>
```

Utilisez-le ensuite dans le `<head>` de votre layout :

```astro src/layouts/BaseLayout.astro theme={null}
---
import RadarTracker from "../components/RadarTracker.astro";

export interface Props {
  title: string;
}
const { title } = Astro.props;
---

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>{title}</title>

    <RadarTracker projectKey={import.meta.env.PUBLIC_RADAR_PROJECT_KEY} />
  </head>
  <body>
    <slot />
  </body>
</html>
```

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

Avec le composant de suivi, 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}
PUBLIC_RADAR_PROJECT_KEY=
```

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

Astro n'expose au code qui s'exécute dans le navigateur que les variables dont le nom commence par `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.