Suivi des ouvertures et des clics
Le suivi se configure par domaine et est désactivé par défaut.
| Paramètre | Effet | Événement de webhook |
|---|---|---|
open_tracking |
Insère un pixel espion de 1x1 dans le corps HTML. | email.opened |
click_tracking |
Réécrit les liens du corps HTML afin que les clics soient enregistrés avant la redirection. | email.clicked |
import { SpacePost } from "@spacepost/node";
const spacepost = new SpacePost(process.env.SPACEPOST_API_KEY);
const { error } = await spacepost.domains.update({ id: "0192e1c4-0000-7000-8000-000000000001", openTracking: true, clickTracking: true,});if (error) console.error(error);curl -X PATCH https://api.spacepost.dev/domains/$DOMAIN_ID \ -H "Authorization: Bearer $SPACEPOST_API_KEY" -H "Content-Type: application/json" \ -d '{ "open_tracking": true, "click_tracking": true }'La modification s’applique aux e-mails envoyés ensuite. Les deux champs sont facultatifs ; n’envoyez que celui que vous voulez changer.
À prendre en compte
Section intitulée « À prendre en compte »- Les ouvertures sont approximatives. Apple Mail Privacy Protection et certains scanners de sécurité chargent automatiquement les images, ce qui gonfle les ouvertures. Gmail met les images en cache. Considérez les ouvertures comme un signal approximatif, jamais comme la preuve qu’une personne a lu l’e-mail.
- Les clics sont plus fiables, mais les scanners de sécurité peuvent aussi cliquer à l’avance sur les liens.
- Confidentialité. Le suivi enregistre l’adresse IP et le user agent dans le payload de l’événement. Mentionnez-le dans votre politique de confidentialité, et envisagez de laisser le suivi des ouvertures désactivé pour les e-mails transactionnels sensibles (réinitialisations de mot de passe, reçus).
- Les parties en texte brut ne sont jamais suivies. Le suivi n’affecte que le HTML.
- Délivrabilité. La réécriture des liens modifie les URL que voient les destinataires. Certains filtres antispam n’aiment pas cela sur les e-mails transactionnels ; si vous constatez une baisse de délivrabilité, désactivez le suivi des clics pour ce domaine et utilisez un sous-domaine distinct pour les e-mails marketing.
Un événement email.opened ou email.clicked met à jour le last_event de l’e-mail, mais ne le ramène jamais en arrière depuis un état plus grave comme bounced.