[Manual] Personalisierung deiner Nachrichten mit dynamischen Inhalten (Brevo-Template-Sprache)

Dieser Artikel behandelt die manuelle Methode zum Einfügen von Variablen. Wenn du die Auswahl Variable auswählen in der Symbolleiste bevorzugst, überprüfe unseren Artikel Personalisierung deiner Nachrichten mit dynamischen Inhalten (Brevo-Template-Sprache).

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: ✅ E-Mail ✅ SMS ✅ WhatsApp ✅ 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:

email_event-variables_json-example_en-us.png

data ist das Stammobjekt, das die folgenden Eigenschaften enthält:

  • id → Warenkorb-ID
  • total → Der Gesamtbetrag im Warenkorb
  • currency → Die Währungsart
  • url → Warenkorb-URL
  • items ist ein Array von Artikeln im Warenkorb, die jeweils die folgenden Eigenschaften enthalten:
    • name → Name des Artikels
    • Preis → Preis des Artikels
    • url → URL der Artikel-Seite
    • image → URL des Produktbildes
💡 Gut zu wissen

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

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
↪️ Daten, auf die über ein Array unter dem Stammobjekt zugegriffen werden kann

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

💡 Gut zu wissen
Eine for-Schleife ist besonders nützlich, wenn die Anzahl der Elemente im Array unbekannt ist, wie zum Beispiel bei einer Liste wöchentlicher Blogbeiträge oder einem Beleg für gekaufte Artikel.

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: ✅ E-Mail ✅ SMS ✖️ WhatsApp ✖️ 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:

datafeed_valid-manually_en-us.png

Je nach Komplexität der Struktur deines Datenfeeds variiert das Format:

⏫ Daten, die direkt unter dem Root-Objekt gespeichert sind

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
↪️ Daten, auf die über ein Array unter dem Stammobjekt zugegriffen werden kann

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

💡 Gut zu wissen
Eine for-Schleife ist besonders nützlich, wenn die Anzahl der Elemente im Array unbekannt ist, wie zum Beispiel bei einer Liste wöchentlicher Blogbeiträge oder einem Beleg für gekaufte Artikel.

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: ✅ E-Mail ✅ SMS ✖️ WhatsApp ✖️ 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.

product-feed-example.png

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 black-yoga-mat.png
{{ 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

💡 Gut zu wissen
Das ist besonders nützlich, wenn die Anzahl der Artikel im Array nicht bekannt ist, z. B. bei einer Liste mit wöchentlichen Blogbeiträgen oder einer Quittung für gekaufte Artikel.

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)
✖️ WhatsApp ✖️ 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:

Objektdaten

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
Verknüpfte Objektdaten

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

💡 Gut zu wissen
Eine for-Schleife ist besonders nützlich, wenn die Anzahl der Elemente im Array unbekannt ist, wie zum Beispiel bei einer Liste wöchentlicher Blogbeiträge oder einem Beleg für gekaufte Artikel.

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:

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: ✅ E-Mail ✅ SMS ✖️ WhatsApp ✖️ 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: ✅ E-Mail ✖️ SMS ✖️ WhatsApp ✖️ 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:

📢 Bedingte Anweisungen

Verfügbar für: ✅ E-Mail ✖️ SMS ✖️ WhatsApp ✖️ 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: ✅ E-Mail ✅ SMS ✖️ WhatsApp ✖️ 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.

💬 War dieser Beitrag hilfreich?

25 von 162 fanden dies hilfreich