Suivi des ouvertures et des clics

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

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 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 remplace les valeurs par défaut du domaine pour ce message :

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

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.

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 :

{
  "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.

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.
• Statistiques. Les widgets Loads et Clicks représentent l’engagement dans le temps. Consultez Statistiques.
• Rapports de campagne. Chargements, clics et taux de clic par campagne, avec les clics par lien. Consultez Rapports de campagne.
• É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