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

# Fonctionnement du script de suivi Radar

> Ce que fait chaque attribut du script Radar, où trouver votre clé de projet, où placer la balise sur la page, et ce que Radar collecte sans code supplémentaire.

Radar s'exécute sur votre site grâce à une seule balise `<script>`. La balise charge le tracker depuis taap.it et lui indique à quel projet les visites appartiennent. Cette page explique la balise attribut par attribut, où la placer, et quelles données demandent une ligne de code de votre part.

## La balise

```html theme={null}
<script
  async
  src="https://taap.it/scripts/tracker.js"
  data-project="pk_xxxx"
  data-track-outbound="true"
  data-track-forms="true"
></script>
```

## Ce que fait chaque attribut

| Attribut | Ce qu'il fait |
| - | - |
| `async` | Un attribut HTML standard. Le navigateur télécharge le script sans retarder le reste de la page. |
| `src` | L'adresse du tracker. C'est toujours `https://taap.it/scripts/tracker.js`. Une balise qui pointe ailleurs ne charge pas Radar. |
| `data-project` | Votre clé de projet. Elle commence par `pk_` et indique à Radar quel projet, et donc quel tableau de bord, reçoit les données. |
| `data-track-outbound="true"` | Active le suivi des liens sortants : les clics sur les liens qui emmènent le visiteur vers un autre site web. |
| `data-track-forms="true"` | Active le suivi des envois de formulaires sur vos pages. |

Gardez la balise telle que votre tableau de bord vous la donne. Rien ne se place entre la balise ouvrante `<script ...>` et la balise fermante `</script>` : un commentaire ou un `</body>` collé par erreur à l'intérieur la casse.

## Trouver votre clé de projet

La clé est la valeur `pk_...` à l'intérieur du script. Vous n'avez pas besoin de construire la balise à la main : Radar vous donne le script complet, avec votre clé déjà dedans.

* **À la création du projet** : la deuxième étape de la configuration affiche le script avec un bouton de copie.
* **Plus tard** : ouvrez le projet dans Radar, allez dans ses paramètres et ouvrez la section du script.

Un projet correspond à un site web, et chaque projet a sa propre clé. Si vous gérez plusieurs sites, chacun a un script différent.

> [!WARNING]
>
> Une balise avec la mauvaise clé laisse votre tableau de bord vide. Si rien n'apparaît, comparez la clé présente sur votre site avec celle du projet que vous regardez.

La clé de projet n'est pas un secret. Elle se trouve dans le code de vos pages, où tout le monde peut la lire. Ne la confondez pas avec une clé API Radar, que vous créez dans l'onglet API des paramètres du projet : une clé API lit vos données et ne doit jamais apparaître dans le code d'une page publique.

Dans cette documentation, `pk_xxxx` est une valeur d'exemple. Remplacez-la par votre propre clé.

## Où placer la balise

* **Dans le `<head>`.** Placez-la juste avant la balise fermante `</head>`.
* **Sur chaque page.** Une page sans la balise est une page que Radar ne peut pas voir. Dans un framework, placez-la dans le fichier qui englobe toutes les pages, comme le layout racine ou le template HTML. Consultez la page d'installation de votre stack, à partir de [démarrer](https://docs.taap.it/fr/radar/get-started.md#installer-sur-votre-stack).
* **Une seule fois.** Si vous déplacez la balise, par exemple dans un gestionnaire de balises, supprimez l'ancienne copie pour que le script ne se charge pas deux fois.
* **Sur un domaine que le projet connaît.** Un projet accepte les données venant du domaine que vous avez saisi à sa création. Pour envoyer des données depuis une autre adresse, ajoutez-la dans la section des domaines supplémentaires des paramètres du projet. Consultez [suivre plusieurs sites web ou domaines](https://docs.taap.it/fr/help/radar/multiple-websites.md).
* **Sur votre site publié.** Radar ne reçoit rien tant que la modification n'est pas en ligne. Testez sur le site déployé, et non sur une copie qui tourne sur votre propre ordinateur.

Vous pouvez aussi charger le même script depuis un gestionnaire de balises. Consultez [installer avec Google Tag Manager](https://docs.taap.it/fr/help/radar/install-with-google-tag-manager.md).

## Ce que Radar collecte tout seul

Une fois la balise présente sur chaque page, ces données arrivent sans aucun autre code :

* **Pages vues, visites et visiteurs.** Une visite est un passage sur votre site, aussi appelé session. Un visiteur est une personne, qui peut faire plusieurs visites.
* **D'où viennent les visiteurs** : source, canal et référent (le site qui les a envoyés).
* **Où ils se trouvent et ce qu'ils utilisent** : pays, appareil, navigateur et système d'exploitation.
* **Les pages qu'ils consultent**, y compris la page où une visite commence et celle où elle se termine.
* **Les clics sur les liens sortants et les envois de formulaires**, grâce aux deux attributs `data-track-...` de la balise.

## Ce qui demande un événement personnalisé

Radar ne peut pas deviner ce qui se passe dans votre propre code, comme une inscription réussie ou un paiement sur une page que vous avez développée. Dans ces cas, votre code prévient Radar avec un événement personnalisé : une action nommée que vous envoyez vous-même.

Le script rend un objet `visitors` disponible sur la page. Appelez `visitors.track` avec le nom de l'événement et, si vous le souhaitez, un objet de propriétés :

```javascript theme={null}
visitors.track("signup", {
  plan: "pro",
});
```

| Vous voulez | Ce qu'il faut envoyer |
| - | - |
| Mesurer une action dans votre propre code, comme une inscription, un ajout au panier ou une réservation | Un événement personnalisé avec le nom de votre choix, et les propriétés qui méritent d'être conservées. |
| Enregistrer une vente réalisée sur une page de paiement sur mesure | Un événement nommé `payment`, avec le montant et la devise. |
| Associer un e-mail à un visiteur | Le champ `email`, sur n'importe quel événement. |
| Afficher le nom d'un visiteur sur la page Personnes | Les champs `name`, `first_name` et `last_name`, sur un événement nommé exactement `payment`. |

Pour une vente sur une page de paiement sur mesure, l'événement ressemble à ceci :

```javascript theme={null}
visitors.track("payment", {
  email: "jane@example.com",
  first_name: "Jane",
  last_name: "Doe",
  name: "Jane Doe",
}, {
  revenue_amount: 49,
  revenue_currency: "USD",
});
```

Trois choses à savoir :

* **Il n'existe pas de méthode identify séparée.** Un visiteur devient identifié lorsque ses informations sont transmises dans un événement personnalisé, ou automatiquement lorsque Stripe est connecté. Consultez [identifier les visiteurs](https://docs.taap.it/fr/radar/guides/identify-visitors.md), et lisez [confidentialité et consentement](https://docs.taap.it/fr/help/radar/privacy-and-consent.md) avant d'identifier des personnes.
* **Stripe Checkout ne demande aucun événement.** Si vous connectez Stripe et que vos clients paient sur la page Stripe Checkout, la connexion suffit. L'événement `payment` sert aux pages de paiement que vous avez développées vous-même. Consultez [suivre les revenus](https://docs.taap.it/fr/radar/guides/track-revenue.md).
* **Radar n'a pas de webhooks.** Pour récupérer vos événements personnalisés hors de Radar, lisez-les via l'API à l'adresse `/api/v1/radar/custom-events`. Consultez l'[endpoint des événements personnalisés](https://docs.taap.it/fr/api-reference/radar/custom-events.md). L'API Radar est disponible à partir du plan Pro.

Les événements personnalisés sont disponibles à partir du plan Starter. Comparez les plans sur la [page des tarifs](https://taap.it/pricing). Le guide pour les développeurs se trouve dans [événements personnalisés](https://docs.taap.it/fr/radar/guides/custom-events.md). Pour savoir comment lire le rapport des événements dans votre tableau de bord, consultez l'article du Centre d'aide sur les [événements personnalisés](https://docs.taap.it/fr/help/radar/features/custom-events.md).


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