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

> Ajoutez le script Radar à un site Nuxt depuis nuxt.config.ts, ou chargez-le avec useHead ou un plugin client quand la clé de projet vient de la runtime config.

Dans un projet Nuxt, le moyen le plus simple d'installer Radar est de déclarer le script dans `nuxt.config.ts`. Nuxt l'ajoute alors au `<head>` de chaque page. Remplacez `pk_xxxx` par votre clé de projet.

```ts nuxt.config.ts theme={null}
export default defineNuxtConfig({
  app: {
    head: {
      script: [
        {
          src: "https://taap.it/scripts/tracker.js",
          async: true,
          "data-project": "pk_xxxx",
          "data-track-outbound": "true",
          "data-track-forms": "true",
        },
      ],
    },
  },
});
```

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

## Variante : useHead avec la runtime config

Utilisez cette version si vous voulez lire la clé de projet dans une variable d'environnement et ne pas ajouter le script quand la clé n'est pas définie.

Déclarez d'abord la clé dans la runtime config publique. Nuxt remplace la valeur vide par la variable d'environnement `NUXT_PUBLIC_RADAR_PROJECT_KEY` quand elle est définie.

```ts nuxt.config.ts theme={null}
export default defineNuxtConfig({
  runtimeConfig: {
    public: {
      radarProjectKey: "",
    },
  },
});
```

Appelez ensuite `useHead` dans `app.vue` :

```vue app.vue theme={null}
<script setup lang="ts">
const config = useRuntimeConfig();
const projectKey = config.public.radarProjectKey;

useHead({
  // no script when the key is missing, for example in development
  script: projectKey
    ? [
        {
          src: "https://taap.it/scripts/tracker.js",
          async: true,
          "data-project": projectKey,
          "data-track-outbound": "true",
          "data-track-forms": "true",
          tagPosition: "head",
        },
      ]
    : [],
});
</script>

<template>
  <NuxtPage />
</template>
```

## Variante : un plugin client

Un plugin évite de mettre le script dans `app.vue`. Il utilise la même runtime config que ci-dessus. Le suffixe `.client.ts` indique à Nuxt d'exécuter le plugin uniquement dans le navigateur : aucune vérification `import.meta.client` n'est donc nécessaire.

```ts plugins/radar.client.ts theme={null}
export default defineNuxtPlugin(() => {
  const config = useRuntimeConfig();
  const projectKey = config.public.radarProjectKey;

  if (!projectKey) return;

  useHead({
    script: [
      {
        src: "https://taap.it/scripts/tracker.js",
        async: true,
        "data-project": projectKey,
        "data-track-outbound": "true",
        "data-track-forms": "true",
        tagPosition: "head",
      },
    ],
  });
});
```

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

Avec `useHead` ou le plugin, 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.

Définissez cette variable dans l'environnement où votre site est construit et hébergé, et ne la mettez pas dans votre fichier `.env` local :

```bash theme={null}
NUXT_PUBLIC_RADAR_PROJECT_KEY=pk_xxxx
```

Nuxt ne charge pas de lui-même un fichier `.env.production` : ne comptez donc pas dessus, sauf si votre commande de build pointe vers ce fichier.

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