Mit Variablen, auch bekannt als Personalisierungs- oder Merge-Tags, kannst du personalisierte Daten für alle Empfänger:innen einfügen, z. B. den Vornamen oder den zuletzt getätigten Einkauf. Filter ermöglichen es dir, die Darstellung dieser Daten zu steuern, indem du ihr Format oder ihren Inhalt anpasst.

Was sind Filter?

Filter verändern die Ausgabe von Variablen. Sie werden innerhalb von doppelten geschweiften Klammern {{ }} verwendet und sind durch einen senkrechten Strich | von der Variable getrennt. Beispielsweise wird mit {{ contact.FIRSTNAME|upper }} der Name des Kontakts in Großbuchstaben angezeigt.

Du kannst auch mehrere Filter verketten, d. h. die Ausgabe eines Filters wird an den nächsten weitergegeben.

Um einen Filter in einer E-Mail-Kampagne oder einem Template zu verwenden, musst du ihn manuell zu der Variablen hinzufügen. Das bedeutet, dass du die gesamte Variable selbst erstellen musst. Im Drag & Drop-Editor erscheint die Variable dann als Tag, ohne den Filter.

💬 Einen Standardwert einfügen

default

Fügt einen Standard-Fallback-Wert ein, wenn der Variablenwert leer ist.

🔠 Groß- und Kleinschreibung

capfirst

Der erste Buchstabe eines Variablenwerts wird groß geschrieben.

title

Gibt eine titelgebende Version eines Variablenwerts zurück. Die Wörter beginnen mit Großbuchstaben, alle anderen Zeichen werden klein geschrieben.

upper

Jedes Zeichen eines Variablenwerts wird großgeschrieben.

lower

Jedes Zeichen eines Variablenwerts wird kleingeschrieben.

truncatechars

Kürzt einen Variablenwert, wenn er länger als die angegebene Anzahl von Zeichen ist. Verkürzte Werte enden mit einem Auslassungszeichen (...), das in der Zeichenzählung enthalten ist.

🔢 Zahlen formatieren

floatformat

Rundet die Ausgabe der Float-Werte deiner Variablen auf die angegebene Nachkommastelle.

Damit sie richtig funktionieren, sollten die Werte als Zahl und nicht als Zeichenkette weitergeben werden, und sie sollten nicht in Anführungszeichen als „Wert“ weitergeben werden.

integer

Konvertiert eine Zahl im String- oder Gleitkommaformat in eine Ganzzahl.

float

Konvertiert eine Zahl im String- oder Integer-Format in eine Gleitkommazahl.

lang_format

Formatiert Zahlen abhängig von der Sprache des Empfängers.

📅 Datum und Uhrzeit formatieren

time_parse

Wandelt Ihr Datumsformat (als String übermittelt) in ein Standarddatumsformat um, das mit anderen Filtern verwendet werden kann.

Um Ihr aktuelles Datumsformat als Argument zu übermitteln, formatieren Sie das genaue Datum / die genaue Uhrzeit so, wie die Referenzzeit angezeigt würde, wenn sie der Wert wäre.

date

Konvertiert ein Datum in ein angegebenes Format.

Du erhältst ein Datum aus einer Zeichenkette, indem du den time_parse-Filter verwendest oder die aktuelle Zeit, indem du das Filterdatum an die Variable time_now übergibst.

date_i18n

Konvertiert ein Datum in ein bestimmtes Format, die Ausgabe erfolgt jedoch in anderen Sprachen.

Derzeit werden folgende Sprachen unterstützt: en, fr, it, es, de und pt. Dieser Filter ähnelt dem Datumsfilter. Der einzige Unterschied besteht darin, dass zuerst die Sprache und dann das Format im Filter angegeben werden muss.

time_add_date

Fügt eine Anzahl von Tagen zu einem Zeitstempel oder einer Datumszeichenfolge hinzu. Es ist zwingend erforderlich, alle Werte in der folgenden Reihenfolge an diesen Filter zu übergeben: „Jahr, Monat, Tag“.

time_in_location

Konvertiert einen Zeitstempel oder eine Datumszeichenfolge entsprechend der dem Filter übermittelten Zeitzone. Es ist zwingend erforderlich, dem Filter eine Zeitzone im folgenden Format zu übergeben: „Ort/Zeitzone“.

time_add_duration

Fügt die Zeitdauer zu einem Zeitstempel oder einer Datumszeichenfolge hinzu. Es ist zwingend erforderlich, dass du mindestens einen Wert (Stunde, Minute oder Sekunde) in dem Filter angibst.

time_unix

Konvertiert einen Zeitstempel zum Unix Timestamp in Sekunden.

time_unix_nano

Konvertiert einen Zeitwert in den Unix Timestamp in Nanosekunden.

🧑‍💻 Daten codieren oder verschlüsseln

base64_encode oder decode

Codiert oder decodiert base 64:

• base64_decode decodiert einen String zu einem []Byte
• base64_decode codiert ein Byte zu einem []String

Die Filter base64_encode und base64_decode können einen optionalen Codierungsparameter verwenden:

• std: normale base64-Codierung,
• raw_std: normale base64-Codierung ohne die Füllzeichen =,
• url: sichere Version der base64-Codierung für URL, + und / werden mit - und _ ersetzt,
• raw_url: eine Kombination aus raw und url.

aes_128, 192, oder 256

Verschlüsselt einen Wert. Sie können diesen Filter verwenden, um verschlüsselte Kontaktinformationen wie beispielsweise eine E-Mail-Adresse oder eine ID in einer URL zu versenden.

Die verwendete AES-Variante hängt von der Länge des bereitgestellten Schlüssels ab:

Beispielsweise muss die Variable für die AES-256-Variante als {{ contact.ATTRIBUTE | aes_256:"key" }} formatiert werden. Dabei ist der Schlüssel:

• Aus 32 Zahlen bestehen
• Zufällig generiert werden
• Auf Ihrer Seite fortbestehen, damit der Originalwert entschlüsselt werden kann

Wenn kein Codierungsparameter definiert wird, wird standardmäßig base64 std verwendet. Andernfalls wird Folgendes unterstützt:

• raw_std: normale base64-Codierung ohne die Füllzeichen =,
• url: sichere Version der base64-Codierung für URL, + und / werden mit - und _ ersetzt,
• raw_url: eine Kombination aus raw und url.

🔎 Andere Filter

first

Gibt das erste Element einer Sequenz, einer Zuordnung oder einer Zeichenkette zurück.

join

Kombiniert die Elemente in einem Datenfeld zu einem einzigen String, wobei das Argument als Trennzeichen verwendet wird.

Das Trennzeichen zwischen den Elementen ist standardmäßig leer. Du kannst es mit dem optionalen ersten Parameter definieren.

last

Gibt das letzte Element einer Sequenz, eines Mappings oder eines Strings wieder.

length

Gibt die Anzahl der Elemente einer Sequenz, eines Mappings oder die Länge eines Strings wieder.

safe

Kennzeichnet eine Zeichenfolge so, dass kein weiteres HTML-Escaping vor der Ausgabe erforderlich ist.

Ohne den Filter "safe" würde das HTML-Tag in der E-Mail des Empfängers als normaler String angezeigt: "<p>This is my test sentence</p>" oder "Welcome to <b>Brevo</b>, we're glad to have you here".

Slice (Ausschnitt)

Extrahiert ein Stück aus einer Sequenz, eines Mappings oder eines Strings.

Dieser Filter kann konfiguriert werden, um:

Denken Sie in jedem Beispiel daran, dass Ihr Array Folgendes enthält: ["a","b","c","d","e","f","g","h"...].

verbatim

In Brevo werden Variablen mit doppelten geschweiften Klammern wie {{ params.property }} geschrieben. Wenn du doppelte geschweifte Klammern wie {{ this }} in deine E-Mail einfügst, behandelt Brevo sie als Template-Element.

Um {{ }} als reinen Text in deiner E-Mail anzuzeigen, gibst du den Inhalt in einen {% verbatim %} Block ein:

autoescape

Standardmäßig bricht Brevo alle variablen Inhalte, einschließlich HTML und JavaScript, ab. Das bedeutet, dass, wenn deine Variable HTML enthält (z.B. <h1>Mein Titel</h1>), wird sie als reiner Text angezeigt und nicht als HTML gerendert.

Um das Rendering von HTML zu ermöglichen, musst du das Auto-Escaping mit dem {% autoescape off %}-Tag deaktivieren. Umfasse die Variable in diesem Block und schließe sie mit {% endautoescape %} ab:

{% autoescape off %}{{ params.my_html }}{% endautoescape %}

📖 Zusätzliche Ressourcen

Die Brevo Template Language basiert auf Pongo2, einer Re-Implementierung von Django in Go (einer Programmiersprache).

Alle unterstützten Tags

autoescape, comment, cycle, filter, firstof, for, if, ifchanged, now, set, spaceless, templatetag, with.

Alle unterstützten Filter

escape, safe, escapejs, add, addslashes, capfirst, center, cut, date, default, default_if_none, divisibleby, first, floatformat, get_digit, iriencode, join, last, length, length_is, linebreaks, linebreaksbr, linenumbers, ljust, lower, make_list, phone2numeric, pluralize, random, removetags, rjust, slice, stringformat, striptags, time, title, truncatechars, truncatechars_html, truncatewords, truncatewords_html, upper, urlencode, urlize, urlizetrunc, wordcount, wordwrap, yesno.

Alle unterstützten Filter für Hash-Funktionen

hash_md5, hash_sha256, hash_sha256_224, hash_sha512, hash_sha512_224, hash_sha512_256, hash_sha512_384, hash_sha3_224, hash_sha3_256, hash_sha3_384, hash_sha3_512.

🤔 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.