Kontextvariablen

Kontextvariablen sind temporäre Daten, die Sie innerhalb der Journey von Nutzer:innen durch ein bestimmtes Canvas erstellen und verwenden können. Sie ermöglichen es Ihnen, Verzögerungen zu personalisieren, Nutzer:innen dynamisch zu segmentieren und Nachrichten anzureichern, ohne die Profilinformationen von Nutzer:innen dauerhaft zu verändern. Kontextvariablen existieren nur innerhalb der Canvas-Sitzung und bleiben nicht über verschiedene Canvases hinweg oder außerhalb der Sitzung bestehen.

Funktionsweise von Kontextvariablen

Kontextvariablen können auf zwei Arten festgelegt werden:

• Beim Canvas-Entry: Wenn Nutzer:innen einen Canvas betreten, können Daten aus dem Event oder dem API-Trigger automatisch Kontextvariablen befüllen.
• In einem Kontextschritt: Sie können Kontextvariablen manuell innerhalb des Canvas definieren oder aktualisieren, indem Sie einen Kontextschritt hinzufügen.

Jede Kontextvariable umfasst:

• Einen Namen (z. B. flight_time oder subscription_renewal_date)
• Einen Datentyp (z. B. Zahl, String, Zeit oder Array)
• Einen Wert, den Sie mit Liquid oder über das Tool Personalisierung hinzufügen zuweisen.

Nach der Definition können Sie eine Kontextvariable im gesamten Canvas verwenden, indem Sie sie in diesem Format referenzieren: {{context.${example_variable_name}}}.

Zum Beispiel könnte {{context.${flight_time}}} die geplante Abflugzeit der Nutzer:innen zurückgeben.

Jedes Mal, wenn Nutzer:innen den Canvas betreten – auch wenn sie ihn bereits zuvor betreten haben – werden die Kontextvariablen basierend auf den neuesten Entry-Daten und der Canvas-Konfiguration neu definiert. Dieser zustandsbehaftete Ansatz ermöglicht es jedem Canvas-Entry, seinen eigenen unabhängigen Kontext beizubehalten, sodass Nutzer:innen mehrere aktive Zustände innerhalb derselben Journey haben können, während der spezifische Kontext für jeden Zustand erhalten bleibt.

Wenn beispielsweise eine Kund:in zwei bevorstehende Flüge hat, laufen zwei separate Journey-Zustände gleichzeitig – jeder mit seinen eigenen flugspezifischen Kontextvariablen wie Abflugzeit und Zielort. So können Sie personalisierte Erinnerungen für den 14-Uhr-Flug nach New York senden und gleichzeitig andere Updates für den 8-Uhr-Flug nach Los Angeles am nächsten Tag verschicken, sodass jede Nachricht für die jeweilige Buchung relevant bleibt.

Überlegungen

Sie können bis zu 10 Kontextvariablen pro Kontextschritt definieren. Jeder Variablenname kann bis zu 100 Zeichen lang sein und darf nur Buchstaben, Zahlen oder Unterstriche enthalten.

Kontextvariablen-Definitionen können bis zu 10.240 Zeichen umfassen. Wenn Sie Kontextvariablen in ein API-getriggertes Canvas übergeben, teilen sie sich denselben Namespace wie Variablen, die in einem Kontextschritt erstellt wurden. Wenn Sie beispielsweise eine Variable purchased_item im Kontextobjekt des /canvas/trigger/send-Endpunkts senden, können Sie darauf als {{context.${purchased_item}}} verweisen. Wenn Sie diese Variable in einem Kontextschritt neu definieren, überschreibt der neue Wert den API-Wert für die Journey dieser Nutzer:innen.

Sie können bis zu 50 KB pro Kontextschritt speichern, verteilt auf bis zu 10 Variablen. Wenn die Gesamtgröße aller Variablen in einem Schritt 50 KB überschreitet, werden alle Variablen, die das Limit überschreiten, nicht ausgewertet oder gespeichert. Wenn Sie beispielsweise drei Variablen in einem Kontextschritt haben:

• Variable 1: 30 KB
• Variable 2: 19 KB
• Variable 3: 2 KB

Variable 3 wird nicht ausgewertet oder gespeichert, da die Summe der vorherigen Variablen 50 KB überschreitet.

Datentypen

Kontextvariablen, die im Schritt erstellt oder aktualisiert werden, können die folgenden Datentypen zugewiesen werden.

Hinweis

Kontextvariablen haben dieselben erwarteten Formate für Datentypen wie Event-Eigenschaften.

Bei Verwendung des Array-Typs versucht Braze, den Wert als JSON zu parsen, sodass Arrays von Objekten erfolgreich erstellt werden können. Wenn die Objekte in Ihren Arrays kein gültiges JSON sind, ist das Ergebnis ein einfaches String-Array.

Für verschachtelte Objekte und Arrays von Objekten verwenden Sie den as_json_string-Liquid-Filter. Wenn Sie dasselbe Objekt in einem Kontextschritt erstellen, müssen Sie das Objekt mit as_json_string rendern, z. B. {{context.${object_array} | as_json_string }}

Standardmäßig ist der Datentyp „Zeit“ in UTC angegeben. Wenn Sie einen String-Datentyp verwenden, um einen Zeitwert zu speichern, können Sie die Zeit in einer anderen Zeitzone wie PST definieren.

Wenn Sie beispielsweise einem/einer Nutzer:in am Tag vor seinem/ihrem Geburtstag eine Nachricht senden möchten, würden Sie die Kontextvariable als Datentyp „Zeit“ speichern, da mit dem Versand am Vortag Liquid-Logik verknüpft ist. Wenn Sie jedoch eine Feiertagsnachricht am Weihnachtstag (25. Dezember) senden, müssten Sie die Zeit nicht als dynamische Variable referenzieren, sodass die Verwendung eines String-Datentyps vorzuziehen wäre.

Für Objekt-Datentypen können Sie die Punktnotation verwenden, um einen Pfad durch die Daten anzugeben. Wenn Ihr Kontextschritt beispielsweise eine Kontextvariable order_summary mit dieser Struktur definiert:

1
2
3
4
5

{
  "shipping": {
    "carrier": "overnight"
  }
}

Geben Sie in einem Zielgruppenpfade- oder Decision-Split-Filter den Pfad als Kontextvariablenname in Punktnotation ein (z. B. order_summary.shipping.carrier). Wenn der Filter ausgewertet wird, löst Braze diesen Pfad zum Wert overnight auf.

Verwenden Sie in Liquid (z. B. in einem Nachrichten-Schritt) stattdessen {{context.${order_summary}.shipping.carrier}}.

Kontextvariablen verwenden

Sie können Kontextvariablen überall dort verwenden, wo Sie Liquid in einem Canvas einsetzen, z. B. in Nachrichten- und Nutzer:innen-Update-Schritten, indem Sie Personalisierung hinzufügen auswählen. Für In-App-Nachrichten und Banner in Nachrichten-Schritten können Sie Kontextvariablen auswählen, um festzulegen, wann die Nachricht ablaufen soll.

Nehmen wir zum Beispiel an, Sie möchten Passagiere über ihren VIP-Lounge-Zugang vor ihrem bevorstehenden Flug benachrichtigen. Diese Nachricht soll nur an Passagiere gesendet werden, die ein First-Class-Ticket gekauft haben. Eine Kontextvariable ist eine flexible Möglichkeit, diese Information zu verfolgen.

Nutzer:innen treten in den Canvas ein, wenn sie ein Flugticket kaufen. Um die Berechtigung für den Lounge-Zugang zu ermitteln, erstellen wir eine Kontextvariable namens lounge_access_granted in einem Kontext-Schritt und referenzieren diese Kontextvariable dann in den nachfolgenden Schritten der User Journey.

In diesem Kontext-Schritt verwenden wir {{custom_attribute.${purchased_flight}}}, um festzustellen, ob der gekaufte Flugtyp first_class ist.

Als Nächstes erstellen wir einen Nachrichten-Schritt, der Nutzer:innen anspricht, bei denen {{context.${lounge_access_granted}}} den Wert true hat. Diese Nachricht wird eine Push-Benachrichtigung mit personalisierten Lounge-Informationen sein. Basierend auf dieser Kontextvariable erhalten die berechtigten Passagiere die relevanten Nachrichten vor ihrem Flug.

• First-Class-Passagiere erhalten: „Genießen Sie exklusiven VIP-Lounge-Zugang!“
• Business- und Economy-Passagiere erhalten: „Upgraden Sie Ihren Flug für exklusiven VIP-Lounge-Zugang.“

Tipp

Sie können personalisierte Verzögerungsoptionen mit den Informationen aus dem Kontext-Schritt hinzufügen, d. h. Sie können die Variable auswählen, die Nutzer:innen verzögert.

Für Aktionspfade und Exit-Kriterien

Sie können Eigenschaftsfilter-Vergleiche mit Kontextvariablen oder angepassten Attributen in diesen Trigger-Aktionen nutzen: Angepasstes Event ausführen und Kauf tätigen. Diese Aktions-Trigger unterstützen auch Eigenschaftsfilter für einfache und verschachtelte Eigenschaften.

• Beim Vergleich mit einfachen Eigenschaften stimmen die verfügbaren Vergleiche mit dem Typ der vom angepassten Event definierten Eigenschaft überein. Zum Beispiel haben String-Eigenschaften Vergleiche wie „genau gleich“ oder „Regex stimmt überein“. Boolesche Eigenschaften können wahr oder falsch sein.
• Beim Vergleich mit verschachtelten Eigenschaften sind die Typen nicht vordefiniert, sodass Sie Vergleiche über mehrere Datentypen hinweg für boolesche Werte, Zahlen, Strings, Zeit und Tag des Jahres auswählen können – ähnlich wie bei den Vergleichen für verschachtelte angepasste Attribute. Wenn Sie einen Datentyp auswählen, der zum Zeitpunkt des Vergleichs nicht mit dem tatsächlichen Datentyp der verschachtelten Eigenschaft übereinstimmt, stimmen die Nutzer:innen nicht mit dem Aktionspfad-Schritt oder den Exit-Kriterien überein.

Beispiele für Aktionspfade

Wichtig

Für Vergleiche mit angepassten Attributen wird der Wert des angepassten Attributs zum Zeitpunkt der Ausführung der Aktion verwendet. Das bedeutet, dass Nutzer:innen nicht mit der Aktionsgruppe übereinstimmen, wenn sie dieses angepasste Attribut zum Zeitpunkt des Vergleichs nicht befüllt haben oder wenn der Wert des angepassten Attributs nicht mit den definierten Eigenschaftsvergleichen übereinstimmt. Dies gilt auch dann, wenn die Nutzer:innen beim Eintritt in den Aktionspfad-Schritt übereingestimmt hätten.

• angepasstes event ausführen
• kauf tätigen

Beispiele für Exit-Kriterien

• angepasstes event ausführen
• kauf tätigen

Ablauf festlegen

Für Banner und In-App-Nachrichten in einem Canvas-Nachrichten-Schritt wählen Sie Eine Dauer nach Verfügbarkeit des Schritts als Ablaufoption und aktivieren dann Dauer personalisieren, um das Verfügbarkeitsfenster über eine Kontextvariable zu steuern – zum Beispiel, um es an eine Aktions- oder Buchungsdauer aus einem Kontext-Schritt anzupassen.

Dauer personalisieren gilt für diese dauerbasierte Ablaufoption. Wenn Sie stattdessen Zu einem bestimmten Datum und Zeitpunkt wählen, legen Sie den Ablauf über die Datums- und Uhrzeitsteuerungen fest.

Verzögerungen bei Aktionspfaden

In einem Aktionspfade-Schritt aktivieren Sie unter Evaluierungsfenster die Option Verzögerung personalisieren, um festzulegen, wie lange Nutzer:innen im Schritt gehalten werden – basierend auf einer Kontextvariable. Verwenden Sie dies, wenn die Wartezeit je nach Nutzer:in variieren soll, zum Beispiel basierend auf Details wie Stufe oder Region.

Kontextvariablen-Filter

Sie können Filter erstellen, die zuvor deklarierte Kontextvariablen in Zielgruppenpfade- und Decision-Split-Schritten verwenden.

Hinweis

Kontextvariablen-Filter sind nur für Zielgruppenpfade- und Decision-Split-Schritte verfügbar.

Kontextvariablen werden deklariert und sind nur im Rahmen eines Canvas zugänglich, d. h. sie können nicht in Segments referenziert werden. Kontextvariablen-Filter funktionieren in Zielgruppenpfade- und Decision-Split-Schritten ähnlich – Zielgruppenpfade-Schritte repräsentieren mehrere Gruppen, während Decision-Split-Schritte binäre Entscheidungen darstellen.

Ähnlich wie Canvas-Kontextvariablen vordefinierte Typen haben, müssen die Vergleiche zwischen Kontextvariablen und statischen Werten übereinstimmende Datentypen aufweisen. Der Kontextvariablen-Filter ermöglicht Vergleiche über mehrere Datentypen hinweg für boolesche Werte, Zahlen, Strings, Zeit und Tag des Jahres – ähnlich wie bei den Vergleichen für verschachtelte angepasste Attribute.

Hier ist ein Beispiel eines Kontextvariablen-Filters, der die Kontextvariable product_name mit dem Regex /braze/ vergleicht.

Tag-des-Jahres- und Zeit-Filter für Datums-Kontextvariablen

So verwenden Sie Tag des Jahres- oder Zeit-Vergleichsfilter mit einer Kontextvariable:

1. Fügen Sie einen Kontext-Schritt hinzu, der eine Kontextvariable auf ein Kalenderdatum setzt (z. B. 23. Oktober 2025).
2. Fügen Sie nach dem Kontext-Schritt einen Zielgruppenpfade-Schritt hinzu.
3. Fügen Sie im Zielgruppenpfade-Schritt einen Filter hinzu, der Nutzer:innen basierend auf dieser Kontextvariable aufteilt.
4. Wählen Sie einen Vergleich aus der Kategorie Tag des Jahres oder Zeit.

Wenn eine Kontextvariable keinen deklarierten Typ hat, zeigt Braze alle verfügbaren Vergleichstypen im Dropdown an, einschließlich Tag des Jahres und Zeit. Wenn die Variable im Kontext-Schritt als Zeit-Typ deklariert ist, werden nur Tag des Jahres- und Zeit-Vergleiche angezeigt. Für andere Datentypen mit bekanntem Typ (z. B. ein verschachteltes angepasstes Attribut mit einem Zeit-Typ) werden nur die für diesen Typ geltenden Vergleiche angezeigt.

Hinweis

Verwenden Sie denselben Datentyp für Ihre Kontextvariable und den Vergleich. Wenn Ihre Kontextvariable zum Beispiel vom Datentyp „Zeit“ ist, verwenden Sie Zeit-Vergleiche (wie „vor“ oder „nach“). Die Verwendung nicht übereinstimmender Datentypen (wie String-Vergleiche mit einer Zeit-Kontextvariable) kann zu unerwartetem Verhalten führen.

Wichtig

Auswahl zwischen den Filtertypen „Tag des Jahres“ und „Zeit“: Wenn Sie Kontextvariablen filtern, die Datumsangaben enthalten, wählen Sie den korrekten Vergleichstyp, je nachdem, ob sich das Datum jedes Jahr wiederholt. Verwenden Sie „Tag des Jahres“ nur, wenn der Wert, den die Kontextvariable erzeugt, kein Jahr enthält.

• Verwenden Sie „Tag des Jahres“, wenn sich das Datum jedes Jahr wiederholt (z. B. Geburtstage, Jahrestage oder Feiertage wie Weihnachten). Dieser Vergleichstyp berechnet auf Grundlage des Tages im Jahr (1–365/366) und ignoriert die Jahreskomponente.
• Verwenden Sie „Zeit“, wenn es sich um ein absolutes Datum handelt, das sich nicht wiederholt (z. B. Vertragsende, Terminvereinbarungen oder Abo-Verlängerungsdaten). Dieser Vergleichstyp berechnet auf Grundlage des vollständigen Zeitstempels einschließlich des Jahres.

Die Verwendung von „Tag des Jahres“ für absolute Datumsangaben kann zu falschen oder unerwarteten Ergebnissen führen, da die Berechnung die Jahreskomponente nicht berücksichtigt. Wenn Sie beispielsweise ein zukünftiges Vertragsenddatum im April vergleichen, um festzustellen, ob es innerhalb von 63 Tagen liegt, kann „Tag des Jahres“ zu falschen Übereinstimmungen führen, da nur die Tageszahlen (119 gegenüber 359) verglichen werden, ohne zu berücksichtigen, dass der April tatsächlich 188 Tage entfernt ist.

Vergleich mit Kontextvariablen oder angepassten Attributen

Durch Aktivieren des Umschalters Mit einer Kontextvariable oder einem angepassten Attribut vergleichen können Sie Kontextvariablen-Filter erstellen, die mit zuvor definierten Kontextvariablen oder angepassten Nutzer:innen-Attributen verglichen werden. Dies kann nützlich sein, um Vergleiche durchzuführen, die pro Nutzer:in dynamisch sind, wie z. B. API-getriggerter context, oder um komplexe Vergleichslogik zu vereinfachen, die über mehrere Kontextvariablen definiert ist.

• beispiel 1
• beispiel 2

Standardisierung der Zeitzonenkonsistenz

Obwohl die meisten Event-Eigenschaften, die den Timestamp-Typ verwenden, in Canvas bereits in UTC vorliegen, gibt es einige Ausnahmen. Mit der Einführung von Canvas Context werden alle Standard-Timestamp-Event-Eigenschaften in aktionsbasierten Canvases einheitlich in UTC angegeben. Diese Änderung ist Teil einer umfassenderen Maßnahme, um ein vorhersehbareres und konsistenteres Erlebnis beim Bearbeiten von Canvas-Schritten und Nachrichten zu gewährleisten. Beachten Sie, dass diese Änderung alle aktionsbasierten Canvases betrifft, unabhängig davon, ob das jeweilige Canvas einen Context-Schritt verwendet oder nicht.

Wichtig

Unter allen Umständen empfehlen wir dringend, Liquid time_zone-Filter zu verwenden, damit Timestamps in der gewünschten Zeitzone dargestellt werden. Sie können diese häufig gestellte Frage im Context-Schritt-Artikel als Beispiel heranziehen.

Verwandte Artikel

• Context-Schritt
• Personalisierung und dynamischer Content mit Liquid