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

# Identifier les visiteurs avec Stripe ou un événement personnalisé

> Comment un visiteur Radar anonyme devient une personne identifiée : automatiquement via Stripe, ou quand votre code envoie un e-mail sur un événement personnalisé.

Tout visiteur Radar est d'abord anonyme : Radar le reconnaît sans aucune information personnelle et affiche un nom généré. Un visiteur devient une personne identifiée quand Radar apprend son e-mail et, dans certains cas, son nom. Ce guide explique les deux façons dont cela se produit, les champs que Radar lit, et la règle qui décide si un nom apparaît sur la page Personnes.

Vous n'êtes pas développeur ? L'article du Centre d'aide sur [l'identification des visiteurs](https://docs.taap.it/fr/help/radar/features/identify-visitors.md) en donne la version courte.

## Deux façons d'identifier un visiteur

| Méthode | Ce que vous faites | Code nécessaire |
| - | - | - |
| Via Stripe | Connectez Stripe à votre projet Radar. Les clients payants sont identifiés à partir de leur paiement. | Non |
| Via un événement personnalisé | Envoyez les champs d'identité du visiteur avec `visitors.track`, au moment où vous apprenez qui il est. | Oui |

> [!NOTE]
>
> Radar n'a pas de méthode `identify` séparée. L'identité voyage sur vos événements personnalisés, sous forme de propriétés ordinaires aux noms réservés.

## Identifier via Stripe

Quand Stripe est connecté, chaque client payant est identifié automatiquement. Radar récupère l'e-mail et le nom dans le paiement et les relie à la session du visiteur. Vous n'avez rien à envoyer.

Cela couvre les clients qui paient sur la page Stripe Checkout, la page de paiement hébergée par Stripe. Si votre site a sa propre page de paiement, vous envoyez aussi un événement `payment`. Consultez [suivre les revenus](https://docs.taap.it/fr/radar/guides/track-revenue.md).

## Identifier avec un événement personnalisé

Ajoutez les champs d'identité aux propriétés de n'importe quel appel `visitors.track` :

```javascript theme={null}
visitors.track("signup", {
  email: "jane@example.com",
});
```

Si vous découvrez les événements personnalisés, commencez par [envoyer des événements personnalisés](https://docs.taap.it/fr/radar/guides/custom-events.md).

### Les champs que Radar lit

| Champ | Ce qu'il contient | Quand Radar l'utilise |
| - | - | - |
| `email` | L'adresse e-mail du visiteur. | Sur n'importe quel événement, quel que soit son nom. |
| `name` | Le nom complet du visiteur. | Uniquement sur un événement nommé exactement `payment`. |
| `first_name` | Le prénom du visiteur. | Uniquement sur un événement nommé exactement `payment`. |
| `last_name` | Le nom de famille du visiteur. | Uniquement sur un événement nommé exactement `payment`. |

### Quel champ l'emporte

Quand un événement contient `name` en même temps que `first_name` et `last_name`, `name` est prioritaire. Envoyez `name` quand vous avez déjà le nom complet tel que votre client l'a saisi.

### La règle sur les noms et `payment`

Un e-mail identifie le visiteur sur n'importe quel événement. Un nom, non. Radar ne copie `name`, `first_name` et `last_name` vers la page Personnes que lorsqu'ils arrivent sur un événement nommé exactement `payment`. Sur tout autre événement, ces champs restent attachés à l'événement lui-même, et la page Personnes continue d'afficher le nom généré.

Comparez les deux appels :

```javascript Inscription theme={null}
// The visitor is identified by their email.
// The People page still shows a generated name.
visitors.track("signup", {
  email: "jane@example.com",
  first_name: "Jane",
  last_name: "Doe",
});
```

```javascript Paiement theme={null}
// The visitor is identified by their email,
// and the People page shows "Jane Doe".
visitors.track(
  "payment",
  {
    email: "jane@example.com",
    first_name: "Jane",
    last_name: "Doe",
    name: "Jane Doe",
  },
  {
    revenue_amount: 49,
    revenue_currency: "USD",
  }
);
```

> [!WARNING]
>
> Réservez `payment` aux vraies ventes. C'est l'événement qui porte le montant d'une vente : ne l'envoyez donc pas uniquement pour faire apparaître un nom.

## Quand identifier

Identifiez un visiteur dès le premier moment où vous savez qui il est. Son historique anonyme antérieur reste attaché à lui : vous voyez donc ce qu'il a fait avant et après.

| Moment | Exemple de nom d'événement | Ce qu'il faut envoyer |
| - | - | - |
| Inscription | `signup` | `email` |
| Connexion | `login` | `email` |
| Appel réservé ou formulaire de contact envoyé | `book_call`, `contact_form_submit` | `email` |
| Abonnement à la newsletter | `newsletter_subscribe` | `email` |
| Achat sur votre propre page de paiement | `payment` | `email`, les champs de nom et le montant |
| Achat sur la page Stripe Checkout | Aucun | Rien, une fois Stripe connecté |

Les noms d'événements sont des exemples, sauf `payment`. Utilisez les noms qui conviennent à votre produit.

### À l'inscription ou à la connexion

Envoyez l'événement une fois le compte créé ou la connexion réussie. Lisez l'e-mail dans votre propre objet utilisateur au lieu de l'écrire en dur dans le code.

```javascript theme={null}
function onSignupSuccess(user) {
  visitors.track("signup", {
    email: user.email,
  });
}

function onLoginSuccess(user) {
  visitors.track("login", {
    email: user.email,
  });
}
```

### Lors d'une réservation ou d'un formulaire

Un seul appel enregistre l'action et identifie la personne. Dans cet exemple, `submitBooking` représente votre propre code de réservation.

```javascript theme={null}
async function onBookCall(form) {
  const result = await submitBooking(form);
  if (!result.success) return;

  visitors.track("book_call", {
    source: "landing",
    email: form.email,
  });
}
```

### Lors d'un achat

Sur votre propre page de paiement, envoyez l'événement `payment` une fois le paiement confirmé. C'est le seul événement sur lequel les champs de nom arrivent jusqu'à la page Personnes.

```javascript theme={null}
function onPaymentConfirmed(order) {
  visitors.track(
    "payment",
    {
      email: order.customer.email,
      first_name: order.customer.firstName,
      last_name: order.customer.lastName,
      name: order.customer.fullName,
    },
    {
      revenue_amount: order.total,
      revenue_currency: order.currency,
    }
  );
}
```

Les trois arguments sont détaillés dans [suivre les revenus](https://docs.taap.it/fr/radar/guides/track-revenue.md).

## Vérifier qu'un visiteur est identifié

**1. Faire l'action vous-même**

Sur votre site publié, créez un compte, connectez-vous ou remplissez le formulaire avec une adresse e-mail de test.

**2. Ouvrir la page Personnes**

Dans votre projet Radar, allez dans Personnes et retrouvez votre visite. Le visiteur porte maintenant l'e-mail que vous avez envoyé. Cliquez sur la ligne pour ouvrir son historique complet.

**3. Vérifier le nom, si vous avez envoyé un événement payment**

Après un événement `payment` avec des champs de nom, la page Personnes affiche le vrai nom à la place du nom généré.

Vous pouvez faire la même vérification depuis vos propres outils avec l'API Radar. Le filtre `identity` ne garde que les visiteurs identifiés :

```bash theme={null}
curl -X GET 'https://taap.it/api/v1/radar/people?start=2026-11-01T00:00:00Z&end=2026-11-30T23:59:59Z&identity=identified' \
  -H 'Authorization: Bearer taapit_your_api_key_here'
```

Chaque personne est renvoyée avec un `status` (`identified` ou `anonymous`), un `email`, et un `name` qui contient le vrai nom quand Radar le connaît, et un nom généré sinon. Consultez l'[endpoint des personnes](https://docs.taap.it/fr/api-reference/radar/people.md). L'API Radar est disponible à partir du plan Pro.

## Avant de mettre en production

> [!WARNING]
>
> Identifier des visiteurs, ce n'est pas la même chose que des statistiques anonymes. Les fonctionnalités qui identifient les visiteurs nécessitent un bandeau de consentement. Lisez [confidentialité, cookies et RGPD](https://docs.taap.it/fr/help/radar/privacy-and-consent.md) et vérifiez d'abord votre bandeau et votre politique de confidentialité.

## Bon à savoir

* **Radar ne sait que ce qu'on lui envoie.** Il ne révèle ni le nom ni l'entreprise d'un visiteur qui ne vous a jamais donné ses coordonnées.
* **Chaque appel est un événement.** Un événement qui identifie un visiteur est décompté des événements que votre plan inclut chaque mois, comme n'importe quel autre événement personnalisé. Consultez [plans et événements](https://docs.taap.it/fr/help/radar/plans-and-events.md).
* **Pas de webhooks.** Radar ne prévient pas vos systèmes quand un visiteur est identifié ou revient. Lisez plutôt les données avec l'[API Radar](https://docs.taap.it/fr/api-reference/radar/introduction.md).

## Étapes suivantes

> [card] [Envoyer des événements personnalisés](https://docs.taap.it/fr/radar/guides/custom-events.md)
>
> L'appel, ses arguments et le moment où l'envoyer.

> [card] [Suivre les revenus](https://docs.taap.it/fr/radar/guides/track-revenue.md)
>
> Connectez Stripe ou envoyez un événement payment depuis votre propre page de paiement.


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