Product
Devenez pro de l’email avec notre API Modèles
Les modèles d’emails sont le secret pour produire des campagnes d’emailing cohérentes et évolutives.
Chez Mailgun, nous avons mis plusieurs modèles d’emails responsifs à disposition via notre interface utilisateur. Ces fichiers HTML contiennent des blocs de code modulaires qui définissent l’apparence de vos emails.
Nous avons également publié des modèles open source sur GitHub pour couvrir vos besoins quotidiens en matière d’email. Il vous suffit d’y ajouter le contenu de votre email.
Mais que faire si vous possédez déjà un modèle ou si vous avez besoin de plus de personnalisation que nos designs prêts à l’emploi ? Vous pouvez désormais utiliser notre API des modèles pour importer vos propres modèles d’emails sur votre compte Mailgun.
Ci-dessous, nous verrons où trouver un modèle d’email, comment importer votre modèle dans Mailgun via l’API Templates, ainsi que quelques bonnes pratiques.
Quels sont les avantages des modèles d’emails ?
Les modèles d’emails sont des fichiers HTML contenant du code réutilisable qui facilite grandement la création de campagnes d’emailing. Au lieu d’écrire et de tester du nouveau code à chaque fois, il vous suffit de copier-coller du texte, des URL d’images et des liens dans un modèle existant pour produire une nouvelle campagne.
Les principaux avantages sont les suivants :
- Efficacité : ne réinventez pas la roue, collez simplement le contenu de votre email dans le modèle et le tour est joué.
- Cohérence : conservez une apparence fidèle à votre marque dans tous vos emails en utilisant le même code.
- Évolutivité : permettez aux membres de l’équipe non techniques de créer des campagnes d’emailing en réduisant la dépendance à l’équipe de développement pour concevoir les campagnes une par une.
En bref, les modèles d’emails font le plus gros du travail en créant de nouveaux formats d’emails pour vos campagnes.
Quels sont les différents types de modèles d’emails ?
Mais il existe de très nombreux modèles : comment savoir lequel vous convient le mieux ? Nous avons identifié ci-dessous trois principaux types de modèles d’emails, avec une brève description des besoins auxquels ils répondent :
- Les campagnes de masse sont des campagnes de marketing ponctuelles envoyées à la majeure partie de vos utilisateurs.
- Emails transactionnels sont des messages déclenchés par les actions des utilisateurs sur votre site, telles que la création d’un compte, un achat ou la demande d’un nouveau mot de passe.
- Newsletters sont des conversations récurrentes entre votre marque et vos abonnés. Envoyez ce type d’emails pour maintenir l’engagement de vos utilisateurs.
Où puis-je trouver des modèles d’emails ?
Si vous ne souhaitez pas importer vos propres modèles d’emails, voici une liste de modèles Mailgun gratuits :
- Faites votre choix parmi six modèles existants sur notre interface utilisateur.
- Créez un fork Des modèles d’emails transactionnels depuis notre dépôt GitHub.
- Découvrez les modèles HTML gratuits d’Email on Acid.
Vous pouvez utiliser nos modèles tels quels, ou vous en inspirer pour créer un nouveau modèle. Vous pourrez ensuite importer vos modèles sur votre compte Mailgun via l’API Templates.
Avant d’importer votre modèle d’email, vous devez avoir un compte Mailgun et un domaine vérifié dans notre système. De plus, notez que nous ne prenons actuellement en charge que le Handlebars moteur de modèles, un choix très répandu pour le design d’email.
Nous allons voir ci-dessous deux façons de stocker et d’initialiser un modèle. Ensuite, nous aborderons le contrôle de version de vos modèles et l’envoi d’emails de test pour vérifier que votre modèle est correctement stocké.
Notre API Templates fait partie de la puissante API Email de Mailgun. Vous pouvez accéder à notre API Templates au point de terminaison suivant : /templates. Consultez nos la documentation de référence de l’API Templates pour des informations plus détaillées.
Comment stocker et initialiser un modèle en même temps ?
Commençons par stocker votre modèle sur votre compte Mailgun.
Tout d’abord, essayons de stocker un modèle avec une version active initiale en envoyant une requête POST au point de terminaison de l’API Templates. Cela permet de stocker les métadonnées du modèle ainsi que son contenu.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description="template description" -F tag="v0"
-F template=”template contents”
Dans cette requête, les paramètres name, tag et template sont requis. Le paramètre name indique le nom du modèle, utilisé pour référencer le modèle dans d’autres appels d’API. Le paramètre tag permet d’identifier la version spécifique de ce modèle. Le contrôle de version est un atout pour les campagnes d’emailing, comme nous le verrons plus en détail ci-dessous. Le paramètre template spécifie le contenu du modèle en lui-même. Ici, vous pouvez coller le contenu HTML du modèle directement dans la requête.
Mais que faire si votre modèle est stocké sur votre disque local ? L’exemple de requête ci-dessous montre comment extraire le contenu du modèle à partir d’un fichier. Dans cet exemple, supposons que votre modèle est enregistré localement sous le nom billing.html.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description="template description" -F tag="v0"
-F template=<code data-enlighter-language="generic" class="EnlighterJSRAW">content from file billing.html</code>
Comme dans le premier exemple, cela nécessite les paramètres name, template et tag.
Comment stocker un modèle puis l’initialiser séparément ?
Il est également possible de stocker un modèle en deux étapes :
- Stocker les métadonnées d’un modèle.
- Stocker une version du modèle.
Lorsque vous stockez un modèle sans utiliser le paramètre tag pour ajouter un numéro de version ni le paramètre template pour fournir le contenu du modèle, vous enregistrez les métadonnées du modèle sur votre compte Mailgun. Votre modèle n’est pas encore actif à ce stade, mais il est conservé pour une utilisation ultérieure.
Pour rendre votre modèle actif, vous devez mettre à jour les métadonnées stockées en fournissant le contenu du modèle dans une autre requête. Cela créera la première version (v0) de votre modèle.
Stocker les métadonnées d’un modèle
Utilisez la requête suivante pour stocker les métadonnées d’un modèle sans l’initialiser.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description = "description of your template"
Le paramètre name est requis.
Stocker une version du modèle
Utilisez la requête suivante pour stocker une version d’un modèle après avoir créé un enregistrement de ses métadonnées. Supposons une fois de plus que le contenu du modèle soit stocké sur votre disque local sous le nom billing.html. Nous avons utilisé Python dans l’exemple ci-dessous.
import requests
content = None
with open("/path_to_file/billing.html", 'r') as f:
content = f.read()
requests.post("https://api/mailgiun.net/v3/example.com/templates/billing/versions",
auth=('api': "key"),
data={"tag": "v0",
"comment": "version comment",
"template": content})
Votre modèle est désormais actif, puisque vous avez fourni son contenu et son numéro de version.
Pourquoi faut-il créer des versions d’un modèle ?
Pour que votre modèle soit actif, il doit comporter au moins une version. La version initiale est nommée « v0 » dans le paramètre tag des exemples ci-dessus. Cependant, il est parfois utile de disposer de plusieurs versions d’un même modèle.
Par exemple, vous pouvez utiliser plusieurs versions pour :
- Fournir des informations ou des mises à jour produit.
- Mener des recherches sur l’expérience de votre audience concernant le texte, les éléments de design ou les appels à l’action.
- Adapter les emails pour répondre aux besoins évolutifs des campagnes.
N’oubliez pas que vous devez toujours avoir au moins une version active pour un modèle. Les emails utiliseront cette version active, sauf indication contraire. Par défaut, la version active correspond à la première version que vous stockez lors de l’import de votre modèle.
Comme illustré ci-dessous, vous pouvez mettre à jour la version active vers une nouvelle version avec une simple requête PUT en utilisant le point de terminaison de l’API Templates. Pour cet exemple, supposons qu’il existe deux versions de votre modèle (v0 et v1) et que la version v0 est actuellement active.
Et qu’en est-il de l’envoi ?
Maintenant que nous avons ajouté votre modèle à votre compte, utilisons l’API Messages de Mailgun pour envoyer un email de test. Nous pourrions nous contenter d’en afficher le rendu, mais envoyer un message de test vous permet de vérifier que vos informations variables fonctionnent comme prévu. Notez que vous devez vous assurer de joindre correctement vos données pour que les informations variables s’affichent correctement. La marche à suivre dépend de si vous envoyez via SMTP ou via l’API.
Envoyons un message de test avec une requête POST en utilisant des variables de destinataires dans un objet JSON. Nous utiliserons l’ API Messages de Mailgun pour y parvenir.
curl -X POST https://api.mailgun.net/v3/example.com/messages
-F template="billing"
-H "X-Mailgun-Variables: {"firstName": "John",
"lastName": "Doe",
"number": "12345",
"data":"Mar 01, 2019",
"amount1": "23.00",
"amount2": "10.20",
"total": "33.20"}"
Si vous avez correctement joint vos données, l’email de test devrait correspondre à votre rendu, avec les variables à la bonne place.
Comment envoyer une version spécifique d’un modèle ?
Nous avons vu à quel point la création de multiples versions d’un modèle d’email peut décupler l’efficacité de vos campagnes. Mais comment envoyer une version bien précise d’un modèle ?
Par défaut, les emails utilisent la version active de votre modèle. Cependant, il est très simple de configurer votre email pour envoyer une version spécifique qui n’est pas active. Utilisez les indicateurs suivants dans votre appel d’API : t:version et t:text.
curl -X POST https://api.mailgun.net/v3/example.com/messages
-F template="billing"
-F t:version="v1"
-F t:text="yes"
L’indicateur t:version précise la version de votre modèle à utiliser. Pour la paire clé-valeur t:text , passez la valeur yes pour afficher le rendu de votre modèle dans la partie texte de votre email.
Conclusion
Et c’est tout ! Nous avons réussi à stocker notre modèle sur notre compte Mailgun, à tester le contrôle de version et à envoyer des emails de test. Consultez notre documentation pour exploiter pleinement notre API Templates.
Si vous rencontrez des problèmes avec vos modèles, envoyez-nous un ticket au support ! Nous vous répondrons dans les plus brefs délais.
Vous vous sentez d’humeur créative ? Envoyez-nous vos designs de modèles ! Pour en savoir plus, consultez notre article de blog.
Comment bien démarrer avec l’API Templates ?