Product
Werden Sie mit unserer Vorlagen-API zum E-Mail-Profi
E-Mail-Vorlagen sind das Erfolgsgeheimnis für konsistente und skalierbare E-Mail-Kampagnen.
Bei Mailgun haben wir verschiedene responsive E-Mail-Vorlagen über unsere Nutzeroberfläche bereitgestellt. Diese HTML-Dateien enthalten modulare Code-Blöcke, die das Design Ihrer E-Mails definieren.
Außerdem haben wir Open-Source-Vorlagen auf GitHub veröffentlicht, um Ihren alltäglichen E-Mail-Bedarf zu decken. Sie müssen lediglich Ihre E-Mail-Inhalte hinzufügen.
Was aber, wenn Sie bereits eine Vorlage haben oder mehr Anpassungsmöglichkeiten benötigen, als unsere Plug-and-Play-Designs bieten? Nutzen Sie ab sofort unsere Vorlagen-API , um Ihre eigenen E-Mail-Vorlagen in Ihr Mailgun-Konto zu übertragen.
Im Folgenden besprechen wir, wo Sie eine E-Mail-Vorlage finden, wie Sie Ihre Vorlage über die Vorlagen-API zu Mailgun hochladen und welche Best Practices es gibt.
Vorteile von E-Mail-Vorlagen
E-Mail-Vorlagen sind HTML-Dateien mit wiederverwendbarem Code, die das Erstellen von E-Mail-Kampagnen zum Kinderspiel machen. Anstatt jedes Mal neuen Code zu schreiben und zu testen, kopieren Sie einfach Text, Bild-URLs und Links in eine bestehende Vorlage, um eine neue Kampagne zu erstellen.
Zu den wichtigsten Vorteilen gehören:
- Effizienz: Erfinden Sie das Rad nicht neu, sondern fügen Sie Ihre E-Mail-Inhalte einfach in die Vorlage ein und legen Sie los.
- Konsistenz: Behalten Sie durch die Verwendung desselben Codes in all Ihren E-Mails ein markenkonformes Design bei.
- Skalierbarkeit: Ermöglichen Sie nicht-technischen Teammitgliedern die Erstellung von E-Mail-Kampagnen, indem Sie die Abhängigkeit von Entwicklern verringern, die Kampagnen einzeln entwerfen müssen.
Kurz gesagt, E-Mail-Vorlagen nehmen Ihnen die meiste Arbeit bei der Erstellung neuer E-Mail-Formate für Ihre Kampagnen ab.
Arten von E-Mail-Vorlagen
Es gibt jedoch so viele Vorlagen – wie finden Sie die richtige? Im Folgenden haben wir drei Hauptarten von E-Mail-Vorlagen identifiziert und kurz beschrieben, für welche Zwecke sie sich eignen:
- E-Mail-Blasts sind einmalige Marketing-Kampagnen, die an die meisten Ihrer Nutzer gesendet werden.
- Transaktions-E-Mails sind Nachrichten, die durch Nutzeraktionen auf Ihrer Website ausgelöst werden, wie etwa die Erstellung eines Kontos, ein Kauf oder die Anforderung eines neuen Passworts.
- E-Mail-Newsletter sind wiederkehrende Interaktionen zwischen Ihrer Marke und Ihren Abonnenten. Versenden Sie solche E-Mails, um das Interesse Ihrer Nutzer aufrechtzuerhalten.
Wo Sie E-Mail-Vorlagen finden
Falls Sie keine eigenen E-Mail-Vorlagen hochladen möchten, finden Sie hier eine Liste kostenloser Mailgun-Vorlagen:
- Wählen Sie aus sechs bestehenden Vorlagen auf unserer Nutzeroberfläche.
- Erstellen Sie einen Fork Vorlagen für Transaktions-E-Mails aus unserem Github-Repository.
- Sehen Sie sich die kostenlosen HTML-Vorlagen bei Email on Acid an.
Nutzen Sie unsere Vorlagen unverändert oder als Inspiration für eine neue Vorlage. Anschließend laden Sie Ihre Vorlagen über die Vorlagen-API in Ihr Mailgun-Konto hoch.
Erste Schritte mit der Vorlagen-API
Bevor Sie Ihre E-Mail-Vorlage hochladen, benötigen Sie ein Mailgun-Konto und eine verifizierte Domain in unserem System. Bitte beachten Sie außerdem, dass wir derzeit nur die Handlebars Vorlagen-Engine unterstützen, die eine beliebte Wahl für E-Mail-Design ist.
Im Folgenden stellen wir zwei Möglichkeiten vor, eine Vorlage zu speichern und zu initialisieren. Anschließend gehen wir auf die Versionierung Ihrer Vorlagen und den Versand von Test-E-Mails ein, um zu prüfen, ob Ihre Vorlage korrekt gespeichert wurde.
Unsere Vorlagen-API ist Teil der leistungsstarken E-Mail-API von Mailgun. Auf unsere Vorlagen-API greifen Sie über den folgenden Endpunkt zu: /templates. Sehen Sie sich unsere API-Referenzdokumentation für die Vorlagen-API für detailliertere Informationen.
Eine Vorlage gleichzeitig speichern und initialisieren
Beginnen wir mit dem Speichern Ihrer Vorlage in Ihrem Mailgun-Konto.
Zunächst speichern wir eine Vorlage mit einer anfänglichen aktiven Version, indem wir eine POST-Anfrage an den Vorlagen-API-Endpunkt senden. Dadurch werden sowohl die Metadaten als auch der Inhalt der Vorlage gespeichert.
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”
Für diese Anfrage sind die Parameter name, tag und template erforderlich. Der Parameter name gibt den Vorlagennamen an, der verwendet wird, um in anderen API-Aufrufen auf die Vorlage zu verweisen. Der Parameter tag identifiziert die spezifische Version dieser Vorlage. Versionierung ist bei E-Mail-Kampagnen von Vorteil, worauf wir weiter unten näher eingehen. Der Parameter template gibt den Inhalt der Vorlage selbst an. Fügen Sie hier den HTML-Inhalt der Vorlage direkt in die Anfrage ein.
Was aber, wenn Ihre Vorlage auf Ihrer lokalen Festplatte gespeichert ist? Die folgende Beispielanfrage zeigt, wie die Vorlageninhalte aus einer Datei abgerufen werden. Nehmen wir für dieses Beispiel an, dass Ihre Vorlage lokal als billing.html gespeichert ist.
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>
Wie im ersten Beispiel erfordert dies die Parameter name, template und tag.
Eine Vorlage speichern und separat initialisieren
Alternativ speichern Sie eine Vorlage in zwei Schritten:
- Speichern Sie die Metadaten einer Vorlage.
- Speichern Sie eine Version der Vorlage.
Wenn Sie eine Vorlage speichern, ohne den Parameter tag zum Hinzufügen einer Versionsnummer oder den Parameter template zur Bereitstellung des Vorlageninhalts zu verwenden, erfassen Sie die Metadaten der Vorlage in Ihrem Mailgun-Konto. Ihre Vorlage ist zu diesem Zeitpunkt nicht aktiv, sondern wird für später gespeichert.
Damit Ihre Vorlage aktiv wird, müssen Sie die gespeicherten Vorlagen-Metadaten aktualisieren, indem Sie den Vorlageninhalt in einer weiteren Anfrage bereitstellen. Dadurch wird die erste Version, v0, Ihrer Vorlage erstellt.
Metadaten einer Vorlage speichern
Verwenden Sie die folgende Anfrage, um die Metadaten einer Vorlage ohne Initialisierung zu speichern.
curl -X POST https://api.mailgun.net/v3/example.com/templates
-F name="billing"
-F description = "description of your template"
Der Parameter name ist erforderlich.
Eine Version der Vorlage speichern
Verwenden Sie die folgende Anfrage, um eine Version einer Vorlage zu speichern, nachdem Sie einen Datensatz mit den Metadaten der Vorlage erstellt haben. Nehmen wir noch einmal an, dass der Inhalt der Vorlage lokal als billing.html gespeichert ist. Im folgenden Beispiel haben wir Python verwendet.
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})
Ihre Vorlage ist nun aktiv, da Sie den Inhalt und die Versionsnummer der Vorlage bereitgestellt haben.
Warum Versionen einer Vorlage erstellen?
Damit Ihre Vorlage aktiv ist, benötigen Sie mindestens eine Version. Die erste Version wird im Parameter tag der obigen Beispiele als „v0“ bezeichnet. Manchmal ist es jedoch hilfreich, mehrere Versionen einer Vorlage zu haben.
Sie nutzen mehrere Versionen beispielsweise für Folgendes:
- Um Informationen oder Produkt-Updates bereitzustellen.
- Um Untersuchungen der Nutzererfahrung zu Texten, Design-Elementen oder Call-to-Actions durchzuführen.
- Um E-Mails an sich ändernde Kampagnenanforderungen anzupassen.
Beachten Sie, dass stets eine aktive Version einer Vorlage vorhanden sein muss. E-Mails verwenden diese aktive Version, sofern nicht anders angegeben. Standardmäßig ist die aktive Version die erste Version, die Sie beim Hochladen Ihrer Vorlage speichern.
Wie unten gezeigt, aktualisieren Sie die aktive Version über den Vorlagen-API-Endpunkt mit einer einfachen PUT-Anfrage auf eine neue Version. Nehmen wir für dieses Beispiel an, dass es zwei Versionen Ihrer Vorlage gibt, v0 und v1, und dass v0 derzeit aktiv ist.
Infos zum Versand
Nachdem wir Ihre Vorlage zu Ihrem Konto hinzugefügt haben, senden wir nun eine Test-E-Mail über die Messages API von Mailgun. Wir könnten einfach eine Nachricht rendern, aber durch den Versand einer Testnachricht erkennen Sie, ob Ihre variablen Informationen wie vorgesehen funktionieren. Beachten Sie, dass Sie Ihre Daten korrekt anhängen müssen, damit die variablen Informationen funktionieren. Wie Sie dies tun, hängt davon ab, ob Sie über SMTP oder API versenden.
Senden wir eine Testnachricht mit einer POST-Anfrage und Empfängervariablen in einem JSON-Objekt. Hierfür verwenden wir die Messages API von Mailgun.
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"}"
Wenn Sie Ihre Daten richtig angehängt haben, sollte die Test-E-Mail Ihrer Vorschau mit den eingesetzten Variablen entsprechen.
Eine bestimmte Version einer Vorlage senden
Wir haben darüber gesprochen, wie die Erstellung mehrerer Versionen einer E-Mail-Vorlage Ihre Kampagne enorm verbessert. Aber wie senden Sie eine bestimmte Version einer Vorlage?
Standardmäßig verwenden E-Mails die aktive Version Ihrer Vorlage. Ihre E-Mail lässt sich jedoch ganz einfach so konfigurieren, dass eine bestimmte, nicht aktive Version gesendet wird. Verwenden Sie die folgenden Flags in Ihrem API-Aufruf: t:version und t:text.
curl -X POST https://api.mailgun.net/v3/example.com/messages
-F template="billing"
-F t:version="v1"
-F t:text="yes"
Das Flag t:version gibt an, welche Version Ihrer Vorlage verwendet werden soll. Übergeben Sie für das Schlüssel-Wert-Paar t:text den Wert yes, um Ihre Vorlage im Textteil Ihrer E-Mail zu rendern.
Zusammenfassung
Und das war’s. Wir haben unsere Vorlage erfolgreich in unserem Mailgun-Konto gespeichert, die Versionierung ausprobiert und Test-E-Mails versendet. Besuchen Sie unsere Dokumentation , um unsere Vorlagen-API optimal zu nutzen.
Falls Sie Probleme mit Ihren Vorlagen haben, senden Sie uns ein Support-Ticket. Wir melden uns so schnell wie möglich.
Haben Sie kreative Ideen? Senden Sie uns Ihre Vorlagendesigns. Lesen Sie mehr darüber in unserem Blogbeitrag.
