Adlead - Documentation

# Guide d'intégration

Ce guide détaillé a pour but de faciliter l'intégration des kist e-mailing au sein de notre solution.

En suivant scrupuleusement les directives ci-dessous, vous vous assurez que votre contenu sera correctement affiché et fonctionnel pour vos destinataires.

# Consignes de format et de structure

# Format de l'archive

Votre kit e-mailing être fourni sous la forme d'une archive compressée utilisant le format .zip.

# Contraintes de poids

  • Poids de l'archive : Le fichier .zip ne doit pas excéder 2.5 Mo.
  • Poids après décompression : Une fois décompressée, la taille totale des fichiers ne doit pas dépasser 5 Mo.

# Contenu de l'Archive

L'archive doit contenir à sa racine un fichier index.html contenant le code HTML de l'e-mailing.

# Gestion des images

Il est crucial que les images soient correctement organisées au sein de l'archive pour assurer leur intégration :

Toutes les images doivent être regroupées dans un dossier unique appelé /img/, qui doit se trouver directement à la racine de l'archive. Aucun sous-dossier supplémentaire dans /img/ ne doit être utilisé.

Les images situées dans un emplacement différent de ce dossier spécifié ne seront pas prises en compte lors de l'importation.

# Types de fichiers supportés

Nous acceptons uniquement certaines extensions de fichiers pour les images. Voici un tableau récapitulatif :

Extension Description
.html Uniquement pour le fichier index.html situé à la racine de l'archive
.jpg Fichier JPEG
.png Fichier PNG
.gif Fichier GIF

Tout autre format de fichier ne sera pas pris en compte lors de l'importation.

# Lien de désinscription

Pour être en conformité avec le Règlement Général sur la Protection des Données (RGPD), il est obligatoire que votre fichier index.html inclue un lien permettant aux destinataires de se désinscrire facilement.

Utilisez le shortcode [[UNSUBSCRIBE_URL]] pour intégrer automatiquement un lien de désinscription dans vos e-mails.

Exemple

<a href="[[UNSUBSCRIBE_URL]]">Cliquer ici pour vous désinscrire</a>

# Lien d'opposition au suivi

Le shortcode [[TRACKING_OPPOSITION_URL]] intègre automatiquement dans vos e-mails un lien permettant au destinataire de s'opposer au suivi de l'ouverture et des clics. Ce lien est distinct de celui de désinscription.

Exemple

<a href="[[TRACKING_OPPOSITION_URL]]" rel="notrack">
    Vous pouvez vous opposer au suivi de l'ouverture et des clics
</a>

L'ABSENCE DU SHORTCODE DÉSACTIVE LA MESURE

Contrairement à [[UNSUBSCRIBE_URL]], ce shortcode n'est pas obligatoire : un kit qui ne le contient pas s'importe sans erreur.

En revanche, son absence désactive la mesure de la campagne : sans moyen de s'y opposer, ni l'ouverture ni les clics ne sont mesurés. Un client qui souhaite disposer de ses statistiques de campagne doit donc poser ce shortcode.

L'attribut rel="notrack" demande au routeur de ne pas réécrire ce lien. Sans lui, le clic sur le lien d'opposition serait comptabilisé comme un clic marketing.

# Mention d'absence de mesure

Le shortcode [[TRACKING_NOT_MEASURED]] accompagne [[TRACKING_OPPOSITION_URL]]. Sa valeur dépend de l'état de la mesure au moment de l'envoi :

État de l'envoi Valeur substituée
Mesuré Chaîne vide
Non mesuré L'ouverture de cet e-mail et les clics sur ses liens ne sont pas mesurés.

Exemple

<p style="font-size: 12px;">[[TRACKING_NOT_MEASURED]]</p>

Les deux shortcodes se complètent : celui-ci informe le destinataire de l'état de la mesure, [[TRACKING_OPPOSITION_URL]] lui permet de s'y opposer.

# Exemple d'arborescence

Voici comment votre archive ZIP devrait être structurée :

mon-kit-emailing.zip
├── index.html
└── img
    ├── image1.jpg
    ├── image2.png
    └── image3.gif

Cette structure assure que le fichier HTML principal et toutes les images associées sont organisés de manière optimale pour l'intégration.

# Shortcodes Supportés

Votre contenu peut être personnalisé grâce à l'utilisation de shortcodes spécifiques. Voici une liste des shortcodes que nous supportons :

Shortcode Description Obligatoire
[[UNSUBSCRIBE_URL]] URL de désinscription Oui
[[TRACKING_OPPOSITION_URL]] URL d'opposition au suivi des e-mails Non - mais requis pour la mesure
[[TRACKING_NOT_MEASURED]] Mention affichée si l'envoi n'est pas mesuré Non
[[SERVICE_NOTICE]] Permet de distinguer l'envoi d'une prospection sans consentement Oui pour les e-mails de service
[[VIEW_IN_BROWSER_URL]] URL de la version en ligne de l'e-mailing Non

# Liens personnalisés par destinataire

Les shortcodes [[UNSUBSCRIBE_URL]] et [[TRACKING_OPPOSITION_URL]] sont remplacés à l'envoi par un lien propre à chaque destinataire. Trois comportements en découlent :

  1. Les guillemets et le placement n'ont pas d'importance. La substitution porte sur le shortcode nu : guillemets simples ou doubles, marqueur placé hors d'une ancre ou dans un bouton MSO, tous les cas sont traités de la même façon.
  2. Dans un e-mail de test, le shortcode reste littéral et le lien apparaît mort. C'est le comportement attendu : en l'absence de destinataire réel, aucun lien ne peut être généré.
  3. Sur la page « consulter dans le navigateur », le lien est délesté et seul son texte subsiste. Même raison : un permalien n'identifie aucun destinataire.

# Archive Modèle

Pour vous aider dans le processus de création de votre kit, une archive modèle est disponible. Cette dernière illustre parfaitement l'organisation des fichiers et le respect des spécifications techniques requises pour une intégration sans faille.

Vous pouvez retrouver cette archive à cette adresse.

Automatisations →