Zum Inhalt springen

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, der den Canvas-Workflow verwendet.	- 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 Schritts 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 Nutzer:innen jedoch eine Canvas-Komponente verwenden, 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-Eigenschaft-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 Aktionspfade-Schritt einen „SMS-Eingangs-Nachricht gesendet“- oder „WhatsApp-Eingangs-Nachricht gesendet“-Trigger 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 Entrys zusammengeführt werden, durchlaufen die identifizierten Nutzer:innen das 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 Aktionspfade-Schritt, gefolgt von einem Verzögerungsschritt 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 das folgende Szenario: Nutzer:innen betreten ein aktionsbasiertes Canvas, wenn sie das angepasste Event „Artikel zur Wunschliste hinzufügen“ ausführen.

Der Kontext wird im Schritt Entry-Zeitplan bei der Erstellung eines Canvas konfiguriert und bezieht sich darauf, wann Nutzer:innen ein Canvas betreten. Auf den Kontext kann auch in jedem Nachrichtenschritt verwiesen werden.

In diesem Canvas haben wir eine User Journey, die mit einem Aktionspfade-Schritt beginnt, um festzustellen, ob Nutzer:innen einen Artikel zu ihrer Wunschliste hinzugefügt haben. Wenn sie einen Artikel hinzugefügt haben, erleben sie eine Verzögerung, bevor sie vom Nachrichtenschritt die Nachricht „Neuer Artikel auf Ihrer Wunschliste!“ erhalten.

Der erste Nachrichtenschritt in einer User Journey hat Zugriff auf die angepassten event_properties aus Ihrem Aktionspfade-Schritt. In diesem Fall können wir {{event_properties.${property_name}}} in diesen Nachrichtenschritt als Teil unseres Nachrichteninhalts einfügen. Wenn Nutzer:innen keinen Artikel zu ihrer Wunschliste hinzufügen, durchlaufen sie den „Alle anderen“-Pfad, was bedeutet, dass auf die event_properties nicht verwiesen werden kann und ein ungültiger Einstellungsfehler angezeigt wird.

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

New Stuff!