Zum Inhalt springen

Datentypen

Diese Seite fasst die unterstützten Datentypen für angepasste Attribute, Event-Eigenschaften und Kataloge zusammen. Jeder angepasste Datentyp unterscheidet sich leicht bei den unterstützten Datentypen und Einschränkungen.

Definitionen

Verwenden Sie diese Tabelle, um zu sehen, welche Datentypen Sie für Nutzerprofilattribute, Event-Daten oder Katalogartikel verwenden können. In den folgenden Abschnitten finden Sie Informationen zur Verwendung und zu Einschränkungen für jeden Typ.

Wichtige Hinweise

  • Array: Angepasste Attribute und Event-Eigenschaften haben Größenbeschränkungen. Datetimes werden innerhalb von Arrays in Event-Eigenschaften nicht unterstützt. Kataloge unterstützen nur String-Arrays mit maximal 100 Elementen.
  • Objekt: In Braze wird dies als „verschachtelte angepasste Attribute“ für angepasste Attribute, „verschachtelte Objekte“ für Event-Eigenschaften und „JSON-Objekt“ für Kataloge bezeichnet.
  • Zeit: In Event-Eigenschaften wird dieser Typ als „Datetime“ bezeichnet.

Datentypen für angepasste Attribute

Angepasste Attribute unterstützen die in der Tabelle Definitionen aufgeführten Datentypen. Im Folgenden werden die Verwendung und Segmentierung für jeden unterstützten Datentyp beschrieben.

Sie können angepasste Attribute einzeln über das Aktionsmenü auf die Blockliste setzen oder bis zu 100 Attribute gleichzeitig auswählen und gesammelt auf die Blockliste setzen. Wenn Sie ein angepasstes Attribut blockieren, werden keine Daten zu diesem Attribut mehr erfasst. Vorhandene Daten sind erst nach einer Reaktivierung wieder verfügbar, und blockierte Attribute werden nicht in Filtern oder Charts angezeigt. Wenn andere Bereiche des Braze-Dashboards das Attribut derzeit in Filtern oder Triggern referenzieren, erscheint außerdem ein Warnhinweis. Er erklärt, dass alle Instanzen dieser Filter oder Trigger entfernt und archiviert werden.

Als personenbezogene Daten (PII) markieren

Administrator:innen können auf dieser Seite auch angepasste Attribute erstellen und als PII markieren. Diese Attribute sind nur für Administrator:innen und Dashboard-Nutzer:innen mit der Berechtigung „Als PII markierte angepasste Attribute anzeigen“ sichtbar.

Beschreibungen hinzufügen

Sie können einem angepassten Attribut nach der Erstellung eine Beschreibung hinzufügen, wenn Sie die Nutzerberechtigung Manage Events, Attributes, Purchases haben. Bearbeiten Sie das angepasste Attribut und geben Sie einen beliebigen Text ein, zum Beispiel eine Notiz für Ihr Team.

Tags hinzufügen

Sie können einem angepassten Attribut nach der Erstellung Tags hinzufügen, wenn Sie die Nutzerberechtigung „Manage Events, Attributes, Purchases“ haben. Mit den Tags können Sie anschließend die Liste der Attribute filtern.

Angepasste Attribute entfernen

Es gibt zwei Möglichkeiten, angepasste Attribute aus Nutzerprofilen zu entfernen:

Den Wert null setzen

  • null entfernt das Attribut vollständig aus dem Nutzerprofil. Es erscheint nicht im Profil und erfüllt keinen IS NOT BLANK-Filter.
  • "" setzt das Attribut auf einen leeren String-Wert. Das Attribut erscheint mit einem leeren String-Wert im Profil, erfüllt aber keine IS NOT BLANK-Filter (es wird als leer behandelt).

Außerdem ist "" nur für Attribute vom Typ String gültig. Wenn der Datentyp des Attributs im Dashboard auf einen anderen Typ als String festgelegt ist (zum Beispiel boolescher Wert, Zahl oder Zeit), löscht das Senden von "" den Wert nicht – verwenden Sie stattdessen null.

Daten exportieren

Um die Liste der angepassten Attribute als CSV-Datei zu exportieren, wählen Sie oben auf der Seite Export all aus. Das System generiert eine CSV-Datei und sendet Ihnen einen Download-Link per E-Mail.

Nutzungsberichte anzeigen

Der Nutzungsbericht listet alle Canvases, Campaigns und Segments auf, die ein bestimmtes angepasstes Attribut verwenden. Verwendungen in Liquid sind in dieser Liste nicht enthalten.

Sie können bis zu 100 Nutzungsberichte gleichzeitig anzeigen, indem Sie die Kontrollkästchen neben den jeweiligen angepassten Attributen und dann View usage report auswählen.

Tab „Values“

Wählen Sie in einem Nutzungsbericht den Tab Values aus, um die häufigsten Werte der ausgewählten angepassten Attribute anzuzeigen. Grundlage ist eine Stichprobe von etwa 250.000 Nutzer:innen. Da die Ergebnisse aus einer Teilmenge der Nutzer:innen stammen, enthält die Stichprobe nicht alle vorhandenen Werte. Verwenden Sie den Tab Values daher nicht für die Fehlerbehebung oder für Anwendungsfälle, die Daten aller Nutzer:innen benötigen.

Nutzungsbericht für ausgewählte angepasste Attribute mit geöffnetem Tab „Values“, der ein Kreisdiagramm der Werte des Attributs „country“ zeigt, zum Beispiel „US“ und „PR“.

Angepasste Attribute festlegen

Im Folgenden finden Sie die Methoden, mit denen Sie auf verschiedenen Plattformen angepasste Attribute festlegen.

Für Dokumentation nach Plattform erweitern

Speicherung angepasster Attribute

Alle im Nutzerprofil gespeicherten Daten, einschließlich der Daten angepasster Attribute, werden unbegrenzt aufbewahrt, solange das jeweilige Profil aktiv ist.

Datentypen für angepasste Attribute

Angepasste Attribute sind äußerst flexible Tools, die ein präzises Targeting ermöglichen.

Die folgenden Datentypen können als angepasste Attribute gespeichert werden:

Boolesche Werte (true/false)

Boolesche Attribute eignen sich zum Speichern einfacher binärer Daten über Ihre Nutzer:innen, zum Beispiel Abo-Status. Sie können Nutzer:innen finden, bei denen eine Variable explizit auf true oder false gesetzt ist, sowie Nutzer:innen, für die dieses Attribut noch nicht erfasst wurde.

Für boolesche Attribute stehen die folgenden Segmentierungsoptionen zur Verfügung.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen Beispiele
Prüfen, ob der boolesche Wert true, false, true oder nicht gesetzt bzw. false oder nicht gesetzt ist IS TRUE, FALSE, TRUE OR NOT SET oder FALSE OR NOT SET Wenn dieser Filter coffee_drinker angibt, entspricht ein:e Nutzer:in diesem Filter in folgenden Fällen:
  • Wenn dieser Filter true ist und der:die Nutzer:in den Wert coffee_drinker hat
  • Wenn dieser Filter false ist und der:die Nutzer:in den Wert coffee_drinker nicht hat
  • Wenn dieser Filter true or not set ist und der:die Nutzer:in den Wert coffee_drinker oder keinen Wert hat
  • Wenn dieser Filter false or not set ist und der:die Nutzer:in weder coffee_drinker noch einen anderen Wert hat
Prüfen, ob der boolesche Wert im Profil eines:einer Nutzer:in vorhanden und nicht null ist IS NOT BLANK N/A Wenn dieser Filter coffee_drinker angibt und ein:e Nutzer:in einen Wert für das Attribut coffee_drinker hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob der boolesche Wert im Profil eines:einer Nutzer:in nicht vorhanden oder null ist IS BLANK N/A Wenn dieser Filter coffee_drinker angibt und ein:e Nutzer:in entweder das Attribut coffee_drinker nicht hat oder der Wert für coffee_drinker null ist, entspricht der:die Nutzer:in diesem Filter.

Für Zahlen-Attribute stehen die folgenden Segmentierungsoptionen zur Verfügung.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen Beispiele
Prüfen, ob das numerische Attribut genau einer Zahl entspricht EXACTLY NUMBER Wenn dieser Filter 10 angibt und ein Nutzerprofil den Wert 10 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das numerische Attribut einer Zahl nicht entspricht DOES NOT EQUAL NUMBER Wenn dieser Filter 10 angibt und ein Nutzerprofil nicht den Wert 10 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das numerische Attribut größer als eine Zahl ist MORE THAN NUMBER Wenn dieser Filter 10 angibt und ein Nutzerprofil einen Wert größer als 10 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das numerische Attribut kleiner als eine Zahl ist LESS THAN NUMBER Wenn dieser Filter 10 angibt und ein Nutzerprofil einen Wert kleiner als 10 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das numerische Attribut im Profil eines:einer Nutzer:in vorhanden und nicht null ist IS NOT BLANK N/A Wenn ein Nutzerprofil das angegebene numerische Attribut enthält, entspricht der:die Nutzer:in unabhängig vom Wert diesem Filter.
Prüfen, ob das numerische Attribut im Profil eines:einer Nutzer:in nicht vorhanden oder null ist IS BLANK N/A Wenn ein Nutzerprofil das angegebene numerische Attribut nicht enthält oder der Wert des Attributs null ist, entspricht der:die Nutzer:in diesem Filter.

Details zu Zahlen-Attributen

  • Die Filter „Exactly 0“ und „Less Than“ schließen Nutzer:innen mit NULL-Feldern ein.
    • Um Nutzer:innen ohne Wert für angepasste Attribute auszuschließen, müssen Sie den Filter is not blank hinzufügen.

String-Attribute können bis zu 255 Zeichen lang sein. Wenn Sie Werte mit Leerzeichen zwischen, vor oder nach Wörtern eingeben, prüft Braze auch auf genau diese Leerzeichen.

Für String-Attribute stehen die folgenden Segmentierungsoptionen zur Verfügung.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen Beispiele
Prüfen, ob das String-Attribut einem eingegebenen String ODER regulären Ausdruck teilweise entspricht MATCHES REGEX STRING OR REGULAR EXPRESSION
Keine Unterscheidung zwischen Groß- und Kleinschreibung; maximal 32.764 Zeichen
 
Prüfen, ob das String-Attribut einem eingegebenen String ODER regulären Ausdruck nicht teilweise entspricht DOES NOT MATCH REGEX * STRING OR REGULAR EXPRESSION
Keine Unterscheidung zwischen Groß- und Kleinschreibung; maximal 32.764 Zeichen
 
Prüfen, ob das String-Attribut im Profil eines:einer Nutzer:in vorhanden und kein leerer String ist IS NOT BLANK N/A Wenn dieser Filter favorite_genre angibt und ein Nutzerprofil das Attribut favorite_genre hat, entspricht der:die Nutzer:in diesem Filter unabhängig vom Attributwert. Der:die Nutzer:in kann zum Beispiel sci-fi, romance oder einen anderen Wert haben.
Prüfen, ob das String-Attribut im Profil eines:einer Nutzer:in nicht vorhanden ist BLANK N/A Wenn dieser Filter favorite_genre angibt und ein Nutzerprofil das Attribut favorite_genre nicht hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob der String einem der eingegebenen Strings genau entspricht IS ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Strings zulässig (maximal 256)
Wenn dieser Filter book, bookmark und reading light angibt und ein Nutzerprofil mindestens einen dieser Strings hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das String-Attribut keinem der eingegebenen Strings genau entspricht IS NONE OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Strings zulässig (maximal 256)
Wenn dieser Filter book, bookmark und reading light angibt und ein Nutzerprofil keinen dieser Strings enthält, entspricht der:die Nutzer:in dem Filter.
Prüfen, ob das String-Attribut einem der eingegebenen Strings teilweise entspricht CONTAINS ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Strings zulässig (maximal 256)
Wenn dieser Filter gold angibt und ein Nutzerprofil gold in einem beliebigen String enthält, zum Beispiel gold_tier oder former_gold_tier, entspricht der:die Nutzer:in dem Filter.
Prüfen, ob das String-Attribut keinem der eingegebenen Strings teilweise entspricht DOESN’T CONTAIN ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Strings zulässig (maximal 256)
Wenn dieser Filter gold angibt und ein Nutzerprofil gold in keinem String enthält, entspricht der:die Nutzer:in diesem Filter.

Arrays

Arrays haben eine maximale Größe von 100 KB. Die Standardlänge eines Attributs beträgt bis zu 500 Elemente. Wenn Sie zum Beispiel ein Attribut wie „Movies Watched“ mit einer Länge von 500 senden und ein:e Nutzer:in den 501. Film ansieht, wird der erste Film entfernt und der neueste hinzugefügt. Wenn Sie Werte mit Leerzeichen zwischen, vor oder nach Wörtern eingeben, prüft Braze auch auf genau diese Leerzeichen.

Angepasste Attribute vom Typ Array können nicht per CSV-Import importiert werden. Um Array-Werte hochzuladen, verwenden Sie den /users/track-Endpunkt oder Cloud Data Ingestion.

Fehlerbehebung: Array-Attribut zeigt im Nutzerprofil keinen Wert an

Wenn ein angepasstes Array-Attribut in einem Nutzerprofil erscheint, aber keine Werte anzeigt, prüfen Sie, ob die Max Length des Attributs im Dashboard auf 0 gesetzt ist.

  1. Gehen Sie zu Data Settings > Custom Attributes.
  2. Filtern Sie die Liste nach Array.
  3. Suchen Sie das Attribut und prüfen Sie seine Max Length.
  4. Wenn Max Length 0 ist, ändern Sie den Wert auf eine Zahl größer als 0.

Ist Max Length auf 0 gesetzt, werden keine Werte im Nutzerprofil angezeigt.

Beispiele für das Verhalten von Arrays im SDK finden Sie in der Analytics-Übersicht.

Für Array-Attribute stehen die folgenden Segmentierungsoptionen zur Verfügung.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen Beispiele
Prüfen, ob das Array-Attribut einen Wert enthält, der genau einem eingegebenen Wert entspricht INCLUDES VALUE STRING Wenn dieser Filter sci-fi angibt und ein Nutzerprofil den Wert sci-fi hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Array-Attribut keinen Wert enthält, der genau einem eingegebenen Wert entspricht DOESN’T INCLUDE VALUE STRING Wenn dieser Filter sci-fi angibt und ein Nutzerprofil den Wert sci-fi nicht hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Array-Attribut einen Wert enthält, der einem eingegebenen Wert ODER regulären Ausdruck teilweise entspricht MATCHES REGEX STRING OR REGULAR EXPRESSION
Maximal 32.764 Zeichen
 
Prüfen, ob das Array-Attribut einen beliebigen Wert hat bzw. nicht leer ist HAS A VALUE N/A Wenn dieser Filter favorite_genres angibt und ein Nutzerprofil favorite_genres mit einem beliebigen Wert enthält, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Array-Attribut leer oder nicht vorhanden ist IS EMPTY N/A Wenn dieser Filter favorite_genres angibt und ein Nutzerprofil favorite_genres nicht enthält oder favorite_genres ohne Werte enthält, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Array-Attribut einen Wert enthält, der genau einem der eingegebenen Werte entspricht INCLUDES ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter sci-fi, fantasy, romance angibt, entspricht ein Nutzerprofil dem Filter, wenn es eine beliebige Kombination aus sci-fi, fantasy oder romance hat, auch nur einen dieser Werte (zum Beispiel nur sci-fi). Ein:e Nutzer:in kann zusätzlich horror oder einen anderen Wert im String haben, sofern auch einer der Werte sci-fi, fantasy oder romance vorhanden ist.
Prüfen, ob das Array-Attribut keinen Wert enthält, der genau einem der eingegebenen Werte entspricht INCLUDES NONE OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil keine Kombination aus sci-fi, fantasy oder romance hat, entspricht der:die Nutzer:in diesem Filter. Der:die Nutzer:in kann horror oder einen anderen Wert haben, sofern keiner der Werte sci-fi, fantasy oder romance vorhanden ist.
Prüfen, ob das Array-Attribut einen Wert enthält, der einem der eingegebenen Werte teilweise entspricht VALUES CONTAIN ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter gold angibt und ein Array im Nutzerprofil gold in mindestens einem String enthält, entspricht der:die Nutzer:in diesem Filter. Dazu gehören String-Werte wie gold_tier, former_gold_tier und andere.
Prüfen, ob das Array-Attribut keinen Wert enthält, der einem der eingegebenen Werte teilweise entspricht VALUES DON’T CONTAIN ANY OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter gold angibt und ein Array im Nutzerprofil gold in keinem String enthält, entspricht der:die Nutzer:in diesem Filter. Nutzer:innen mit String-Werten wie gold_tier und former_gold_tier entsprechen diesem Filter also nicht.
Prüfen, ob das Array-Attribut alle eingegebenen Werte enthält IS ALL OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil alle diese Werte hat, entspricht der:die Nutzer:in diesem Filter. Der:die Nutzer:in kann zusätzlich horror oder andere Werte haben und trotzdem diesem Filter entsprechen.
Prüfen, ob das Array-Attribut nicht alle eingegebenen Werte enthält ISN’T ALL OF STRING
Groß-/Kleinschreibung wird beachtet; mehrere Werte zulässig (maximal 256)
Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil nicht alle diese Werte hat, entspricht der:die Nutzer:in diesem Filter.

Zeit-Attribute eignen sich, um den Zeitpunkt zu speichern, zu dem eine bestimmte Aktion zuletzt ausgeführt wurde. So können Sie Ihren Nutzer:innen inhaltsspezifisches Messaging zur erneuten Interaktion anbieten.

Zeitfilter mit relativen Datumsangaben (zum Beispiel vor mehr als 1 Tag, vor weniger als 2 Tagen) messen 1 Tag als 24 Stunden. Jede Campaign, die Sie mit diesen Filtern ausführen, berücksichtigt alle Nutzer:innen in 24-Stunden-Schritten. Zum Beispiel erfasst last used app more than 1 day ago alle Nutzer:innen, die „die App vor mehr als 24 Stunden zuletzt genutzt haben“, gerechnet ab dem genauen Zeitpunkt, an dem die Campaign ausgeführt wird. Dasselbe gilt für Campaigns mit längeren Zeiträumen – fünf Tage ab Aktivierung bedeuten also die vorherigen 120 Stunden.

Um Nutzer:innen anzusprechen, deren Zeit-Attribut in einen bestimmten Zeitraum fällt, verwenden Sie zwei Zielgruppenfilter: in more than für die Untergrenze und in less than für die Obergrenze. Ein einzelner Filter kann nicht beide Grenzen dieses Zeitraums abbilden. Um zum Beispiel Nutzer:innen mit einem Zeit-Attribut in den nächsten 24 Stunden (zwischen jetzt und einem Tag ab jetzt) anzusprechen, wenden Sie in more than 0 days und in less than 1 day an.

Für Zeit-Attribute stehen die folgenden Segmentierungsoptionen zur Verfügung.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen Beispiele
Prüfen, ob das Zeit-Attribut vor einem ausgewählten Datum liegt BEFORE CALENDAR DATE SELECTOR Wenn dieser Filter 2024-01-31 angibt und ein Nutzerprofil ein Datum vor dem 2024-1-31 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut nach einem ausgewählten Datum liegt AFTER CALENDAR DATE SELECTOR Wenn dieser Filter 2024-01-31 angibt und ein Nutzerprofil ein Datum nach dem 2024-1-31 hat, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut mehr als X Tage zurückliegt MORE THAN NUMBER OF DAYS AGO Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das mehr als sieben Tage zurückliegt, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut weniger als X Tage zurückliegt LESS THAN NUMBER OF DAYS AGO Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das weniger als sieben Tage zurückliegt, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut mehr als X Tage in der Zukunft liegt IN MORE THAN NUMBER OF DAYS IN FUTURE Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das mehr als sieben Tage in der Zukunft liegt, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut weniger als X Tage in der Zukunft liegt IN LESS THAN NUMBER OF DAYS IN FUTURE Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das weniger als sieben Tage in der Zukunft liegt, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut im Profil eines:einer Nutzer:in vorhanden und nicht null ist IS NOT BLANK N/A Wenn dieser Filter ein Zeit-Attribut angibt, das in einem Nutzerprofil vorhanden ist, entspricht der:die Nutzer:in diesem Filter.
Prüfen, ob das Zeit-Attribut im Profil eines:einer Nutzer:in nicht vorhanden oder null ist IS BLANK N/A Wenn dieser Filter ein Zeit-Attribut angibt, das in einem Nutzerprofil nicht vorhanden ist, entspricht der:die Nutzer:in diesem Filter.

Details zu Zeit-Attributen

Datum wiederkehrender Events und Zeitstempel-Offsets

Für angepasste Zeit-Attribute speichert Braze sowohl den absoluten Zeitstempel als auch ein daraus abgeleitetes Datum des wiederkehrenden Events (Monat und Tag). Dieses Datum wird vom Filter „Day of Recurring Event“ und bei Vergleichen nach „Tag des Jahres“ für verschachtelte angepasste Attribute verwendet. Das Datum des wiederkehrenden Events wird aus dem Kalenderdatum im UTC-Offset des Zeitstempels zum Zeitpunkt des Festlegens des Attributs berechnet.

Wie sich der Offset auf Vergleiche wiederkehrender Datumsangaben auswirkt:

Wenn Sie ein Zeit-Attribut festlegen, bestimmt der UTC-Offset des Zeitstempels das gespeicherte Datum des wiederkehrenden Events. Gleiche Zeitpunkte mit unterschiedlichen Offsets ergeben unterschiedliche wiederkehrende Daten:

  • 2026-10-13T00:09:49+09:00 → 13. Oktober
  • 2026-10-12T15:09:49Z → 12. Oktober

Diese Zeitstempel stehen für denselben Zeitpunkt. Der erste verwendet jedoch einen Offset von +09:00 (JST) und speichert den 13. Oktober, während der zweite UTC (Z) verwendet und den 12. Oktober speichert. Die Zeitzoneneinstellungen des Unternehmens und der Nutzer:innen berechnen dieses gespeicherte Datum des wiederkehrenden Events nicht neu.

SDK-Serialisierung:

Einige SDKs serialisieren Date-Objekte vor dem Senden an Braze in UTC. Wenn Sie zum Beispiel im Swift-, Web- oder Android-SDK ein Zeit-Attribut mit einem Date-Objekt festlegen, wandelt das SDK es vor der Übertragung in einen UTC-Zeitstempel um. Liegt die Ortszeit zwischen 00:00 und 08:59 JST, ist das UTC-Datum einen Tag früher, und das gespeicherte Datum des wiederkehrenden Events entspricht dem Vortag in der lokalen Zeitzone des:der Nutzer:in. Liegt die lokale Zeitzone hinter UTC (zum Beispiel US-Zeitzonen), kann das UTC-Datum entsprechend einen Tag später als das lokale Kalenderdatum sein, und das gespeicherte Datum des wiederkehrenden Events liegt einen Tag nach dem lokalen Datum des:der Nutzer:in.

Das beabsichtigte lokale Kalenderdatum beibehalten:

Damit das Datum des wiederkehrenden Events dem lokalen Kalenderdatum des:der Nutzer:in entspricht, senden Sie Zeit-Attribute als Strings mit dem lokalen Offset statt als Date-Objekte:

{
  "anniversary_date": "2026-10-13T00:00:00+09:00"
}

So bleibt der 13. Oktober als Datum des wiederkehrenden Events für „Day of Recurring Event“ und für die verschachtelte Filterung nach Tag des Jahres erhalten.

  • Tag des wiederkehrenden Ereignisses
    • Wenn Sie den Filter „Tag des wiederkehrenden Ereignisses“ verwenden und dann aufgefordert werden, den „Kalendertag des wiederkehrenden Ereignisses“ auszuwählen: Wenn Sie IS LESS THAN oder IS MORE THAN auswählen, wird das aktuelle Datum für diesen Segmentierungsfilter mitgezählt.
    • Wenn Sie beispielsweise am 10. März 2020 das Datum des Attributs auf LESS THAN ... March 10, 2020 gesetzt haben, werden Attribute für die Tage bis einschließlich 10. März 2020 berücksichtigt.
  • Weniger als X Tage her: Der Filter „Weniger als X Tage her“ umfasst Daten zwischen dem Zeitpunkt vor X Tagen und dem aktuellen Datum/der aktuellen Uhrzeit.
  • Weniger als X Tage in der Zukunft: Umfasst Daten zwischen dem aktuellen Datum/der aktuellen Uhrzeit und X Tagen in der Zukunft.

Mit verschachtelten angepassten Attributen können Sie Objekte als Datentyp für angepasste Attribute senden. Weitere Informationen finden Sie unter Verschachtelte angepasste Attribute.

Verwenden Sie ein Array von Objekten, um zusammengehörige Attribute zu gruppieren. Weitere Details finden Sie unter Array von Objekten.

Sie können den Datentyp Ihres angepassten Attributs ändern, sollten sich aber der Auswirkungen bewusst sein. Weitere Informationen finden Sie unter Datentyp eines angepassten Attributs oder Events ändern.

Zusammengefasste Operatoren

Wir haben die Liste der Operatoren zusammengefasst, die in Attributfiltern, Filtern für angepasste Attribute und Filtern für verschachtelte angepasste Attribute verfügbar sind. Bestehende Filter, die diese Operatoren verwenden, werden automatisch auf die neuen Operatoren umgestellt.

Datentyp Alter Operator Neuer Operator Wert
String equals is any of Mindestens 1 Wert
String does not equal is none of Mindestens 1 Wert
Array includes value includes any of Mindestens 1 Wert
Array doesn’t include value includes none of Mindestens 1 Wert

Datentypen für Event-Eigenschaften

Wenn Sie ein Event protokollieren, können Sie zusätzliche Informationen (z. B. Produktname oder Preis) als Event-Eigenschaften anhängen. Jede Eigenschaft hat einen Namen und einen Wert. Event-Eigenschaftswerte unterstützen die Datentypen in der Tabelle Definitionen (Zeit wird in Event-Eigenschaften als „Datetime“ bezeichnet).

Erwartetes Format

Eigenschaftswerte werden als Objekt gesendet: Schlüssel sind die Eigenschaftsnamen und Werte sind die Eigenschaftswerte. Eigenschaftsnamen müssen nicht-leere Strings mit 255 Zeichen oder weniger sein, ohne führende Dollarzeichen ($).

Spezifische Regeln für Event-Eigenschaften:

  • Zeit (Datetime): Verwenden Sie das Format ISO 8601 oder yyyy-MM-dd'T'HH:mm:ss:SSSZ. Wird innerhalb von Arrays nicht unterstützt.
  • Array: Datetimes werden innerhalb von Arrays nicht unterstützt.
  • Verschachteltes Objekt: Siehe Verschachtelte Objekte.
  • Payload: Event-Eigenschaftsobjekte, die Array- oder Objektwerte enthalten, können bis zu 102.400 Bytes (100 KiB) groß sein.

Sie können den Datentyp Ihrer angepassten Event-Eigenschaft ändern, sollten sich aber der Auswirkungen einer Änderung des Datentyps bewusst sein, nachdem Daten erfasst wurden.

Für das vollständige Verhalten von Event-Eigenschaften, reservierte Schlüssel und die Verwendung in Triggern und Personalisierung siehe Angepasste Event-Eigenschaften.

Kauf-Events und Umsatz

Kauf- und Umsatzdaten werden über Kauf-Events oder empfohlene E-Commerce-Events erfasst.

Das Protokollieren von Kauf-Events legt den Lifetime Value (LTV) für jedes Kundenprofil fest, und diese Daten sind auf der Umsatzseite als Zeitreihe einsehbar. Sie können nach ausgegebenem Betrag, letztem Kaufdatum, Anzahl der Käufe in einem Zeitfenster und mehr segmentieren.

Datentypen für Kauf-Event-Eigenschaften

Kauf-Event-Eigenschaftswerte (das properties-Objekt bei einem Kauf) unterstützen die Datentypen in der Tabelle Definitionen mit derselben Struktur und denselben Benennungsregeln wie Event-Eigenschaften.

The properties values must be an object up to 50 KB where the keys are the property names and the values are the property values. Property names must be strings, 255 characters or fewer, with no leading dollar signs ($).

Property values can be any of the following data types:

Data type Description
Number Integer or float
Boolean Value true or false
Datetime String in ISO 8601 or yyyy-MM-dd'T'HH:mm:ss:SSSZ format. Not supported within arrays.
String 255 characters or fewer
Array Supported; datetimes are not supported within arrays.
Object Ingested as strings (not nested objects). For nested data, use a string value (for example, JSON serialized).

The following keys are reserved and cannot be used as property names: time, product_id, quantity, event_name, price, and currency. Using a reserved key in the properties object returns the error “Invalid ‘properties’ field”.

Für das vollständige Schema des Kauf-Objekts und Beispiele siehe Kauf-Objekt. Für das Protokollieren von Kauf-Events, Segmentierungsfilter und vollständige Details siehe Kauf-Events.

Datentyp eines angepassten Attributs oder Events ändern

So ändern Sie den Datentyp eines angepassten Attributs oder Events:

  1. Gehen Sie zu Data Settings und wählen Sie entweder angepasste Attribute oder Custom Events.
  2. Suchen Sie Ihr Attribut oder Event in der Liste und wählen Sie More actions.
  3. Wählen Sie einen neuen Data type aus dem Dropdown.
  4. Wählen Sie Save.

Wenn Sie den Datentyp eines angepassten Attributs oder Events ändern (z. B. von time zu string), beachten Sie Folgendes:

  • Filter werden nicht automatisch aktualisiert. Segmente, Campaigns, Canvases oder andere Stellen, die das geänderte Attribut oder Event verwenden, werden nicht aktualisiert. Bevor Sie den Datentyp ändern, stoppen Sie alle Campaigns oder Canvases, die das Attribut in Segmenten oder Filtern verwenden, und entfernen Sie das Attribut aus Filtern, die darauf verweisen.
  • Bestehende Nutzerdaten werden nicht rückwirkend aktualisiert. Wenn das geänderte Attribut vor der Änderung in einem Kundenprofil vorhanden war, behält dieser Wert den alten Datentyp. Nutzer:innen können aus Segmenten herausfallen, die das geänderte Attribut enthalten, da der Filter nach dem neuen Datentyp sucht. Aktualisieren Sie diese Nutzerprofile (z. B. mit dem /users/track-Endpunkt), damit sie dem neuen Typ entsprechen und bei Bedarf wieder in das Segment aufgenommen werden.
  • Neue Daten müssen dem neuen Typ entsprechen. API-Aufrufe, die den vorherigen Datentyp für das geänderte Attribut senden, werden nicht akzeptiert. Senden Sie den neuen Datentyp.

Katalog-Datentypen

Kataloge unterstützen die in der Tabelle Definitionen aufgeführten Typen. Die folgende Tabelle listet jeden Typ auf, wie er erstellt oder aktualisiert werden kann, sowie Format und Beispiele.

Datentyp Beschreibung Verfügbar per CSV-Upload Verfügbar per API und CDI
String Eine Zeichenfolge (z. B. Namen, Beschreibungen, IDs). ✅ Ja ✅ Ja
Zahl Ein numerischer Wert, entweder Ganzzahl oder Gleitkommazahl (z. B. Preise, Mengen, Bewertungen). ✅ Ja ✅ Ja
Boolescher Wert Ein true- oder false-Wert. ✅ Ja ✅ Ja
Zeit Datum und Uhrzeit im ISO 8601-Format oder als Unix-Zeitstempel in Sekunden. ✅ Ja ✅ Ja
JSON-Objekt (Objekt) Verschachteltes Objekt mit Schlüssel-Wert-Paaren. Wird in der Plattform angezeigt, kann aber nur über die API oder CDI erstellt oder aktualisiert werden. ❌ Nein ✅ Ja
String-Array (Array) Eine Liste von Strings. Wird in der Plattform angezeigt, kann aber nur über die API oder CDI erstellt oder aktualisiert werden. Maximal 100 Elemente. ❌ Nein ✅ Ja

Format und Beispiele

Datentyp Format Beispiel
String Text "Hello World"
Zeit ISO 8601 oder Unix-Zeitstempel (Sekunden) "2024-03-15T14:30:00Z"
Boolescher Wert true oder false true
Zahl Ganzzahl oder Dezimalzahl 42 oder 19.99
Objekt JSON-Objekt {"key": "value", "price": 10}
Array String-Array ["red", "blue", "green"]

Informationen zum Erstellen und Aktualisieren von Katalogen finden Sie unter Katalog erstellen.

New Stuff!