# Suivi des ouvertures et des clics

> Comment Emailit suit les ouvertures avec un pixel et les clics avec des liens réécrits sur votre propre domaine, quelle est la précision des données et comment activer ou désactiver le suivi.

Emailit peut enregistrer le moment où les destinataires ouvrent vos e-mails et cliquent sur leurs liens. Le suivi fonctionne sur un nom d’hôte de votre propre domaine, comme `go.acme.com` : les destinataires ne voient donc jamais d’hôte de suivi partagé. Cette page explique le fonctionnement du suivi, ses limites et la façon de le régler.

## Fonctionnement

Le suivi ne fonctionne que si le domaine d’envoi a un CNAME de suivi vérifié (`go.<domain>` qui pointe vers `go.emailitmail.com`). Sans lui, Emailit envoie quand même vos e-mails, mais sans suivi. Commencez par [configurer un domaine de suivi personnalisé](/fr/docs/tracking/custom-tracking-domain/).

**Ouvertures (chargements).** Emailit ajoute une image transparente de 1×1 pixel à la fin du corps HTML, chargée depuis `https://go.acme.com/<token>`. Quand l’application de messagerie du destinataire la charge, Emailit enregistre un chargement et renvoie l’image. Les ouvertures ne peuvent être suivies que dans les e-mails HTML.

**Clics.** Avant l’envoi, Emailit réécrit chaque lien `http` et `https` des parties HTML et texte brut en `https://go.acme.com/<token>`. Quand quelqu’un clique, Emailit enregistre le clic et redirige immédiatement vers l’URL d’origine. Il ne modifie pas les liens `mailto:` et `tel:`, les liens relatifs ni les liens vers les domaines d’Emailit. Si le message a une partie HTML mais pas de partie texte brut, Emailit en génère une à partir du HTML lorsqu’il ajoute le suivi des clics.

Emailit emploie le terme **loaded** (chargé) pour les ouvertures, car il voit seulement que l’image a été chargée, pas qu’une personne a lu l’e-mail.

## Précision et confidentialité

Considérez les données d’ouverture et de clic comme un indicateur, pas comme un décompte exact. Emailit enregistre chaque requête qui atteint votre domaine de suivi et ne filtre pas le trafic automatisé.

- **La Protection de l’activité dans Mail** d’Apple télécharge les images, pixel compris, via les serveurs proxy d’Apple dès l’arrivée de l’e-mail. Ces messages apparaissent comme chargés même si personne ne les a ouverts, et l’adresse IP appartient à Apple.
- **Les proxys d’images**, comme celui de Gmail, récupèrent et mettent en cache les images pour le compte du destinataire. L’adresse IP et le user agent sont ceux du proxy, et les ouvertures répétées peuvent ne pas atteindre Emailit.
- **Les images bloquées** empêchent l’enregistrement de l’ouverture, même quand le destinataire lit l’e-mail.
- **Les scanners de sécurité** des messageries d’entreprise suivent les liens pour les contrôler avant que le destinataire ne voie le message. Ils apparaissent comme des clics, souvent quelques secondes après la livraison.

Les clics sont un indicateur d’engagement plus fiable que les ouvertures. Pour vos décisions de délivrabilité, observez les tendances sur de nombreux messages plutôt que des événements isolés.

Le suivi enregistre l’adresse IP et le user agent de chaque ouverture et de chaque clic. Dans de nombreuses régions, la législation sur la protection de la vie privée vous oblige à informer les destinataires du suivi, par exemple dans votre politique de confidentialité, et certaines exigent leur consentement. Si vous n’avez pas besoin de ces données, laissez le suivi désactivé.

## Activer le suivi

### Valeurs par défaut du domaine

Chaque domaine dispose de deux interrupteurs dans la carte **Tracking** de sa page dans **Email API → Domains** : **Track loads** et **Track clicks**. Ils sont désactivés pour les nouveaux domaines et restent inactifs tant que le CNAME de suivi n’affiche pas **OK**.

Ces interrupteurs définissent le comportement par défaut de chaque e-mail envoyé depuis le domaine via l’API et SMTP. Via SMTP, les valeurs par défaut du domaine sont le seul moyen de régler le suivi.

Avec l’API, appelez [Mettre à jour un domaine](/fr/docs/api-reference/domains/update/) avec `track_loads` et `track_clicks`. Activer l’un ou l’autre avant que le CNAME soit vérifié renvoie `422`.

### Remplacement par e-mail

Le champ `tracking` de [Envoyer un e-mail](/fr/docs/api-reference/emails/send/) remplace les valeurs par défaut du domaine pour ce message :

| Valeur | Ouvertures | Clics |
| --- | --- | --- |
| Omis | Valeur par défaut du domaine | Valeur par défaut du domaine |
| `true` | Activé | Activé |
| `false` | Désactivé | Désactivé |
| `{ "loads": true, "clicks": false }` | Activé | Désactivé |
| `{ "clicks": true }` | Désactivé | Activé |

Sous forme d’objet, une clé omise vaut « désactivé ». La valeur par défaut du domaine ne la complète pas.

```bash
curl https://api.emailit.com/v2/emails \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your receipt",
    "html": "<p>Thanks for your order.</p>",
    "tracking": { "loads": false, "clicks": true }
  }'
```

Si le CNAME de suivi du domaine n’est pas vérifié, Emailit désactive le suivi pour le message au lieu de le rejeter. L’objet `tracking` de la réponse indique ce qui a réellement été appliqué.

Les e-mails de campagne demandent toujours le suivi des ouvertures et des clics : ils sont donc suivis dès que le CNAME de suivi du domaine d’envoi est vérifié. Les envois de test d’une campagne ne sont pas suivis.

## Événements

Chaque ouverture et chaque clic crée un événement, pas seulement le premier. Le statut de l’e-mail passe à `loaded` après la première ouverture et à `clicked` après le premier clic.

| Événement | Déclenché lorsque |
| --- | --- |
| [`email.loaded`](/fr/docs/webhooks/events/email/loaded/) | Le pixel de suivi a été chargé. |
| [`email.clicked`](/fr/docs/webhooks/events/email/clicked/) | Un lien suivi a été cliqué. |

Les deux payloads incluent l’adresse IP et le user agent de la requête, l’e-mail concerné et le contact correspondant s’il existe. `email.clicked` inclut aussi le lien. Voici le `data.object` d’un événement `email.clicked` :

```json
{
  "id": "click_7Tn4Lp9Kd2Rv",
  "object": "click",
  "email_id": "em_5Vb2Nq8Xc1Jm",
  "email": {
    "id": "em_5Vb2Nq8Xc1Jm",
    "rcpt_to": "ada@example.com",
    "mail_from": "hello@acme.com",
    "subject": "Your receipt",
    "created_at": "2026-10-01T09:12:44Z",
    "campaign": null,
    "meta": { "order_id": "1042" }
  },
  "link": {
    "id": "link_9Wd3Ks6Mf4Ht",
    "url": "https://acme.com/orders/1042"
  },
  "contact": { "id": "con_8Ry5Bv2Lq7Np", "email": "ada@example.com" },
  "ip_address": "203.0.113.24",
  "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 14_5) AppleWebKit/605.1.15",
  "created_at": "2026-10-01T09:15:02Z"
}
```

`email.loaded` a la même forme, avec `"object": "load"`, un ID qui commence par `load_` et sans `link`. Pour le format complet des requêtes, consultez [Requêtes de webhook](/fr/docs/webhooks/webhook-requests/).

## Où consulter les données de suivi

- **Détails d’un e-mail.** Les onglets **Loads** et **Clicks** de la page d’un e-mail listent chaque ouverture et chaque clic avec l’heure, l’adresse IP et, pour les clics, l’URL. Consultez [Détails d’un e-mail](/fr/docs/logs/email-details/).
- **Statistiques.** Les widgets **Loads** et **Clicks** représentent l’engagement dans le temps. Consultez [Statistiques](/fr/docs/analytics/).
- **Rapports de campagne.** Chargements, clics et taux de clic par campagne, avec les clics par lien. Consultez [Rapports de campagne](/fr/docs/campaigns/reports/).
- **Événements et webhooks.** Chaque événement `email.loaded` et `email.clicked` apparaît dans **Email API → Events** et est envoyé aux webhooks qui y sont abonnés.

## Étapes suivantes

  - [Domaine de suivi personnalisé](/fr/docs/tracking/custom-tracking-domain/): Publiez et vérifiez le CNAME de suivi.
  - [Configurer des webhooks](/fr/docs/webhooks/set-up/): Recevez les événements email.loaded et email.clicked.

---
Source: https://emailit.com/fr/docs/tracking/