Skip to content

Angepasste Event-Eigenschaften

Dieser Artikel beschreibt angepasste Event-Eigenschaften, ihr erwartetes Format, wie Sie sie für Messaging und Segmentierung verwenden können und die Speicherung angepasster Event-Eigenschaften.

Angepasste Event-Eigenschaften sind Metadaten oder Attribute eines angepassten Events, die ein bestimmtes Vorkommen eines Events beschreiben. Diese Eigenschaften können verwendet werden, um Trigger-Bedingungen weiter zu qualifizieren, die Personalisierung im Messaging zu erhöhen, Conversions zu tracken und durch den Export von Rohdaten anspruchsvollere Analytics zu erstellen.

Angepasste Event-Eigenschaften werden nicht im Braze-Profil gespeichert und verbrauchen daher keine Datenpunkte (siehe Datenpunkte für Ausnahmen).

Erwartetes Format

Eigenschaftswerte müssen ein Objekt sein: Schlüssel sind die Eigenschaftsnamen (nicht-leere Strings, 255 Zeichen oder weniger, kein führendes $), und Werte sind die Eigenschaftswerte. Informationen zu unterstützten Datentypen, Formatanforderungen und Payload-Limits finden Sie unter Datentypen.

Sie können den Datentyp Ihrer angepassten Event-Eigenschaft ändern, sollten sich aber der Auswirkungen bewusst sein, die das Ändern von Datentypen nach der Datenerfassung mit sich bringt.

Reservierte Schlüssel

Sie können keine reservierten Schlüssel als Event-Eigenschaftsnamen verwenden. Die Verwendung eines reservierten Schlüssels im properties-Objekt gibt den Fehler „Invalid ‘properties’ field“ zurück.

Eigenschaft Reservierter Schlüssel
Angepasste Events time und event_name
Kauf-Events time, product_id, quantity, event_name, price, currency

Verwendung angepasster Event-Eigenschaften

Angepasste Event-Eigenschaften können verwendet werden, um Campaign-Trigger zu qualifizieren, Conversions zu tracken und Messaging zu personalisieren.

Nachrichten triggern

Verwenden Sie angepasste Event-Eigenschaften, um Ihre Zielgruppe für eine bestimmte Campaign oder ein Canvas weiter einzugrenzen. Wenn Sie beispielsweise eine E-Commerce-Anwendung haben und eine Nachricht an Nutzer:innen senden möchten, die ihren Warenkorb abbrechen, können Sie eine angepasste Event-Eigenschaft price hinzufügen, um Ihre Zielgruppe zu verfeinern und eine stärkere Personalisierung der Campaign zu ermöglichen.

Filter für angepasste Event-Eigenschaften für einen Warenkorb-Abbruch. Zwei Filter werden mit einem UND-Operator kombiniert, um diese Campaign an Nutzer:innen zu senden, die ihren Warenkorb mit einem Preis zwischen 100 und 200 Dollar abgebrochen haben

Verschachtelte angepasste Event-Eigenschaften werden auch bei der aktionsbasierten Zustellung unterstützt.

Filter für angepasste Event-Eigenschaften für einen Warenkorb-Abbruch. Ein Filter ist ausgewählt, wenn ein Artikel im Warenkorb einen Preis von mehr als 100 Dollar hat.

Nachrichten personalisieren

Sie können angepasste Event-Eigenschaften auch zur Personalisierung innerhalb des Messaging-Templates verwenden. Jede Campaign, die aktionsbasierte Zustellung mit einem Trigger-Event verwendet, kann angepasste Event-Eigenschaften dieses Events für die Personalisierung des Messagings nutzen.

Wenn Sie beispielsweise eine Gaming-App haben und eine Nachricht an Nutzer:innen senden möchten, die ein Level abgeschlossen haben, könnten Sie Ihre Nachricht mit einer Eigenschaft für die Zeit, die die Nutzer:innen zum Abschließen des Levels benötigt haben, weiter personalisieren. In diesem Beispiel wird die Nachricht für drei verschiedene Segmente mithilfe von bedingter Logik personalisiert. Die angepasste Event-Eigenschaft time_spent kann in die Nachricht eingefügt werden, indem Sie {{event_properties.${time_spent}}} aufrufen.

1
2
3
4
5
6
7

{% if {{event_properties.${time_spent}}} < 600 %}
Incredible work, hero! Are you ready to test your skills against other powerful heroes? Visit the Arena for real-time battles with top players from around the globe.
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Great job, hero! Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Well done, hero! Talk to villagers for tips on how to beat levels faster and unlock more rewards.
{% endif %}

Eine vollständige Liste der Liquid-Tags, die dazu führen, dass In-App-Nachrichten als vorlagenbasierte In-App-Nachrichten zugestellt werden, finden Sie unter Häufig gestellte Fragen.

Hinweise zu Filtern

  • API-Aufrufe: Wenn Sie API-Aufrufe durchführen und den Filter „ist leer“ verwenden, wird eine angepasste Event-Eigenschaft als „leer“ betrachtet, wenn sie nicht im Aufruf enthalten ist. Wenn Sie beispielsweise "event_property": "" einschließen, werden Ihre Nutzer:innen als „nicht leer“ betrachtet.
  • Ganzzahlen: Wenn Sie nach einer numerischen angepassten Event-Eigenschaft filtern und die Zahl sehr groß ist, verwenden Sie nicht den Filter „genau“. Wenn eine Zahl zu groß ist, kann sie ab einer bestimmten Länge gerundet werden, sodass Ihr Filter nicht wie erwartet funktioniert.

Segmentierung

Verwenden Sie die Event-Eigenschafts-Segmentierung, um Nutzer:innen basierend auf durchgeführten angepassten Events und den mit diesen Events verknüpften Eigenschaften anzusprechen. Dies erweitert Ihre Filteroptionen bei der Segmentierung nach Käufen und angepassten Events.

Event-Eigenschaften für angepasste Events werden in Realtime für jedes Segment aktualisiert, das sie verwendet. Sie können Eigenschaften verwalten, indem Sie zu Dateneinstellungen > Angepasste Events gehen und Eigenschaften verwalten für das zugehörige angepasste Event auswählen. Angepasste Event-Eigenschaften, die in bestimmten Segment-Filtern verwendet werden, haben einen maximalen Rückblickzeitraum von 30 Tagen.

Event-Eigenschaften für die Segmentierung hinzufügen

Sie benötigen die Nutzerberechtigung „Edit Custom Event Property Segmentation“ (Nutzerberechtigung), um Segmente basierend auf der Aktualität und Häufigkeit von Event-Eigenschaften zu erstellen.

Standardmäßig können Sie 20 segmentierbare Event-Eigenschaften pro Workspace haben. Kontaktieren Sie Ihren Braze Account Manager, um dieses Limit zu erhöhen.

Um Event-Eigenschaften für die Segmentierung hinzuzufügen, gehen Sie wie folgt vor:

  1. Gehen Sie zu Ihrem angepassten Event und wählen Sie Eigenschaften verwalten.
  2. Wählen Sie den Schalter Segmentierung aktivieren, um die Event-Eigenschaft für die Segmentierung hinzuzufügen. Beim Segmentieren stehen Ihnen dann zusätzliche Filteroptionen zur Verfügung.

Die Segment-Filter für Event-Eigenschaften umfassen:

  • Hat ein angepasstes Event mit Eigenschaft A mit Wert B, X Mal in den letzten Y Tagen durchgeführt.
  • Hat einen Kauf mit Eigenschaft A mit Wert B, X Mal in den letzten Y Tagen getätigt.
  • Ermöglicht die Segmentierung innerhalb von 1 bis 30 Tagen.

Eine Filtergruppe mit „Abandoned Cart“ mit der Eigenschaft „number of items“ und dem Wert 2, mehr als 1 Mal in den letzten 30 Kalendertagen.

Daten werden erst protokolliert, nachdem Sie eine bestimmte Event-Eigenschaft aktiviert haben, und Event-Eigenschaften sind erst ab diesem Datum verfügbar.

Datenpunkte

In Bezug auf die Abo-Nutzung werden angepasste Event-Eigenschaften, die für die Segmentierung mit den folgenden Filtern aktiviert sind, jeweils als separate Datenpunkte gezählt – zusätzlich zu dem Datenpunkt, der durch das angepasste Event selbst verbraucht wird:

  • X Custom Event Property in Y Days
  • X Purchase Property in Y Days

Canvas-Eingangs-Eigenschaften und Event-Eigenschaften

Sie können Canvas Eingangs-Eigenschaften und Event-Eigenschaften in Ihren Nutzer:innen verwenden.

Canvas-Entry-Eigenschaften sind Eigenschaften für Canvase, die durch Aktionen oder die API getriggert werden. Beachten Sie, dass das Objekt canvas_entry_properties maximal 50 KB groß sein darf.

Sie können context in jedem Schritt von Messaging mit diesem Liquid-Format referenzieren: context.${property_name}. Beachten Sie, dass es sich bei den Events um angepasste Events oder Kauf-Events handeln muss, um auf diese Weise verwendet werden zu können.

Anwendungsfall

Angenommen, der Shop RetailApp erhält folgende Anfrage: \"context\" : {\"product_name\" : \"shoes\", \"product_price\" : 79.99}.

RetailApp kann den Produktnamen (Schuhe) mit diesem Liquid in eine Nachricht einfügen: {{context.${product_name}}}.

RetailApp kann auch spezielle Nachrichten für verschiedene Eigenschaften von product_name in einem Canvas triggern, das Nutzer:innen anspricht, nachdem sie ein Kauf-Event ausgelöst haben. Sie können zum Beispiel unterschiedliche Nachrichten an Nutzer:innen, die Schuhe gekauft haben, und Nutzer:innen, die etwas anderes gekauft haben, senden, indem Sie das folgende Liquid in einen Messaging-Schritt einfügen.

1
2
3
4
5
6

{% if  {{context.${product_name}}} == "shoes" %}
  Your order is set to ship soon. While you're waiting, why not step up your shoe care routine with a little upgrade? Check out our selection of shoelaces and premium shoe polish.
{% else %}
  Your order will be on its way shortly. If you missed something, you have until the end of the week to add more items to your cart for the same discounts.
{% endif %}
Expand for original Canvas editor

Sie können Canvase nicht mehr mit dem Original-Editor erstellen oder duplizieren. Dieser Abschnitt ist nur zum Referenzieren verfügbar. Bei den Canvase, die mit dem Original-Editor erstellt wurden, können die Eingangs-Eigenschaften von Canvase nur im ersten vollständigen Schritt eines Canvas referenziert werden.

Event-Eigenschaften referenzieren auf die Eigenschaften, die Sie für angepasste Events und Käufe festlegen. Diese event_properties können in Kampagnen mit aktionsbasierter Lieferung und Canvases verwendet werden.

In Canvas können angepasste Event- und Kauf-Event-Eigenschaften in Liquid in jedem Nachrichten-Schritt verwendet werden, der auf einen Aktions-Pfad-Schritt folgt. Stellen Sie sicher, dass Sie {{event_properties.${property_name}}} verwenden, wenn Sie auf diese Event-Eigenschaften verweisen. DiDiese Events müssen angepasste Events oder Kauf-Events sein, um auf diese Weise in der Komponente „Nachricht“ verwendet werden zu können.

Im ersten Schritt der Nachricht, der einem Aktions-Pfad folgt, können Sie Event-Eigenschaften verwenden, die sich auf das in diesem Aktions-Pfad referenzierte Ereignis beziehen. Diese Event-Eigenschaften können jedoch nur verwendet werden, wenn der Nutzer:innen die Aktion tatsächlich durchgeführt hat (und nicht in die Gruppe Alle anderen einsortiert wurde). Zwischen diesem Aktionspfad und dem Nachrichtenschritt können Sie weitere Schritte einfügen (die selbst keine Aktionspfade oder Nachrichtenschritte sind).

Expand for original Canvas editor

Sie können Canvase nicht mehr mit dem Original-Editor erstellen oder duplizieren. Dieser Abschnitt ist nur zum Referenzieren verfügbar. Im Original-Canvas-Editor können Event-Eigenschaften nicht in geplanten vollständigen Schritten verwendet werden. Sie können jedoch Event-Eigenschaften im ersten vollständigen Schritt eines aktionsbasierten Canvas verwenden, auch wenn der vollständige Schritt geplant ist.

Weitere Informationen und Beispiele finden Sie unter Canvas-Eingangs-Eigenschaften und Event-Eigenschaften.

Verschachtelte Objekte

Sie können verschachtelte Objekte (Objekte innerhalb eines anderen Objekts) verwenden, um verschachtelte JSON-Daten als Eigenschaften von angepassten Events und Käufen zu senden. Diese verschachtelten Daten können für die Personalisierung von Nachrichten mit Templates, das Triggern von Nachrichtenversand und die Segmentierung von Nutzer:innen verwendet werden.

Weitere Informationen finden Sie auf unserer speziellen Seite zu verschachtelten Objekten.

Speicherung angepasster Event-Eigenschaften

Angepasste Event-Eigenschaften sind darauf ausgelegt, Ihnen zu helfen, die Targeting-Präzision zu erhöhen und Nachrichten noch persönlicher wirken zu lassen. Angepasste Event-Eigenschaften können in Braze sowohl kurz- als auch langfristig gespeichert werden.

Sie können auf zwei Arten basierend auf den Werten von Event-Eigenschaften segmentieren:

  1. Innerhalb von 30 Tagen: Sie können die Event-Eigenschafts-Segmentierung basierend auf der Häufigkeit und Aktualität bestimmter Event-Eigenschaftswerte innerhalb von Braze Segments verwenden. Diese Option wirkt sich auf die Datennutzung aus.

  2. Innerhalb und über 30 Tage hinaus: Um sowohl die kurz- als auch die langfristige Event-Eigenschafts-Segmentierung abzudecken, können Sie Segmenterweiterungen verwenden. Dieses Feature segmentiert Nutzer:innen basierend auf angepassten Events und Event-Eigenschaften, die in den letzten zwei Jahren getrackt wurden. Diese Option wirkt sich nicht auf die Datennutzung aus.

Kontaktieren Sie Ihren Braze Customer-Success-Manager für Empfehlungen zum besten Ansatz je nach Ihren spezifischen Anforderungen.
New Stuff!