# Configurer un domaine de suivi personnalisé

> Publiez le CNAME de suivi de votre domaine d’envoi, vérifiez-le et activez le suivi des ouvertures et des clics pour que les liens et les pixels utilisent votre propre nom d’hôte en HTTPS.

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](/fr/docs/domains/add-a-domain/).
- 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` :

**Tableau de bord**

  Sur la page du domaine dans **Email API → Domains**, repérez la carte **Custom Subdomains**. Saisissez un préfixe dans **Tracking Subdomain**, par exemple `links`, puis sélectionnez **Save**.

**API**

  Appelez [Mettre à jour un domaine](/fr/docs/api-reference/domains/update/) avec `tracking_key`. Vous pouvez aussi le transmettre lorsque vous [créez le domaine](/fr/docs/api-reference/domains/create/).

```bash
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 :

```txt
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](/fr/docs/domains/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](/fr/docs/api-reference/domains/update/) 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](/fr/docs/tracking/#turn-tracking-on).

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

| Symptôme | Solution |
| --- | --- |
| Le suivi affiche **Missing** | Le CNAME n’est pas publié sur l’hôte attendu. Vérifiez avec `dig +short CNAME go.acme.com @1.1.1.1`. Une cause fréquente : saisir le nom complet alors que le fournisseur n’attend que `go`. |
| Le suivi affiche **Invalid** | Le CNAME pointe ailleurs, ou l’enregistrement est proxifié sur Cloudflare. Faites-le pointer vers `go.emailitmail.com` et réglez-le sur **DNS only**. |
| **Track loads** et **Track clicks** sont grisés | Le CNAME n’est pas encore vérifié. Sélectionnez **Check DNS** après l’avoir publié. |
| Les e-mails arrivent avec les liens d’origine | Le suivi est désactivé pour le domaine, le message a été envoyé avec `"tracking": false`, ou l’enregistrement de suivi n’était pas **OK** lors de la dernière vérification DNS. Emailit envoie alors l’e-mail sans suivi plutôt que de le faire échouer. |
| Les liens affichent un avertissement de certificat | Le CNAME vient d’être créé. Patientez une minute et réessayez. Si le problème persiste, vérifiez que l’enregistrement n’est pas proxifié. |
| Un CNAME existe déjà sur `go` | Choisissez un autre sous-domaine de suivi, comme `links` ou `t`, et publiez-y le CNAME. |

## Voir aussi

  - [Suivi des ouvertures et des clics](/fr/docs/tracking/): Fonctionnement du suivi et degré de précision.
  - [Enregistrements DNS](/fr/docs/domains/dns-records/): Tous les enregistrements d’un domaine d’envoi.

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