Configurer un domaine de suivi personnalisé

Dans Emailit, le suivi des ouvertures et des clics fonctionne toujours sur un nom d’hôte de votre propre domaine, comme go.acme.com. Ce guide explique comment publier l’enregistrement CNAME de ce nom d’hôte, le vérifier et activer le suivi.

Avant de commencer

• Ajoutez et vérifiez le domaine d’envoi. Consultez Ajouter un domaine d’envoi.
• Assurez-vous de pouvoir modifier les enregistrements DNS du domaine.
• Choisissez un nom d’hôte qui ne sert à rien d’autre. La valeur par défaut est go, ce qui donne go.acme.com.

Choisir le sous-domaine de suivi

Le nom d’hôte de suivi est <tracking subdomain>.<sending domain>. Pour utiliser autre chose que go :

curl https://api.emailit.com/v2/domains/acme.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tracking_key": "links" }'

Le préfixe peut contenir des lettres minuscules, des chiffres et des traits d’union, 63 caractères au maximum, et doit commencer et se terminer par une lettre ou un chiffre. Le modifier remet l’enregistrement de suivi à Not checked : publiez donc un CNAME pour le nouveau nom d’hôte et vérifiez de nouveau le DNS.

Publier et vérifier le CNAME

1. Ajoutez l’enregistrement CNAME. Chez votre fournisseur DNS, créez cet enregistrement :

   Type	Hôte	Cible
   CNAME	go (ou votre sous-domaine de suivi)	go.emailitmail.com

   Pour acme.com, le résultat est :

   Text

   go.acme.com.   CNAME   go.emailitmail.com.

   Si vous envoyez depuis un sous-domaine comme mail.acme.com, l’hôte est go.mail dans la zone acme.com.

2. Désactivez le proxy sur Cloudflare. Si votre DNS est chez Cloudflare, réglez le statut de proxy de l’enregistrement sur DNS only (nuage gris). Un enregistrement proxifié renvoie les adresses IP de Cloudflare au lieu du CNAME, et le suivi ne peut ni être vérifié ni traiter les requêtes. La configuration Cloudflare crée l’enregistrement en DNS only pour vous.

3. Vérifiez le DNS. Sur la page du domaine, sélectionnez Check DNS. Le badge de statut de la carte Tracking passe à OK quand le CNAME pointe vers go.emailitmail.com.

4. Activez le suivi. Dans la carte Tracking, activez Track loads, Track clicks ou les deux. Les interrupteurs restent désactivés tant que le CNAME n’affiche pas OK.

   Avec l’API, appelez Mettre à jour un domaine avec "track_loads": true et "track_clicks": true.

Ces interrupteurs définissent le comportement par défaut pour les e-mails envoyés depuis le domaine. Vous pouvez les remplacer pour un seul e-mail avec le champ tracking lors d’un envoi via l’API. Consultez Suivi des ouvertures et des clics.

HTTPS

Tous les liens et pixels de suivi utilisent https://. Emailit émet et renouvelle automatiquement le certificat de votre nom d’hôte de suivi, dès la première requête reçue pour celui-ci. Vous n’avez ni certificat à téléverser ni rien d’autre à modifier.

Vérifier le résultat

1. Envoyez un e-mail de test depuis le domaine avec au moins un lien, par exemple avec Compose sur la page Emails.

2. Vérifiez les liens. Dans le message reçu, survolez un lien. Il doit commencer par https://go.acme.com/, et non par votre URL d’origine.

3. Ouvrez et cliquez. Ouvrez l’e-mail et cliquez sur le lien. La page de l’e-mail dans Email API›Emails affiche l’ouverture sous Loads et le clic sous Clicks, et le statut passe à loaded, puis à clicked.

Dépannage

Voir aussi