Mit der Brevo-Template-Sprache kannst du deine Nachrichten mit kontakt- oder ereignisspezifischen Daten personalisieren, Inhalte für bestimmte Empfänger:innen ausblenden oder anzeigen und die Formatierung von Werten anpassen.
💬 Variablen
Variablen, auch bekannt als Platzhalter oder Merge-Tags, sind Tags, die du in deine Nachrichten einfügen kannst, um sie zu personalisieren. Wenn du eine Nachricht versendest, wird jede Variable automatisch durch die Informationen des entsprechenden Kontakts ersetzt.
Variablen müssen in doppelte geschweifte Klammern eingeschlossen werden, wie {{ ... }} oder {{...}}. Sie können für einfache Einfügungen verwendet oder mit bedingten Anweisungen und Filtern für eine erweiterte Personalisierung kombiniert werden.
| Variablentyp | Anwendungsbeispiel |
|---|---|
| 👤 Kontakt-Variablen | Statische Kontakt-Attribute (Name, E-Mail…) |
| ⚡ Ereignisvariablen | Daten aus einer Trigger-Aktion |
| 🛢️ Datenfeed-Variablen | Echtzeitdaten aus einer externen Quelle |
| 🛒 Produkt-Feed-Variablen | Dynamische Artikellisten |
| 📦 Objektvariablen | Benutzerdefinierte Objektattribute |
| 📅 Datumsvariablen | Zeitstempel versenden |
| 🔗 E-Mail-Link- und Vorschauvariablen | Mirror-Links zum Anzeigen, Abmelden, Aktualisieren des Profils und zum Double-Opt-In |
👤 Kontakt-Variablen
| Verfügbar für: | ✅ SMS | ✅ Push |
Die Syntax lautet {{ contact.ATTRIBUTE }}, wobei du ATTRIBUTE durch den genauen Namen des Kontakt-Attributs ersetzen solltest, wie er auf der Seite Kontakt-Attribute angegeben ist. Es werden sowohl Standard- als auch benutzerdefinierte Attribute unterstützt.
Beispiele:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ contact.EMAIL }} | E-Mail-Adresse (Standard) | abby@the-green-yoga.com |
| {{ contact.FIRSTNAME }} | Vorname (Standard) | Abby |
| {{ contact.SMS }} | Telefonnummer (Standard) | +12152688872 |
| {{ contact.LANGUAGE }} | Sprache (benutzerdefiniert) | Englisch |
➡️ Weitere Informationen findest du in unseren speziellen Artikeln:
⚡ Ereignisvariablen
| Verfügbar für: | ✅ E-Mail (nur als Auslöser) |
✅ SMS (nur als Auslöser) |
✅ WhatsApp (nur Auslöser) |
✖️ Push |
Mit Ereignisvariablen kannst du Daten anzeigen, die aus bestimmten Ereignissen kommen, und durch die Aktionen eines Kontakts ausgelöst werden, wie zum Beispiel den Preis seines zuletzt gekauften Artikels oder den Namen des Meetings, das er gebucht hat.
Um die verfügbaren Variablen anzuzeigen, überprüfe deinen API Call oder die Ereignis-Logs in Brevo. Die nachstehenden Beispiele basieren auf der folgenden JSON-Struktur:
|
data ist das Stammobjekt, das die folgenden Eigenschaften enthält:
|
Das Stammobjekt (oben data) ist obligatorisch. Alle anderen Eigenschaften sind optional und können nach Bedarf benannt werden.
Je nachdem, wo deine Daten in der JSON-Struktur gespeichert sind, variiert die Syntax:
Daten, die direkt unter dem Root-Objekt gespeichert sind, enthalten in der Regel wichtige Ereignisdetails, wie zum Beispiel Informationen zum Warenkorb, und können abgerufen werden, ohne dass man die Arrays durchlaufen muss.
Die Syntax lautet {{ params.property }}, wobei du property durch den genauen Namen der Eigenschaft unter dem Stammobjekt in deiner JSON-Struktur ersetzen solltest.
Ausgehend von der obigen JSON-Struktur:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ params.id }} | Warenkorb-ID | Warenkorb:1234 |
| {{ params.total }} | Warenkorb gesamt | 280 |
| {{ params.currency }} | Warenkorb-Währung | USD |
| {{ params.url }} | Warenkorb-URL | https://www.example.com |
Arrays, die unter dem Stammobjekt gespeichert sind, wie beispielsweise das oben genannte items-Array, können mehrere Elemente enthalten, von denen jedes seine eigenen Eigenschaften hat. Verwende die Indizierung, um auf bestimmte Elemente zu verweisen, oder eine for-Schleife, um alle Elemente durchzugehen.
Verwende die Indizierung, um auf bestimmte Elemente zu verweisen
Die Syntax für die Indizierung lautet {{ params.array.index.property }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- array mit dem genauen Namen des Arrays unter dem Stammobjekt in deiner JSON-Struktur.
- index mit der Position des Elements, auf das du verweisen möchtest, beginnend bei 0 für das erste Element.
- property mit dem genauen Namen der Eigenschaft innerhalb des Array-Elements in deiner JSON-Struktur.
Ausgehend von der obigen JSON-Struktur:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ params.items.0.name }} | Name des ersten Artikels | Schwarze Schuhe |
| {{ params.items.1.name }} | Name des zweiten Artikels | Weißes Hemd |
Verwende eine for-Schleife, um alle Elemente durchzugehen
Die Syntax mit einer for-Schleife lautet {% for item in params.array %} {{ item.property }} {% endfor %}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- array mit dem genauen Namen des Arrays unter dem Stammobjekt in deiner JSON-Struktur.
- property mit dem genauen Namen der Eigenschaft innerhalb des Array-Elements in deiner JSON-Struktur.
Ausgehend von der obigen JSON-Struktur:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {% for item in params.items %} {{ item.name }} {% endfor %} | Alle Artikelnamen |
Schwarze Schuhe Weißes Hemd |
➡️ Weitere Informationen zu for-Schleifen findest du in unserem Artikel [Manual] Wiederholung eines Blocks von Elementen in deinen E-Mails mit for-Schleifen.
🛢️ Datenfeed-Variablen
| Verfügbar für: | ✅ SMS | ✖️ Push |
Mit Datenfeed-Variablen kannst du Echtzeitdaten aus einer externen Quelle oder API direkt in deine Nachrichten einbinden. Um die verfügbaren Variablen zu ermitteln, gehe zu Settings > Data management > Data feeds (Einstellungen > Datenverwaltung > Datenfeeds) und überprüfe die Struktur deiner Quelldatei:
Je nach Komplexität der Struktur deines Datenfeeds variiert das Format:
Daten, die direkt unter dem Stammobjekt gespeichert sind, enthalten in der Regel die relevanteste und aktuellste Entität in deinem Feed, wie zum Beispiel das nächste bevorstehende Ereignis oder der neueste Artikel, und können abgerufen werden, ohne dass man Arrays durchlaufen muss.
Die Syntax lautet {{ feed.feedalias.variable }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- feedalias durch den genauen Aliasnamen deines Datenfeeds, wobei du die Schreibweise und die Groß-/Kleinschreibung genau so übernehmen musst, wie sie auf der Seite Datenfeeds angegeben ist.
- variable mit dem spezifischen Variablen- oder Feldnamen, den du anzeigen möchtest.
Unter Berücksichtigung des obigen Datenfeeds:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ feed.next_yoga_class.class_name }} | Kursname | Sunrise Vinyasa |
| {{ feed.next_yoga_class.studio_location }} | Standort des Studios | Studio in der Innenstadt |
| {{ feed.next_yoga_class.date }} | Kursdatum | 7. März 2025 |
| {{ feed.next_yoga_class.time }} | Unterrichtszeit | 06:30 Uhr |
Arrays, die unter dem Root-Objekt gespeichert sind, können mehrere Elemente enthalten, von denen jedes seine eigenen Eigenschaften hat. Verwende die Indizierung, um auf bestimmte Elemente zu verweisen, oder eine for-Schleife, um alle Elemente durchzugehen.
Verwende die Indizierung, um auf bestimmte Elemente zu verweisen
Die Syntax für die Indizierung lautet {{ feed.feedalias.array.index.variable }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- feedalias durch den genauen Aliasnamen deines Datenfeeds, wobei du die Schreibweise und die Groß-/Kleinschreibung genau so übernehmen musst, wie sie auf der Seite Datenfeeds angegeben ist.
- array mit dem Namen des Arrays, das die Werte für jedes Element enthält.
- index mit der Position des gewünschten Elements, beginnend bei 0 für das erste Element.
- variable mit dem konkreten Variablen- oder Feldnamen, den du anzeigen möchtest, z. B. Name, Preis oder Datum.
Unter Berücksichtigung des obigen Datenfeeds:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ feed.yoga_classes.following_classes.0.class_name }} | Name des ersten Kurses | Power Flow Yoga |
| {{ feed.yoga_classes.following_classes.1.class_name }} | Name des zweiten Kurses | Evening Restorative |
Verwende eine for-Schleife, um alle Elemente durchzugehen
Die Syntax mit einer for-Schleife lautet {% for item in feed.feedalias.array %} {{ item.variable }} {% endfor %}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- feedalias durch den genauen Aliasnamen deines Datenfeeds, wobei du die Schreibweise und die Groß-/Kleinschreibung genau so übernehmen musst, wie sie auf der Seite Datenfeeds angegeben ist.
- array mit dem Namen des Arrays, das die Werte für jedes Element enthält.
- variable mit dem konkreten Variablen- oder Feldnamen, den du anzeigen möchtest, z. B. Name, Preis oder Datum.
Unter Berücksichtigung des obigen Datenfeeds:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes %} {{ item.class_name }} {% endfor %} | Alle Kursnamen |
Power Flow Yoga Evening Restorative Hatha Yoga Basics Yin Yoga & Meditation ... |
➡️ Weitere Informationen zu for-Schleifen findest du in unserem Artikel [Manual] Wiederholung eines Blocks von Elementen in deinen E-Mails mit for-Schleifen.
🛒 Produkt-Feed-Variablen
| Verfügbar für: | ✅ SMS | ✖️ Push |
Mit den Variablen Produkt-Feed kannst du eine dynamische Liste von Artikeln aus deinem Online-Shop anzeigen, einschließlich Details wie Name, Beschreibung, Preise, Bilder und Verfügbarkeit.
Die Syntax lautet {{ feed.feedalias.products.variable }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- feedalias mit dem genauen Namen deines Produkt-Feeds, wobei du die Schreibweise und die Groß-/Kleinschreibung so übernehmen musst, wie sie auf der Seite Produkt-Feeds angegeben ist.
- variable mit dem Feldnamen, den du anzeigen möchtest.
Unter Berücksichtigung des oben genannten Produkt-Feeds:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ feed.mats_bestseller.products.imageUrl }} | Artikelbild | |
| {{ feed.mats_bestseller.products.name }} | Artikelname | Rutschfeste Yogamatte – 6mm |
| {{ feed.mats_bestseller.products.url }} | Produkt-URL | https://thegreenyoga.com/non-slip/black-mat.html |
Verwende eine for-Schleife, um alle Elemente durchzugehen
Die Syntax mit einer for-Schleife lautet {% for item in feed.feedalias.products %} {{ item.variable }} {% endfor %}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- feedalias durch den genauen Aliasnamen deines Datenfeeds, wobei du die Schreibweise und die Groß-/Kleinschreibung genau so übernehmen musst, wie sie auf der Seite Datenfeeds angegeben ist.
- variable mit dem konkreten Variablen- oder Feldnamen, den du anzeigen möchtest, z. B. Name, Preis oder Datum.
Unter Berücksichtigung des oben genannten Produkt-Feeds:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
|
{% for item in feed.mats_bestseller.products %} {{ item.name }} {% endfor %} |
Alle Artikelnamen |
Rutschfeste Yogamatte – 6mm Yogablock – 4 Zoll Yogahose mit hoher Taille und weitem Bein |
➡️ Weitere Informationen zu for-Schleifen findest du in unserem Artikel [Manual] Wiederholung eines Blocks von Elementen in deinen E-Mails mit for-Schleifen.
📦 Objektvariablen
| Verfügbar für: | ✅ E-Mail (nur Automatisierung) |
✅ SMS (nur Automatisierung) |
✖️ Push |
Mit Objektvariablen kannst du Details zu deinen benutzerdefinierten Objekten oder den damit verbundenen Objekten in deine Nachrichten einfügen. Sie können nur in Automatisierungen verwendet werden, da sie darauf angewiesen sind, dass ein bestimmter Objekt-Datensatz als Trigger für die Automatisierung dient.
Um Objektvariablen zu erstellen, benötigst du den Objektnamen und die Attribut-IDs von der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte). Die Syntax hängt davon ab, welche Daten du anzeigen möchtest:
Mit Objektdatenvariablen kannst du Attribute aus dem Datensatz des benutzerdefinierten Objekts anzeigen, das die Automatisierung ausgelöst hat, wie zum Beispiel den Angebotsbetrag oder das Erstellungsdatum.
Die Syntax lautet {{ feed.object.attributes.variable }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- object mit dem Singularnamen deines benutzerdefinierten Objekts, wie du es bei der Erstellung definiert hast.
- variable mit der ID des Attributs, das du anzeigen möchtest, z. B. Name, Betrag oder Datum. Du kannst die Attribut-IDs finden, indem du auf der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte) auf den Objektnamen klickst.
Angenommen, du hast ein quote-Objekt mit den Attributen amount, date, id_quote und paid:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ feed.quote.attributes.amount }} | Angebotsbetrag | 350 |
| {{ feed.quote.attributes.date }} | Datum der Angebotserstellung | 2025-03-29T00:04:11+00:00 (29. März 2025, 00:04:11) |
| {{ feed.quote.attributes.paid }} | Zahlungsstatus | true |
| {{ feed.quote.attributes.id_quote }} | Angebots-ID | OQPPBDCSSZQ9 |
Mit zugehörigen Objektdatenvariablen kannst du Attribute von Objekten anzeigen, die mit dem benutzerdefinierten Objekt verknüpft sind, das als Trigger für die Automatisierung dient. Verwende die Indizierung, um auf bestimmte Datensätze zu verweisen, oder eine for-Schleife, um alle Datensätze durchzugehen.
Verwende die Indizierung, um auf bestimmte Elemente zu verweisen
Die Syntax für die Indizierung lautet {{ feed.object.associations.associatedobject.index.variable }}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- object mit dem Singularnamen deines benutzerdefinierten Objekts, wie du es bei der Erstellung definiert hast.
- associatedobject mit dem Namen im Singular deines verknüpften Objekts, den du auf der Registerkarte Associations (Zuordnungen) findest, wenn du auf der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte) ein benutzerdefiniertes Objekt auswählst.
- index mit der Position des verknüpften Eintrags, den du anzeigen möchtest, beginnend mit 0 für den ersten Datensatz.
- variable mit der ID des Attributs, das du anzeigen möchtest; diese findest du auf der Registerkarte Associations (Zuordnungen), wenn du auf der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte) ein benutzerdefiniertes Objekt auswählst.
Angenommen, es gibt ein quote-Objekt (Angebot), das mit vehicle-Datensätzen (Fahrzeug) verknüpft ist, die ein brand-Attribut (Marke) enthalten:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {{ feed.quote.associations.vehicle.0.brand }} | Erste Fahrzeugmarke | Renault |
| {{ feed.quote.associations.vehicle.1.brand }} | Zweite Fahrzeugmarke | Toyota |
Verwende eine for-Schleife, um alle Elemente durchzugehen
Die Syntax mit einer for-Schleife lautet {% for item in feed.object.associations.associatedobject %} {{ item.variable }} {% endfor %}, wobei du jeden Platzhalter wie folgt ersetzen solltest:
- object mit dem Singularnamen deines benutzerdefinierten Objekts, wie du es bei der Erstellung definiert hast.
- associatedobject mit dem Namen im Singular deines verknüpften Objekts, den du auf der Registerkarte Associations (Zuordnungen) findest, wenn du auf der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte) ein benutzerdefiniertes Objekt auswählst.
- variable mit der ID des Attributs, das du anzeigen möchtest; diese findest du auf der Registerkarte Associations (Zuordnungen), wenn du auf der Seite Custom objects settings (Einstellungen für benutzerdefinierte Objekte) ein benutzerdefiniertes Objekt auswählst.
Angenommen, es gibt ein quote-Objekt (Angebot), das mit vehicle-Datensätzen (Fahrzeug) verknüpft ist, die ein brand-Attribut (Marke) enthalten:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
|
{% for item in feed.quote.associations.vehicle %} {{ item.brand }} {% endfor %} |
Marke aller zugehörigen Fahrzeugdatensätze |
Renault Toyota Audi ... |
➡️ Weitere Informationen zu for-Schleifen findest du in unserem Artikel [Manual] Wiederholung eines Blocks von Elementen in deinen E-Mails mit for-Schleifen.
📅 Datumsvariablen
| Verfügbar für: | ✅ SMS | ✖️ Push |
Fügt einen Zeitstempel mit dem genauen Datum und der Uhrzeit des Versands der Nachricht ein, basierend auf der Zeitzone deines Brevo-Kontos. Wenn keine Zeitzone festgelegt ist, wird standardmäßig UTC verwendet.
Die Syntax lautet {{ time_now }}.
Beispiele:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| Heute ist der {{ time_now }} | Vollständiger Zeitstempel | Heute ist der 11.03.2025 15:10:20.823713502 +0100 CET |
| Heute ist der {{ time_now |date:"Monday, Jan 2, 2006" }} | Datum, formatiert mit dem Filter date | Heute ist Dienstag, der 11. März 2025 |
➡️ Weitere Informationen zur Anpassung der Formatierung von Datumsangaben findest du in unserem Artikel Formatierung von Platzhaltern mit Filtern ändern.
🔗 E-Mail-Link- und Vorschauvariablen
| Verfügbar für: | ✖️ SMS | ✖️ Push |
Füge diese Variablen in einen HTML-Tag <a> ein, damit die Empfänger:innen deine E-Mail im Browser anzeigen, sich abmelden oder ihre Einstellungen verwalten können.
Die folgenden E-Mail-Link- und Vorschauvariablen sind verfügbar:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| <a href="{{ mirror }}">Im Browser anzeigen</a> | Mirror-Link | Im Browser anzeigen |
| Wenn du dich abmelden möchtest, klicke hier: <a href="{{ unsubscribe }}">Abmelden</a> | Abmeldelink | Abmelden |
| <a href="{{ update_profile }}">Aktualisiere deine Einstellungen</a> | Link zum Profilaktualisieren | Aktualisiere deine Einstellungen |
| <a href="{{ doubleoptin }}">Ich bestätige meine Anmeldung</a> | Double-Opt-in-Link | Ich bestätige meine Anmeldung |
➡️ Weitere Informationen findest du in unseren speziellen Artikeln:
- Einfügen eines Links „Im Browser anzeigen“ in Ihre Kampagnen
- Einen Abmeldelink in deine Kampagnen einfügen
- Aktualisieren deiner Kontaktdaten und Einstellungen (Profilaktualisierungsformular)
- Erstellen eines benutzerdefinierten Double-Opt-In (DOI) E-Mail-Templates für ein in Brevo erstelltes Anmeldeformular
📢 Bedingte Anweisungen
| Verfügbar für: | ✖️ SMS | ✖️ Push |
Bedingte Anzeige (if-Anweisungen)
Verwende eine if-Anweisung, um Teile einer E-Mail je nach den Daten des/der jeweiligen Empfänger:in anzuzeigen oder auszublenden.
➡️ Weitere Informationen findest du in unserem speziellen Artikel [Manual] Inhalte in E-Mails mit if-Anweisungen ein- oder ausblenden.
Wiederholbare Bereiche (for-Schleifen)
Verwende eine for-Schleife, um alle Elemente eines Arrays dynamisch anzuzeigen, ohne jeden Index einzeln angeben zu müssen.
➡️ Weitere Informationen findest du in unserem Artikel [Manual] Wiederholung eines Blocks von Elementen in deinen E-Mails mit for-Schleifen.
🪄 Filter
| Verfügbar für: | ✅ SMS | ✖️ Push |
Filter verändern den Wert einer Variablen und werden in doppelte Klammern gesetzt, getrennt durch ein Pipe-Zeichen |. Es können mehrere Filter miteinander verkettet werden.
Beispiele:
| Eingabe | Beschreibung | Ausgabe |
|---|---|---|
| {% for item in feed.yoga_classes.following_classes|slice:'0:3' %} | Begrenzt die Anzahl der Elemente, die in einer for-Schleife angezeigt werden sollen |
Power Flow Yoga Evening Restorative Hatha Yoga Basics |
| {{ contact.FIRSTNAME|upper }} | Ändert den Vornamen des/der Empfänger:in in Großbuchstaben (ursprünglich: Abby). | ABBY |
| {{ params.TOTAL|floatformat:2 }} | Zeigt die Gesamtsumme des Warenkorbs mit zwei Nachkommastellen an (ursprünglich: 49,995). | 49,99 |
| {{ time_now|date:"02/01/2006" }} | Formatiert das aktuelle Datum wie folgt ( TT/MM/JJJJ ursprünglich: 2025-03-11 15:10:20.823713502 +0100 CET). | 11/03/2025 |
➡️ Weitere Informationen finden Sie in unserem Artikel Änderung der Formatierung Ihrer Platzhalter mit Filtern.
🤔 Sie haben eine Frage?
Wenden Sie sich bei Fragen an unser Support-Team: Erstellen Sie einfach ein Ticket über Ihr Konto. Wenn Sie noch kein Konto haben, können Sie uns hier kontaktieren.
Wenn Sie Unterstützung bei einem Projekt mit Brevo suchen, können wir Sie mit der richtigen zertifizierten Brevo-Partneragentur verbinden.