Diese Seite wurde automatisch übersetzt und kann Ungenauigkeiten enthalten. Um einen Übersetzungsfehler zu melden, nutzen Sie das Feedback unten im Inhaltsverzeichnis rechts auf der Seite.

Context- und Event-Eigenschaften

Dieser Referenzartikel behandelt Informationen über context und event_properties, einschließlich wann welche Eigenschaft verwendet werden sollte und die Unterschiede im Verhalten.

Allgemeine Informationen zu angepassten Event-Eigenschaften finden Sie unter Angepasste Event-Eigenschaften.

Wichtig

Canvas-Entry-Eigenschaften sind Teil der Canvas-Kontextvariablen. Das bedeutet, dass canvas_entry_properties als context referenziert wird. Jede context-Variable enthält einen Namen, einen Datentyp und einen Wert, der Liquid enthalten kann. Derzeit sind canvas_entry_properties abwärtskompatibel. Weitere Informationen finden Sie unter Kontext und Canvas-Kontextobjekt.

Context-Eigenschaften und Event-Eigenschaften funktionieren innerhalb Ihrer Canvas-Workflows unterschiedlich. Eigenschaften von Events oder API-Aufrufen, die den Eintritt von Nutzer:innen in einen Canvas triggern, werden als context bezeichnet. Eigenschaften von Events, die auftreten, während sich Nutzer:innen innerhalb einer Canvas-Journey bewegen, werden als event_properties bezeichnet. Der wesentliche Unterschied besteht darin, dass context sich nicht nur auf Events konzentriert, sondern auch auf die Eigenschaften von Entry-Payloads in API-getriggerten Canvases zugreift.

In der folgenden Tabelle finden Sie eine Zusammenfassung der Unterschiede zwischen Context- und Event-Eigenschaften.

	Context-Eigenschaften	Event-Eigenschaften
Liquid	`context`	`event_properties`
Persistenz	Können von allen Nachrichten-Schritten für die Dauer eines Canvas referenziert werden.	- Können nur einmal referenziert werden. - Können nicht von nachfolgenden Nachrichten-Schritten referenziert werden.
Canvas-Verhalten	Können `context` in jedem Schritt eines Canvas referenzieren. Für das Verhalten nach dem Start siehe Canvases nach dem Start bearbeiten.	- Können `event_properties` im ersten Nachrichten-Schritt nach einem Aktionspfade-Schritt referenzieren, bei dem die ausgeführte Aktion ein angepasstes Event oder Kauf-Event ist. - Dürfen nicht nach dem Alle-anderen-Pfad des Aktionspfade-Schritts stehen. - Zwischen den Aktionspfade- und Nachrichten-Schritten können andere Nicht-Nachrichten-Komponenten liegen. Wenn eine dieser Nicht-Nachrichten-Komponenten ein Aktionspfade-Schritt ist, können Nutzer:innen den Alle-anderen-Pfad dieses Aktionspfads durchlaufen.

Details zum ursprünglichen Canvas-Editor

Sie können keine Canvases mehr mit dem ursprünglichen Editor erstellen oder duplizieren. Beachten Sie, dass Canvas Context im ursprünglichen Canvas-Editor nicht unterstützt wird. Dieser Abschnitt dient daher als Referenz für die Verwendung von Canvas-Entry-Eigenschaften und Event-Eigenschaften im vorherigen Canvas-Workflow.

Canvas-Entry-Eigenschaften:

Persistente Entry-Eigenschaften müssen aktiviert sein.
Können canvas_entry_properties nur im ersten vollständigen Schritt eines Canvas referenzieren. Der Canvas muss aktionsbasiert oder API-getriggert sein.

Entry-Eigenschaften:

Können event_properties in jedem vollständigen Schritt referenzieren, der aktionsbasierte Zustellung in einem Canvas verwendet.
Können nicht in geplanten vollständigen Schritten verwendet werden, außer im ersten vollständigen Schritt eines aktionsbasierten Canvas. Wenn jedoch eine Canvas-Komponente verwendet wird, folgt das Verhalten den aktuellen Canvas-Workflow-Regeln für event_properties.

Event-Eigenschaften:

Können event_properties nicht im führenden Nachrichten-Schritt verwenden. Stattdessen müssen Sie canvas_entry_properties verwenden oder einen Aktionspfade-Schritt mit dem entsprechenden Event vor dem Nachrichten-Schritt hinzufügen, der event_properties enthält.

Wissenswertes

Kontext ist nur als Referenz in Liquid verfügbar. Um nach den Eigenschaften innerhalb des Canvas zu filtern, verwenden Sie stattdessen die Event-Eigenschafts-Segmentierung.
Für In-App-Nachricht-Kanäle können Sie context und event_properties in einem Canvas referenzieren. Auf event_properties kann zugegriffen werden, wenn sie im ersten Canvas-Schritt enthalten sind, da dieser triggerbasiert ist.
Sie können event_properties nicht im ersten Nachrichten-Schritt verwenden. Stattdessen können Sie context verwenden oder einen Aktionspfade-Schritt mit dem entsprechenden Event vor dem Nachrichten-Schritt hinzufügen, der event_properties enthält.
Wenn ein Aktionspfad-Schritt einen Trigger „Eingehende SMS-Nachricht gesendet“ oder „Eingehende WhatsApp-Nachricht gesendet“ enthält, können die nachfolgenden Canvas-Schritte eine SMS- oder WhatsApp-Liquid-Eigenschaft enthalten. Dies spiegelt wider, wie Event-Eigenschaften in Canvases funktionieren. Auf diese Weise können Sie Ihre Nachrichten nutzen, um First-Party-Daten in Nutzerprofilen und im Conversational Messaging zu speichern und zu referenzieren.

Hinweis

Die Zielgruppen-Berechtigung wird einmalig beim Canvas-Entry ausgewertet. Wenn Nutzer:innen während des Entry zusammengeführt werden, durchlaufen die identifizierten Nutzer:innen den Canvas weiterhin und werden nicht erneut anhand der Canvas-Segmentkriterien ausgewertet.

Tipp

Sie benötigen keinen Kontext-Schritt, um in Zielgruppenpfaden oder Decision-Split-Schritten auf Eigenschaften des auslösenden Ereignisses zu verweisen. Sie können die Eigenschaften direkt in den Filtergruppen mit dem Filter Context Variable referenzieren. Stellen Sie sicher, dass Sie den korrekten Datentyp auswählen.

Zeitstempel

Alle Zeitstempel in Canvas sind auf UTC normalisiert. Angesichts dieses Verhaltens empfiehlt Braze dringend, einen Liquid-Zeitzonen-Filter zu verwenden, wie im folgenden Beispiel, damit Ihre Nachrichten in Ihrer bevorzugten Zeitzone gesendet werden.

{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}

Anwendungsfall

Ein Aktionspfad-Schritt, gefolgt von einem Verzögerungs- und einem Nachrichtenschritt für Nutzer:innen, die einen Artikel zu ihrer Wunschliste hinzugefügt haben, sowie ein Pfad für alle anderen.

Um die Unterschiede zwischen context und event_properties besser zu verstehen, betrachten wir folgendes Szenario, in dem Nutzer:innen ein aktionsbasiertes Canvas betreten, wenn sie das angepasste Event „Artikel zur Wunschliste hinzufügen“ ausführen.

Der Kontext wird im Schritt Entry-Zeitplan bei der Canvas-Erstellung konfiguriert und entspricht dem Zeitpunkt, zu dem eine Nutzer:in ein Canvas betritt. Der Kontext kann auch in jedem Nachrichtenschritt referenziert werden.

In diesem Canvas haben wir eine User Journey, die mit einem Aktionspfad-Schritt beginnt, um festzustellen, ob eine Nutzer:in einen Artikel zu ihrer Wunschliste hinzugefügt hat. Wenn die Nutzer:in einen Artikel hinzugefügt hat, erlebt sie von hier aus eine Verzögerung, bevor sie die Nachricht „Neuer Artikel auf Ihrer Wunschliste!“ vom Nachrichtenschritt erhält.

Der erste Nachrichtenschritt in einer User Journey hat Zugriff auf die angepassten event_properties aus Ihrem Aktionspfad-Schritt. In diesem Fall können wir {{event_properties.${property_name}}} in diesem Nachrichtenschritt als Teil unseres Nachrichteninhalts einfügen. Wenn eine Nutzer:in keinen Artikel zu ihrer Wunschliste hinzufügt, durchläuft sie den „Alle anderen“-Pfad, was bedeutet, dass die event_properties nicht referenziert werden können und einen Fehler wegen ungültiger Einstellungen anzeigen.

Beachten Sie, dass Sie nur dann Zugriff auf event_properties haben, wenn Ihr Nachrichtenschritt auf einen Nicht-„Alle anderen“-Pfad in einem Aktionspfad-Schritt zurückverfolgt werden kann. Wenn der Nachrichtenschritt mit einem „Alle anderen“-Pfad verbunden ist, aber in der User Journey auf einen Aktionspfad-Schritt zurückverfolgt werden kann, haben Sie weiterhin Zugriff auf event_properties. Weitere Informationen zu diesem Verhalten finden Sie unter Nachrichtenschritt.

New Stuff!