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

Die Terminologie und der Liquid-Namespace, die Sie sehen, hängen von den in Ihrem Workspace verfügbaren Features ab:

• Wenn das Dashboard Kontextvariablen anzeigt, referenzieren Sie Entry-Eigenschaften mit context, z. B. {{context.${property_name}}}. Sie können Variablen auch mit einem Kontext-Schritt erstellen oder aktualisieren.
• Wenn das Dashboard Canvas-Entry-Eigenschaften anzeigt, referenzieren Sie diese mit canvas_entry_properties, z. B. {{canvas_entry_properties.${property_name}}}. Der Kontext-Schritt und der Filter Kontextvariable sind nicht verfügbar.
  
  Weitere Informationen finden Sie unter Kontext und Kontext- und Event-Eigenschaften. Wenn Sie Zugriff auf Canvas-Kontext benötigen, wenden Sie sich an Ihren Customer-Success-Manager.

Context-Eigenschaften und Event-Eigenschaften funktionieren innerhalb Ihrer Canvas-Workflows unterschiedlich. In Workspaces mit Canvas Context sind Eigenschaften von Events oder API-Aufrufen, die den Eintritt von Nutzer:innen in einen Canvas triggern, als context verfügbar. Wenn Ihr Workspace stattdessen Canvas-Entry-Eigenschaften anzeigt, verwenden dieselben Entry-Daten den Legacy-Namespace canvas_entry_properties. Eigenschaften von Events, die auftreten, während sich Nutzer:innen innerhalb einer Canvas-Journey bewegen, werden als event_properties bezeichnet.

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

Wissenswertes

• Sie können Kontext in Liquid referenzieren. Wenn Kontextvariable als Filter in Ihrem Workspace verfügbar ist, können Sie Kontext auch in unterstützten Canvas-Filtern verwenden. Andernfalls verwenden Sie die Event-Eigenschaftssegmentierung.
• 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 führenden 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 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 zu speichern und zu referenzieren sowie konversationsbasiertes Messaging zu verwenden.

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

Tipp

Wenn Context Variable als Filter in Ihrem Workspace verfügbar ist, benötigen Sie 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 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.

1

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

Anwendungsfall

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.

Entry-Daten werden im Schritt Entry-Zeitplan konfiguriert und entsprechen dem Zeitpunkt, an dem Nutzer:innen ein Canvas betreten. In Workspaces mit Canvas-Kontext sind diese Daten als context verfügbar und können in jedem Nachrichtenschritt referenziert werden. In anderen Workspaces kennzeichnet das Dashboard diese Daten als Canvas-Entry-Eigenschaften und verwendet canvas_entry_properties.

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 Nutzer:innen einen Artikel hinzugefügt haben, erleben sie von hier aus 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 diesem 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 die event_properties nicht referenziert werden können und einen Fehler für ungültige Einstellungen anzeigen.

Beachten Sie, dass Sie nur 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 ebenfalls weiterhin Zugriff auf event_properties. Weitere Informationen zu diesen Verhaltensweisen finden Sie unter Nachrichtenschritt.