Mit Variablen (auch Personalisierungs-Tags oder Merge-Tags genannt) kannst du personalisierte Daten für alle Empfänger:innen einfügen, z. B. den Vornamen oder den letzten Einkauf. Filter ändern die Darstellung dieser Daten. 

Wie verwendet man Filter?

Du verwendest Filter innerhalb doppelter geschweifter Klammern {{ }} mit einer Pipe |. Beispiel:

Du kannst mehrere Filter verketten, sodass die Ausgabe eines Filters an den nächsten weitergegeben wird. Beispiel:

Um eine Variable mit Filtern in eine Nachricht einzufügen, kannst du Folgendes tun:

• Gib die Variable und die Filter manuell ein, oder

  

• Wähle eine bestehende Variable aus und bearbeite ihre Syntax auf der Registerkarte Advanced settings (Erweiterte Einstellungen).

  

💬 Einen Standardwert einfügen

default

Fügt einen Fallback-Wert ein, wenn eine Variable leer ist.

🔠 Groß- und Kleinschreibung

capfirst

Der erste Buchstabe wird groß geschrieben.

title

Der erste Buchstabe eines jeden Wortes wird groß geschrieben.

upper

Wandelt alle Buchstaben in Großbuchstaben um.

lower

Wandelt alle Buchstaben in Kleinbuchstaben um.

truncatechars

Verkürzt eine Zeichenkette auf N Zeichen. Verkürzte Werte enden mit einem Auslassungszeichen (...), das in der Zeichenzählung enthalten ist.

🔢 Zahlen formatieren

floatformat

Rundet die Werte von Float-Werten auf eine bestimmte Anzahl von Nachkommastellen.

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 entsprechend der Sprache.

📅 Datum und Uhrzeit formatieren

time_parse

Konvertiert einen Datumsstring in einen Standard-Zeitstempel, der mit anderen Filtern wie date oder date_i18n verwendet werden kann.

Wenn du dein Datumsformat als Argument übergibst, schreibe das Datum und die Uhrzeit genau so, wie die Referenzzeit aussehen würde, wenn sie der Wert wäre.

date

Konvertiert einen Zeitstempel oder ein geparstes Datum in ein bestimmtes Format. Verwende es mit einem Datum, das mit time_parse geparst wurde, oder mit der aktuellen Zeit mit time_now.

date_i18n

Konvertiert einen Zeitstempel oder ein geparstes Datum in ein bestimmtes Format, wobei die Ausgabe in einer bestimmten Sprache angezeigt wird. Dieser Filter funktioniert wie das Datum, aber du musst zuerst die Sprache und dann das Format angeben.

Die unterstützten Sprachen sind en, fr, it, es, de und pt.

time_add_date

Fügt Jahre, Monate und Tage zu einem Zeitstempel oder geparsten Datum hinzu. Du musst die hinzuzufügende Zeit in der Reihenfolge Jahr, Monat, Tag angeben.

time_in_location

Konvertiert einen Zeitstempel oder ein geparstes Datum in eine bestimmte Zeitzone. Du musst die Zeitzone im Format Ort/Zeitzone angeben.

time_add_duration

Fügt Stunden, Minuten und Sekunden zu einem Zeitstempel oder geparsten Datum hinzu. Du musst den Wert im Format h,m,s angeben und mindestens einen Wert (Stunde, Minute oder Sekunde) im Filter übergeben.

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, wobei 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, eines Mappings 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

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, verpacke den Inhalt in einen {% verbatim %}-Block:

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 die HTML-Wiedergabe zu ermöglichen, musst du das Auto-Escaping mit dem Tag {% autoescape off %} deaktivieren. Schließe die Variable in diesem Block ein und schließe ihn mit {% endautoescape %}:

{% 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.