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

# Suivi des emails

> Enregistrez l'ouverture de vos emails et les clics sur leurs liens, et laissez chaque contact accepter ou refuser ce suivi.

## Vue d'ensemble

Notifuse peut enregistrer deux choses sur les emails qu'il envoie :

- **Ouvertures** : une image invisible (un pixel de suivi) est ajoutée à l'email et enregistre le moment où il est ouvert.
- **Clics** : les liens passent par une redirection qui enregistre chaque clic avant d'envoyer le contact vers la page.

Chacun s'active séparément dans les paramètres de l'espace de travail, et chaque contact peut accepter ou refuser chacun d'eux. Les liens gardent leurs [paramètres UTM](https://www.notifuse.com/fr/docs/features/broadcast-campaigns.md#utm-tracking) quel que soit le choix de suivi.

## Paramètres de l'espace de travail

Dans **Paramètres → Général**, panneau **Suivi des e-mails** :

- **Ouvertures** et **Clics** activent ou désactivent chaque type de suivi pour tout l'espace de travail. Quand l'un est désactivé, aucun email ne le porte, quel que soit le choix des contacts.
- **Contacts sans consentement enregistré** décide du sort d'un contact qui n'a jamais fait de choix : **Tracker** (par défaut) ou **Ne pas suivre**.

Le choix d'un contact l'emporte toujours sur ce paramètre. Certaines autorités, comme le Garante italien et la CNIL en France, attendent que le suivi des ouvertures et des clics soit soumis au consentement. Si c'est votre cas, choisissez **Ne pas suivre** : seuls les contacts qui ont accepté sont alors suivis.

## Le choix du contact

Chaque contact a quatre champs :

| Champ                         | Description                                                                                                  |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| `tracking_opens_consent`      | `granted`, `denied`, ou `null` si inconnu                                                                    |
| `tracking_clicks_consent`     | `granted`, `denied`, ou `null` si inconnu                                                                    |
| `tracking_consent_updated_at` | Date du dernier changement d'un choix. Notifuse le renseigne quand une valeur change, sauf si vous l'envoyez |
| `tracking_consent_source`     | Origine du changement : `api`, `console`, `import`, `notification_center`, `email_link` ou `subscribe_form`  |

Les ouvertures d'un email sont suivies quand l'espace de travail suit les ouvertures et que le choix du contact le permet : `granted`, ou inconnu avec **Tracker** sélectionné. Les clics suivent la même règle.

Le choix peut être défini :

- **Par l'API** : `contacts.upsert`, `contacts.import`, le `contact` de l'API transactionnelle et le point d'accès d'inscription. Sans `tracking_consent_source`, un changement fait avec une clé API enregistre `api` et un import enregistre `import` ; un formulaire d'inscription envoyé sans clé API enregistre toujours `subscribe_form`.
- **Dans la console** : sur la page du contact, à la création ou à la modification d'un contact, et dans les imports CSV (colonnes associées à _Consentement au tracking des ouvertures_ et _Consentement au tracking des clics_, valeurs `granted` ou `denied`).
- **Par le contact**, dans le [centre de notifications](https://www.notifuse.com/fr/docs/features/notification-center.md#email-tracking).

Envoyez `null` pour remettre un choix à l'état inconnu. Une requête qui omet ces champs conserve le choix enregistré.

### Utiliser le choix

- **Liste des contacts** : filtrez sur chaque choix, `unknown` compris, et affichez une colonne _Consentement au tracking_. Les exports CSV contiennent les quatre champs.
- **Segments** : les quatre champs sont des champs du contact ; utilisez _n'est pas défini_ pour un choix inconnu.
- **Automations** : un déclencheur _contact mis à jour_ peut se limiter au changement de l'un ou l'autre choix.
- **Webhooks** : les payloads de contact portent les quatre champs, et un changement est enregistré dans la chronologie du contact.

## Quand un contact change d'avis

Le choix s'applique à l'envoi d'un email, et il est vérifié à nouveau à l'arrivée d'une ouverture ou d'un clic. Un contact qui refuse le suivi après l'envoi d'un email n'est pas enregistré s'il l'ouvre ou clique dessus ; le lien le mène toujours à la page.

## Clics sur les liens

Chaque email enregistre lesquels de ses liens ont été cliqués. La première fois qu'un contact clique sur chaque lien d'un email,
la chronologie du contact reçoit une entrée `email.link_clicked` avec l'adresse du lien, à côté de l'entrée `email.clicked` du
premier clic sur l'email. Cette entrée peut [démarrer une automation](https://www.notifuse.com/fr/docs/features/automations.md#link-click-triggers), et elle met à jour
immédiatement les segments qui filtrent sur un lien cliqué. Elle ne compte pas dans le volume mensuel d'événements.

Aucune entrée n'est écrite pour :

- un clic sur un lien déjà cliqué dans cet email (un lien cliqué avant la mise à jour vers 44.0 reçoit son entrée à son
  prochain clic) ;
- un lien que Notifuse ne peut pas vérifier : les liens des emails envoyés avant la version 42.2, et les liens dont la signature ne correspond pas ;
- un lien dont l'adresse dépasse 2 048 caractères, ou un lien au-delà des 50 premiers liens différents cliqués dans un
  email ;
- les liens qui ne sont ni `http` ni `https`, comme `mailto:` et `tel:`, et les liens vers votre instance Notifuse elle-même,
  comme les liens de désabonnement, du centre de notifications et de version web. Notifuse les reconnaît par votre point d'accès API, le domaine personnalisé de votre
  espace de travail ou l'hôte atteint par le clic (y compris celui transmis par un reverse proxy), sur n'importe quel port.
  Cela couvre aussi les liens vers votre blog quand il est servi sur votre domaine personnalisé, et les liens vers un autre site servi sur
  le même nom d'hôte que votre instance Notifuse, même sur un autre port.

Les ouvertures et les clics sur un email dont le contact a été supprimé ne sont pas enregistrés ; le lien mène toujours le lecteur à la page.

## Statistiques

Les taux d'ouverture et de clic sont calculés sur les emails suivis, et non sur tous les emails envoyés. Quand certains emails n'ont pas été suivis, l'infobulle du taux indique combien l'ont été (_sur 1 200 trackés_) ; un taux sans aucun email suivi affiche `-`. Cela vaut pour les statistiques des newsletters, les résultats des tests A/B, les taux de clic par lien et le tableau de bord d'analyse.

Les emails envoyés avant la version 43 comptent comme suivis, si bien que leurs taux ne changent pas.

## Tests A/B

Le gagnant automatique est choisi sur le taux d'ouverture ou de clic des destinataires suivis de chaque variante. Une variante sans destinataire suivi ne peut pas gagner ; quand aucune variante n'en a, vous choisissez vous-même le gagnant.

Quand l'espace de travail ne suit pas les contacts sans consentement enregistré, seuls les contacts qui ont accepté comptent dans les résultats. Le tableau des variantes affiche un avertissement orange quand moins de la moitié des destinataires d'une variante ont été suivis, et l'infobulle de chaque taux donne le nombre de destinataires suivis.

## Désactiver le suivi pour un email

- **Newsletters** : cochez **Ne pas suivre les ouvertures et les clics de cette newsletter** à l'étape _Analyse web_ (`tracking_mode: "no_tracking"` dans l'API). Les paramètres UTM sont conservés, et le gagnant d'un test A/B doit alors être choisi à la main.
- **Notifications transactionnelles** : choisissez **Pas de tracking des ouvertures et des clics, UTM conservés** (`no_tracking`), ou **Désactivé pour cette notification** (`disabled`), qui laisse aussi les liens intacts, sans paramètres UTM, pour les liens qui ne doivent pas changer, comme les liens de connexion.

## Liens dans les modèles

Deux variables permettent aux contacts de faire leur choix depuis un email :

- `{{ tracking_preferences_url }}` ouvre la fenêtre de suivi des emails du centre de notifications.
- `{{ tracking_optout_url }}` demande au contact de confirmer, puis refuse à la fois le suivi des ouvertures et celui des clics (source `email_link`). Rien n'est enregistré avant la confirmation du contact, car les scanners de sécurité des messageries ouvrent les liens d'eux-mêmes.

```html
<a href="{{ tracking_preferences_url }}">Choose what we track</a>
```

Notifuse ne réécrit jamais ces deux liens pour le suivi.
