Nœud Email Tracker

Le nœud Email Tracker ajoute le suivi des ouvertures et des clics à vos emails avant l’envoi.

Aperçu

Placez le nœud Email Tracker avant votre nœud d’envoi d’email (Gmail, SMTP, SendGrid, etc.). Il va :

Enregistrer l’email auprès de Mailpulse
Remplacer tous les liens par des URLs de redirection suivies
Ajouter un pixel de suivi invisible pour la détection d’ouverture
Renvoyer le HTML modifié prêt à être envoyé

Champs d’Entrée

Champ	Requis	Type	Description
HTML Content	Oui	String	Le contenu HTML de votre email
Recipient Email	Oui	String	L’adresse email du destinataire
Subject	Oui	String	La ligne d’objet de l’email
Campaign	Non	Select	Comment assigner une campagne
Metadata	Non	JSON	Métadonnées optionnelles à stocker

Options de Campagne

Le champ Campagne a trois options :

None - L’email ne sera associé à aucune campagne
Select Existing - Choisir parmi vos campagnes existantes (menu déroulant)
Create New - Entrer un nom pour une nouvelle campagne

Lorsque vous sélectionnez “Create New”, entrer un nom de campagne va :

Utiliser une campagne existante si une avec ce nom existe
Créer une nouvelle campagne si elle n’existe pas

Métadonnées

Stockez des données supplémentaires avec chaque email sous format JSON :


{
  "userId": "user_123",
  "plan": "premium",
  "source": "onboarding"
}

Ces métadonnées sont stockées dans Mailpulse et peuvent être récupérées via l’API.

Sortie

Le nœud renvoie un seul élément avec ces champs :

Champ	Type	Description
`modifiedHtml`	String	HTML avec liens de suivi et pixel
`trackingId`	String	ID unique de suivi pour cet email
`recipient`	String	L’adresse email du destinataire
`subject`	String	L’objet de l’email
`linksTracked`	Number	Nombre de liens qui ont été suivis

Exemple de Sortie


{
  "modifiedHtml": "<html>... (avec suivi) ...</html>",
  "trackingId": "hE4kJ9",
  "recipient": "user@example.com",
  "subject": "Bienvenue sur notre service !",
  "linksTracked": 3
}

Exemples de Flux de Travail

Suivi d’Email Basique


[Déclencheur Manuel] → [Définir HTML] → [Email Tracker] → [Envoyer Email (Gmail)]

Nœud Définir HTML :


{
  "html": "<html><body><a href='https://example.com'>Cliquez ici</a></body></html>",
  "recipient": "user@example.com",
  "subject": "Email de Test"
}

Nœud Email Tracker :

HTML Content: {{ $json.html }}
Recipient Email: {{ $json.recipient }}
Subject: {{ $json.subject }}

Nœud Envoyer Email :

HTML Body: {{ $json.modifiedHtml }}

Avec Destinataires Dynamiques


[Tableur] → [Email Tracker] → [Envoyer Email]

Traiter une liste de destinataires depuis un tableur, en suivant chaque email :

Nœud Email Tracker :

HTML Content: {{ $('Set Email Template').first().json.html }}
Recipient Email: {{ $json.email }}
Subject: Bonjour {{ $json.firstName }}!
Campaign: Create New → Newsletter {{ new Date().toISOString().slice(0,7) }}

Utiliser la Sélection de Campagne

Le menu déroulant pour “Select Existing” charge dynamiquement vos campagnes depuis Mailpulse :

Réglez Campagne sur Select Existing
Cliquez sur le menu déroulant Nom de la Campagne
Sélectionnez parmi vos campagnes disponibles

Cela utilise vos identifiants API pour récupérer la liste des campagnes.

Comment Fonctionne le Suivi

Suivi des Liens

Tous les liens <a href="..."> dans votre HTML sont remplacés :

Avant :


<a href="https://example.com/signup">S'inscrire</a>

Après :


<a href="NEXT_PUBLIC_BASE_URL/t/click/abc123">S'inscrire</a>

Lorsqu’il est cliqué, l’utilisateur est redirigé via Mailpulse (enregistrant le clic) puis vers l’URL originale.

Suivi d’Ouverture

Un pixel invisible 1x1 est ajouté à l’email :


<img src="NEXT_PUBLIC_BASE_URL/t/open/abc123" width="1" height="1" style="display:none;" alt="" />

Lorsque l’email est ouvert et que les images sont chargées, l’ouverture est enregistrée.

Conseils

Préserver la Structure HTML

Le nœud utilise Cheerio pour analyser et modifier le HTML. Il préserve votre structure HTML tout en modifiant uniquement :

Les attributs href dans les balises <a>
L’ajout du pixel de suivi avant </body>

Destinataires Multiples

Lors du traitement de plusieurs éléments (ex: depuis un tableur), chaque destinataire reçoit :

Son propre ID de suivi unique
Ses propres liens suivis
Des analyses individuelles dans le tableau de bord

Suivi Conditionnel

Utilisez le nœud IF de n8n pour suivre conditionnellement les emails :


[Obtenir Données] → [IF doit suivre] → [Email Tracker] → [Envoyer Email]
                              ↓
                       [Envoyer Email (sans suivi)]

Gestion des Erreurs

Si l’API Mailpulse est indisponible, le nœud renverra une erreur. Considérez l’utilisation de :

Flux de Travail d’Erreur - Pour gérer les échecs gracieusement
Logique de Réessai - Attendre et réessayer lors d’échecs temporaires

Exemple de flux d’erreur qui envoie l’email sans suivi si Mailpulse échoue :


[Email Tracker] → [Envoyer Email]
      ↓ (erreur)
[Envoyer Email (HTML original)]