> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Identifier les visiteurs

> Rattachez une visite de votre site à un contact, et utilisez le comportement de navigation dans les segments.

![La chronologie d'un contact filtrée sur Web, avec une session web et ses pages vues](https://www.notifuse.com/docs/assets/screenshots/web_analytics/contact_timeline_web.png)

Par défaut, l'analyse web est anonyme : elle compte les visites sans savoir qui les a faites. Une fois un visiteur identifié, ses visites apparaissent dans la chronologie de son contact et les segments peuvent utiliser son comportement.

Comme `/track` est un endpoint public, une adresse seule ne prouve rien. L'identification est donc toujours signée.

## identify()

Appelez `identify` dès que vous savez qui est le visiteur, avec son adresse et une signature calculée **sur votre serveur**.

```javascript
NotifuseAnalytics.identify('alice@example.com', '<hmac from your server>')
```

Les deux arguments sont obligatoires : sans eux, `identify` rejette l'appel au lieu d'échouer en silence. Il rejette aussi une adresse de plus de 255 caractères ou une signature de plus de 64 octets. Une adresse _mal signée_ échoue en silence : le serveur ignore l'identité et enregistre la visite comme anonyme.

### Calculer la signature

La signature est un HMAC-SHA256, encodé en hexadécimal, calculé sur la chaîne `wa_identify:` suivie de l'adresse email, avec la clé secrète de votre espace de travail comme clé.

```javascript Node.js
import { createHmac } from 'crypto'

function webIdentifyHmac(email, workspaceSecretKey) {
  return createHmac('sha256', workspaceSecretKey)
    .update('wa_identify:' + email)
    .digest('hex')
}
```

```go Go
func webIdentifyHMAC(email, workspaceSecretKey string) string {
	mac := hmac.New(sha256.New, []byte(workspaceSecretKey))
	mac.Write([]byte("wa_identify:" + email))
	return hex.EncodeToString(mac.Sum(nil))
}
```

Signez l'adresse exactement telle que vous la passez à `identify` : la signature est vérifiée avant la normalisation de l'adresse, donc `Alice@Example.com` doit être signée sous la forme `Alice@Example.com`.

> [!WARNING]
>
> Ne calculez jamais cette signature dans le navigateur. Elle existe parce que n'importe qui peut envoyer des données à l'endpoint de suivi, et une clé secrète livrée dans la page lui retire toute utilité.
>
> Le préfixe `wa_identify:` distingue cette signature de celle de vos liens de désabonnement. Une signature récupérée dans un email transféré ne peut donc pas identifier un visiteur, et une signature récupérée dans votre page ne peut pas modifier les abonnements de quelqu'un.

`clearIdentity()` empêche les beats suivants de porter l'identité. Il ne rend pas anonyme ce qui a déjà été enregistré.

## Identifier depuis les liens des emails

Notifuse peut ajouter une identité signée aux liens des emails suivis. Un destinataire qui clique sur l'un d'eux est alors reconnu à son arrivée, sans aucun code sur votre site.

Cette option est désactivée par défaut. Activez **Identifier les destinataires des emails** dans **Paramètres** → **Analyse web**.

> [!NOTE]
>
> Avec `identify()`, c'est votre serveur qui fait l'appel, avec votre propre secret. Ici, l'identifiant est généré par Notifuse pour chaque destinataire de chaque envoi suivi. C'est pour cela qu'il a son propre réglage et qu'il ne s'active pas avec l'analyse web.

L'identité est un paramètre `nf_id` chiffré qui expire 7 jours après sa génération. Il n'est ajouté qu'aux liens dont l'hôte figure dans vos domaines autorisés : les liens tiers du même email ne le portent jamais. Le tracker le lit à l'arrivée et le retire de l'URL.

Un envoi n'en porte jamais quand le suivi est explicitement désactivé pour la notification, ou (avec l'API transactionnelle) quand le message a un destinataire en CC ou en BCC, car l'identité serait sinon remise à quelqu'un qui n'est pas le contact.

> [!WARNING]
>
> Désactiver le **suivi des clics** ne retire pas l'identité. Sans redirection pour l'envelopper, le paramètre est écrit directement sur votre propre lien. Pour le supprimer, il faut désactiver le suivi de la notification ou désactiver l'identification par les liens des emails.
>
> Désactiver le réglage empêche seulement la génération de _nouveaux_ identifiants. Un `nf_id` déjà présent dans le navigateur d'un visiteur continue de l'identifier jusqu'à son expiration, au plus 7 jours plus tard.

## Ce que l'identification enregistre

Une fois le visiteur identifié, cette visite et tout ce qui y a déjà été enregistré sont attribués au contact :

- **Sur les lignes analytiques** : l'adresse du contact. Contact Email devient ainsi une dimension et Identified Contacts une mesure.
- **Dans la chronologie du contact** : une entrée par page vue et une entrée qui résume la visite, ainsi que les objectifs sous forme d'événements personnalisés.

Si l'adresse n'est pas encore un contact, un contact est créé avec la langue et le fuseau horaire signalés par la visite, ainsi que le pays déduit de l'IP du visiteur quand la géolocalisation est active. Une valeur que Notifuse ne peut pas stocker, comme une langue non prise en charge ou un fuseau horaire inconnu, est laissée de côté. Un contact existant n'est jamais modifié par une visite, et un contact créé de cette façon n'est ajouté à aucune liste.

## Sur la fiche du contact

L'onglet **Visites web** de la fiche d'un contact liste ses visites identifiées, de la plus récente à la plus ancienne : quand, combien de temps, combien de pages, d'où il venait et sur quel appareil. Dépliez une visite pour voir son parcours page par page, avec les objectifs atteints en chemin. Au-dessus de la liste, un résumé donne la première visite identifiée, les objectifs atteints et les pages les plus vues, et **Ouvrir dans l'analyse web** ouvre le dashboard filtré sur le contact.

L'onglet n'apparaît qu'aux membres qui peuvent lire l'analyse web, et seulement quand l'analyse web est activée.

## Segments

Le comportement web est disponible sous forme de conditions d'activité dans un segment :

| Condition               | Filtre sur                                                                                                                                                                                                                                                       |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Voir la page web**    | Chemin, temps passé sur la page, profondeur de défilement, numéro de la page dans la visite, type d'entrée                                                                                                                                                       |
| **Visiter le site web** | Page d'entrée, page de sortie, pages vues, durée de la visite, profondeur de défilement, objectifs atteints, valeur des objectifs, domaine référent, source, medium et campagne UTM, canal, groupe de canaux, appareil, navigateur, système d'exploitation, pays |

« A vu `/pricing` au moins deux fois au cours des 30 derniers jours » ou « est venu d'une campagne de newsletter et a atteint au moins un objectif » sont donc des conditions de segment ordinaires. Voir [Contacts](https://www.notifuse.com/fr/docs/features/contacts.md) pour la façon dont les conditions se combinent.

> [!NOTE]
>
> La navigation ne déclenche jamais d'automation. Les pages vues et les visites sont enregistrées et utilisables dans les segments, mais seuls les **objectifs** atteignent les automations, par le déclencheur `custom_event`, sous le nom normalisé de l'objectif. Les objectifs portent un type déclaré : ils sont donc aussi accessibles par la condition Custom Events Goal. Voir [Objectifs](https://www.notifuse.com/fr/docs/web-analytics/goals.md#using-web-goals-in-segments).

## Confidentialité

- Aucun cookie n'est déposé, et aucun identifiant ne suit un visiteur d'un site à l'autre.
- Les adresses IP servent à déterminer un emplacement et ne sont jamais stockées.
- Une visite anonyme reste anonyme. Rien ne la relie après coup à un contact identifié lors d'une session ultérieure.
- Supprimer un contact efface son adresse partout où elle était stockée : les lignes analytiques, les entrées de sa chronologie et les événements personnalisés créés à partir de ses objectifs web. Le trafic reste, en anonyme, et les totaux historiques ne changent pas.

> [!WARNING]
>
> Un visiteur dont le navigateur conserve encore un identifiant est identifié à nouveau (et recréé comme contact) lors de sa visite suivante, même après sa suppression. Pour l'arrêter définitivement, cessez d'appeler `identify()` pour cette adresse, et désactivez l'identification par les liens des emails si l'identifiant venait d'un lien. Un `nf_id` généré avant la désactivation du réglage fonctionne jusqu'à son expiration.

## Remarques

- L'identification est limitée en débit par adresse et par IP source. La création d'un _nouveau_ contact à partir d'une identification est en plus limitée par espace de travail.
- Dépasser une limite fait perdre l'identité sur ce beat, jamais la visite.
- Chaque passe de projection écrit au plus 100 pages vues par visite, en gardant les plus récentes. Une longue visite projetée en plusieurs passes peut laisser plus de 100 entrées de pages vues dans la chronologie.
- Les objectifs de plus de 24 heures ne sont pas ajoutés à une chronologie : une visite hors ligne renvoyée plus tard ne déclenche pas d'automations avec un jour de retard.
- [Référence de l'API](https://www.notifuse.com/docs/api-reference.md)
