Vorlagen und E-Mail-Baukasten
Eine Vorlage ist eine fertige Nachricht für einen Kanal: E-Mail, Telegram-Nachricht, SMS, Web Push, Webhook und andere. Dieselbe Vorlage nutzen Journeys, Kampagnen und der manuelle Versand aus der Profilkarte. Variablen setzen den Namen des Kunden, den Bestellbetrag und andere Daten in den Text ein.
Den Bereich finden Sie im Menü Kommunikation → Vorlagen. Vorlagen ansehen können alle Rollen, anlegen und ändern können sie „Manager“ und höhere Rollen.
Vorlage anlegen
- Öffnen Sie Vorlagen. Oben rechts gibt es für jeden im Projekt aktivierten Kanal eine Schaltfläche, zum Beispiel E-Mail oder Telegram. Klicken Sie auf die gewünschte.
- Füllen Sie die allgemeinen Felder aus (Tabelle unten).
- Füllen Sie den Block Inhalt aus. Die Felder hängen vom Kanal ab. Bei einer E-Mail sind das Betreff, Preheader (Text neben dem Betreff in der E-Mail-Liste), E-Mail-Baukasten oder HTML sowie die Nur-Text-Version. Bleibt die Textversion leer, wird sie aus dem HTML erzeugt.
- Klicken Sie auf Speichern. Mit jedem Speichern steigt die Versionsnummer („Version 3“).
| Feld | Bedeutung |
|---|---|
| Name | Nur in der Oberfläche sichtbar: in den Listen der Vorlagen, Journeys und Kampagnen |
| Kanal | Wird beim Anlegen gewählt und lässt sich danach nicht ändern |
| Abo-Thema | Zum Beispiel marketing oder news. Der Kunde kann sich nur von diesem Thema abmelden |
| Transaktionale Nachricht | Wird ohne Prüfung von Abonnement, Frequenz und Ruhezeiten gesendet, aber nicht über einen beim Empfänger geschlossenen Kanal: Das Postfach oder die Nummer existiert nicht, der Bot ist blockiert. Nur für Bestellbestätigungen, Passwort-Zurücksetzungen und ähnliche Nachrichten verwenden, siehe Transaktionale Nachrichten und Kaskaden |
Um eine Vorlage zu löschen, klicken Sie in ihrer Zeile in der Liste auf das Papierkorbsymbol.
Variablen
Vorlagen werden in Twig geschrieben. Eine Variable steht in doppelten geschweiften Klammern. Die vollständige Liste mit Beispielen sehen Sie, wenn Sie den Block Variablen unter dem Inhalt aufklappen.
| Variable | Was eingesetzt wird |
|---|---|
profile.email, profile.phone, profile.user_id |
Kennungen des Kunden |
traits.first_name und andere traits.* |
Profilmerkmale |
event.name, event.properties.amount |
Das Ereignis, das die Nachricht ausgelöst hat |
context.data.*, context.nodes.* |
Journey-Daten: beim Eintritt über die API übergeben und die Antwort des Knotens „Webhook“ |
project.name, unsubscribe_url |
Projektname und Abmeldelink |
loyalty.points, loyalty.tier, loyalty.expiring, loyalty.expire_at, loyalty.referral_url |
Konto im Treueprogramm: Guthaben, Stufe, verfallende Punkte und deren Datum, Einladungslink |
promo_code('welcome') |
Gutscheincode des Kunden aus dem Pool welcome: wird beim Versand vergeben, in der Vorschau erscheint ein Muster |
order.number, order.amount, order.tracking_url |
Bestellung der Shop-E-Mail: Nummer, Betrag, Link zur Sendungsverfolgung; Betrag mit Währung – {{ order.amount|money(order.currency) }} |
product('SKU-1') |
Katalogprodukt in der Sprache der E-Mail: name, url, image, price, old_price, currency, available, stock – zum Zeitpunkt des Versands (Preise und Verfügbarkeit von Produkten) |
Hallo {{ traits.first_name|default('liebe Kundin, lieber Kunde') }}!
{% if event.properties.amount > 5000 %}Der Versand ist kostenlos.{% endif %}
Vorlagen laufen in einer sicheren Sandbox. Dort gibt es Bedingungen if, Schleifen for, set, die Funktionen date, min, max und die Filter default, date, upper, lower, capitalize, number_format, round, join, replace, striptags und weitere. Fehlt eine Variable, wird eine leere Zeichenkette eingesetzt; legen Sie für wichtige Stellen daher default fest. Verwenden Sie ein unzulässiges Konstrukt, erscheint beim Speichern der Fehler „Die Vorlage verwendet ein unzulässiges Konstrukt“. Die fertige Nachricht darf nicht größer als 512 KB sein.
Vorschau und Testversand
- Geben Sie im Bereich Vorschau eine Profil-ID, E-Mail-Adresse oder user_id ein und klicken Sie auf das Augensymbol. Bleibt das Feld leer, werden die Daten des zuletzt aktiven Profils verwendet.
- Wechseln Sie bei E-Mails zwischen den Modi Desktop, Telefon und Dunkelmodus.
- Wählen Sie im Bereich Testversand eine Integration. Geben Sie Ihre Adresse oder Chat-ID an, sonst geht die Nachricht an die Adresse des Profils. Klicken Sie auf Test senden: Unter der Schaltfläche erscheint der Nachrichtenstatus.
Der Testversand steht ab der Rolle „Manager“ zur Verfügung. Abonnement, Frequenz und Ruhezeiten werden dabei nicht geprüft. In der Vorschau gibt es kein auslösendes Ereignis, daher bleiben die Variablen event.* leer. Haben Sie keine Berechtigung für personenbezogene Daten, werden E-Mail-Adresse und Telefonnummer maskiert.
Sprachversionen
Eine Vorlage kann Versionen in mehreren Sprachen enthalten. Alle Empfänger erhalten die Version in der Sprache ihres Profils (Merkmal language), gibt es sie nicht, die Hauptversion. Die verfügbaren Sprachen legen Sie in den Projekteinstellungen fest.
- Klicken Sie über dem Block Inhalt auf Sprache hinzufügen und wählen Sie eine Sprache. Die neue Version beginnt als Kopie der geöffneten: Gestaltung, Bilder und Links sind schon da, Sie übersetzen nur die Texte.
- Wechseln Sie mit den Sprachschaltflächen zwischen den Versionen. Die Hauptversion ist mit „Hauptsprache“ gekennzeichnet.
- Damit Empfänger ohne eigene Version eine andere Sprache erhalten, öffnen Sie deren Version und klicken Sie auf Als Hauptsprache festlegen. Version löschen entfernt die geöffnete Version.
- Klicken Sie auf Speichern. Jede Version wird einzeln geprüft; eine Version mit Fehlern ist mit einem Warnsymbol markiert.
Übersetzungsentwurf
Damit Sie eine Version nicht von Hand von Grund auf übersetzen müssen, öffnen Sie sie und klicken Sie auf Übersetzungsentwurf. OneTrace.ru übersetzt die Hauptversion in die Sprache des geöffneten Tabs: Betreff, Preheader, Texte der Baukasten-Blöcke, Textversion sowie die Texte von SMS, Push und Messengern. Variablen wie {{ traits.first_name }}, Links, Bilder und Gestaltung bleiben unverändert.
Der Entwurf wird nur in das Formular eingetragen. Lesen Sie ihn durch, passen Sie die Formulierungen an und klicken Sie auf Speichern. Lässt sich ein Feld nicht ohne Verlust der Variablen übersetzen, bleibt es in der Ausgangssprache, und OneTrace.ru zeigt, wie viele solcher Felder es sind. Unterscheidet sich die Version bereits von der Hauptversion, erscheint vor dem Ersetzen eine Rückfrage.
Die Anzahl der Entwürfe pro Monat ist durch den Tarif begrenzt – siehe Tarife. Die Schaltfläche fehlt, wenn die Übersetzung in Ihrer Installation nicht eingerichtet ist.
Die Version wird so gewählt: zuerst die genau passende Sprache, dann die Sprache ohne Region (Kunden mit pt-BR erhalten die Version pt), dann eine andere Variante derselben Sprache. Vorschau und Testversand zeigen die geöffnete Version, die Variable {{ language }} enthält die Sprache der gesendeten Version.
E-Mail-Baukasten
Klicken Sie in einer E-Mail-Vorlage im Feld „E-Mail-Baukasten“ auf Baukasten öffnen. Enthält die Vorlage bereits HTML, beginnt der Baukasten die E-Mail neu, und der alte Code wird beim Speichern ersetzt. Den Code für E-Mail-Programme, einschließlich Outlook und Smartphones, erzeugt OneTrace.ru beim Speichern selbst.
Rechts neben der Arbeitsfläche gibt es drei Tabs:
- Blöcke – einen Block hinzufügen. Er wird nach dem ausgewählten Block oder am Ende der E-Mail vor der Fußzeile eingefügt.
- Block – Einstellungen des auf der Arbeitsfläche ausgewählten Blocks. Blöcke lassen sich nach oben und unten verschieben, ziehen, duplizieren und löschen.
- E-Mail – Hintergrund, E-Mail-Hintergrund, Text- und Linkfarben, Schrift, E-Mail-Breite (480–800 px), Innenabstand und die Art der Bildeinbindung.
| Block | Zweck |
|---|---|
| Überschrift, Text | Text mit Formatierung und Variablen, zum Beispiel {{ traits.first_name }} |
| Bild | Bild aus der Mediathek: Alternativtext, Link, Breite 10–100 % |
| Button | Text, Link, Farben und Eckenradius |
| Trennlinie, Abstand | Linie und Leerraum |
| Spalten | 2–3 Spalten mit Überschriften, Text, Bildern, Buttons und Abständen. Auf Smartphones werden die Spalten untereinander angeordnet |
| Produkte | Auswahl aus den Empfehlungen: Persönlich, Beliebt, „Zusammen angesehen“, „Ähnlich“ usw. Sie können 1 bis 12 Produkte in 1–4 Spalten anzeigen, mit Preis und Schaltfläche. Gibt es keine passenden Produkte, erscheint der Block nicht in der E-Mail |
| Bestellung | Bestellung aus der Shop-E-Mail: Artikel, Beträge, Sendungsverfolgung und Adressen. In E-Mails ohne Bestellung gibt es den Block nicht |
| HTML | Eigener Code unverändert |
| Fußzeile | Text und Abmeldelink |
Die Schaltfläche Zu HTML wechseln auf dem Tab „E-Mail“ wandelt die E-Mail in gewöhnlichen Code um. Danach können Sie nicht mehr zum Baukasten zurückkehren.
Link oder Anhang
| Link (CDN) | Als Anhang | |
|---|---|---|
| Größe der E-Mail | Klein | Größer um die Bildgröße |
| Anzeige | Das Bild wird beim Öffnen geladen. Blockiert das E-Mail-Programm Bilder, ist nur der Alternativtext sichtbar | Das Bild ist sofort sichtbar |
Die Standardeinstellung legen Sie im Feld Standard für Bilder auf dem Tab „E-Mail“ fest. Für ein einzelnes Bild ändern Sie sie im Feld Einbindung. Alle Anhänge einer E-Mail zusammen dürfen höchstens 1 MB groß sein. Sind in der Installation keine öffentlichen Links eingerichtet, stehen nur Anhänge zur Verfügung.
Fertige E-Mail importieren
Ist die E-Mail bereits in einem anderen Dienst gestaltet, müssen Sie sie nicht neu aufbauen. Klicken Sie auf der Seite Vorlagen auf E-Mail importieren (KI):
- Wählen Sie Datei und laden Sie eine aus Ihrem Mailprogramm gespeicherte E-Mail (
.eml) oder eine.html-Seite hoch. Oder wählen Sie HTML-Code und fügen Sie den Code der E-Mail ein. - Klicken Sie auf Importieren. Die KI braucht meist bis zu einer Minute.
- Der Editor öffnet sich mit einer neuen E-Mail-Vorlage: Die E-Mail ist in Baukastenblöcke zerlegt, die Bilder sind in die Mediathek kopiert, der Name des Empfängers ist durch die Variable
{{ traits.first_name }}ersetzt und der Abmeldelink steht im Block „Fußzeile“. Texte und Links bleiben wie in der E-Mail. - Prüfen Sie die Vorlage und klicken Sie auf Speichern. Vor dem Speichern gibt es die Vorlage noch nicht.
Konnte ein Teil der E-Mail nicht übernommen werden, erscheint über dem Formular eine Liste: welche Bilder nicht kopiert oder welche Blöcke übersprungen wurden. Lässt sich die E-Mail nicht in Blöcke zerlegen, wird sie als ein HTML-Block übernommen. Zählpixel und der Link „Im Browser öffnen“ werden nicht übernommen.
Der Import ist in den Tarifen „Wachstum“ und „Enterprise“ verfügbar; die Zahl der Importe pro Monat hängt vom Tarif ab – siehe Tarife. Im Tarif „Start“ zeigt die Schaltfläche, ab welchem Tarif die Funktion verfügbar ist.
Mediathek
Die Mediathek öffnet sich, wenn Sie einen Block „Bild“ hinzufügen oder auf Bild auswählen klicken.
- Hochladen akzeptiert JPEG, PNG, GIF, WebP und AVIF bis 10 MB. Breite Bilder werden auf 1200 px verkleinert. WebP und AVIF werden umkodiert, weil nicht alle E-Mail-Programme sie anzeigen. GIF bleibt unverändert, einschließlich Animation.
- Laden Sie dieselbe Datei erneut hoch, entsteht keine Kopie.
- Ein Bild, das in einer Vorlage verwendet wird, lässt sich erst löschen, wenn Sie es aus der Vorlage entfernt haben.
- Der von Bildern belegte Speicher zählt zum Limit des Tarifs.
