Datentypen

Diese Seite fasst die unterstützten Datentypen für angepasste Attribute, Event-Eigenschaften und Kataloge zusammen. Jeder angepasste Datentyp hat leicht unterschiedliche Unterstützung 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.

• boolescher wert
• zahlen
• strings
• arrays
• zeit
• objekte
• arrays von objekten

Sie können angepasste Attribute einzeln über das Aktionsmenü auf die Blockliste setzen oder bis zu 100 Attribute gleichzeitig auswählen und in großen Mengen auf die Blockliste setzen. Wenn Sie ein angepasstes Attribut blockieren, werden keine Daten zu diesem Attribut mehr erfasst, vorhandene Daten sind nicht verfügbar, sofern sie nicht reaktiviert werden, und blockierte Attribute werden nicht in Filtern oder Diagrammen angezeigt. Wenn das Attribut derzeit von Filtern oder Triggern in anderen Bereichen des Braze-Dashboards referenziert wird, erscheint außerdem ein Warnhinweis, der erklärt, dass alle Instanzen der Filter oder Trigger, die darauf verweisen, entfernt und archiviert werden.

Als personenbezogene Daten (PII) markieren

Administrator:innen können auch angepasste Attribute erstellen und sie auf dieser Seite 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 ein, was Sie möchten, z. B. 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. Sie können die Tags dann verwenden, um die Liste der Attribute zu filtern.

Angepasste Attribute entfernen

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

• Wählen Sie den Namen des zu entfernenden angepassten Attributs in einem Nutzeraktualisierungs-Schritt aus.
• Setzen Sie den Wert null in Ihrer API-Anfrage an den /users/track-Endpunkt.

Den Wert null setzen

Wichtig

Ein Attribut auf null zu setzen und es auf "" (leerer String) zu setzen, ist nicht dasselbe.

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

Außerdem ist "" nur für String-Attribute gültig. Wenn der Datentyp des Attributs im Dashboard auf einen Nicht-String-Typ (wie boolescher Wert, Zahl oder Zeit) gesetzt ist, 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 Segmente auf, die ein bestimmtes angepasstes Attribut verwenden. Diese Liste enthält keine Verwendungen von Liquid.

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

Tab „Values“

Wenn Sie einen Nutzungsbericht anzeigen, wählen Sie den Tab Values aus, um die häufigsten Werte der ausgewählten angepassten Attribute basierend auf einer Stichprobe von ungefähr 250.000 Nutzer:innen anzuzeigen. Beachten Sie, dass die Ergebnisse aus einer Teilmenge von Nutzer:innen stammen und die Stichprobe daher nicht alle vorhandenen Werte enthält. Das bedeutet, dass der Tab Values nicht zur Fehlerbehebung oder für Anwendungsfälle verwendet werden sollte, die Daten aller Nutzer:innen erfordern.

Angepasste Attribute setzen

Im Folgenden finden Sie Methoden für verschiedene Plattformen, die zum Setzen angepasster Attribute verwendet werden.

Für Dokumentation nach Plattform aufklappen

• Android und FireOS
• iOS
• Web
• React Native
• Unity
• .NET MAUI (ehemals Xamarin)
• Roku

Speicherung angepasster Attribute

Alle im Nutzerprofil gespeicherten Daten, einschließlich Daten angepasster Attribute, werden auf unbestimmte Zeit aufbewahrt, solange jedes Profil aktiv ist.

Datentypen für angepasste Attribute

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

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

• Boolesche Werte
• Zahlen
• Strings
• Arrays
• Zeit
• Objekte
• Arrays von Objekten

Boolesche Werte (wahr/falsch)

Boolesche Attribute eignen sich zum Speichern einfacher binärer Daten über Ihre Nutzer:innen, wie z. B. Abo-Status. Sie können Nutzer:innen finden, bei denen eine Variable explizit auf „wahr“ oder „falsch“ gesetzt ist, sowie solche, bei denen noch kein Wert für dieses Attribut erfasst wurde.

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

Segmentierungsoptionen	Dropdown-Filter	Eingabeoptionen	Beispiele
Prüfen, ob der boolesche Wert entweder wahr, falsch, wahr oder nicht gesetzt bzw. falsch oder nicht gesetzt ist	IS	TRUE, FALSE, TRUE OR NOT SET oder FALSE OR NOT SET	Wenn dieser Filter coffee_drinker angibt, stimmt ein:e Nutzer:in unter folgenden Umständen mit diesem Filter überein: 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 coffee_drinker oder keinen Wert hat
Prüfen, ob der boolesche Wert im Nutzerprofil vorhanden und nicht null ist	IS NOT BLANK	N/A	Wenn dieser Filter coffee_drinker angibt und ein Nutzerprofil einen Wert für das Attribut coffee_drinker hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob der boolesche Wert im Nutzerprofil nicht vorhanden oder null ist	IS BLANK	N/A	Wenn dieser Filter coffee_drinker angibt und ein Nutzerprofil das Attribut coffee_drinker nicht hat oder der Wert für coffee_drinker null ist, stimmt der/die Nutzer:in mit diesem Filter überein.

Tipp

Ausgegebene Beträge sollten nicht über diese Methode erfasst werden. Verwenden Sie stattdessen Kauf-Events.

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, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das numerische Attribut nicht gleich einer Zahl ist	DOES NOT EQUAL	NUMBER	Wenn dieser Filter 10 angibt und ein Nutzerprofil den Wert 10 nicht hat, stimmt der/die Nutzer:in mit diesem Filter überein.
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, stimmt der/die Nutzer:in mit diesem Filter überein.
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, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das numerische Attribut im Nutzerprofil vorhanden und nicht null ist	IS NOT BLANK	N/A	Wenn ein Nutzerprofil das angegebene numerische Attribut enthält, unabhängig vom Wert, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das numerische Attribut im Nutzerprofil 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, stimmt der/die Nutzer:in mit diesem Filter überein.

Details zu Zahlenattributen

• Die Filter „Genau 0“ und „Kleiner als“ 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 einbeziehen.

String-Attribute können bis zu 255 Zeichen lang sein. Beachten Sie, dass Braze bei der Eingabe von Werten mit Leerzeichen zwischen, vor oder nach Wörtern auch nach denselben Leerzeichen sucht.

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

Segmentierungsoptionen	Dropdown-Filter	Eingabeoptionen	Beispiele
Prüfen, ob das String-Attribut teilweise mit einem eingegebenen String ODER regulären Ausdruck übereinstimmt	MATCHES REGEX	STRING ODER REGULÄRER AUSDRUCK Nicht case-sensitiv; maximal 32.764 Zeichen
Prüfen, ob das String-Attribut nicht teilweise mit einem eingegebenen String ODER regulären Ausdruck übereinstimmt	DOES NOT MATCH REGEX *	STRING ODER REGULÄRER AUSDRUCK Nicht case-sensitiv; maximal 32.764 Zeichen
Prüfen, ob das String-Attribut im Nutzerprofil 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, stimmt der/die Nutzer:in mit diesem Filter überein, unabhängig vom Attributwert. Der/die Nutzer:in kann z. B. sci-fi, romance oder einen anderen Wert haben.
Prüfen, ob das String-Attribut im Nutzerprofil nicht vorhanden ist	BLANK	N/A	Wenn dieser Filter favorite_genre angibt und ein Nutzerprofil das Attribut favorite_genre nicht hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob der String genau mit einem der eingegebenen Strings übereinstimmt	IS ANY OF	STRING Case-sensitiv; mehrere Strings erlaubt (maximal 256)	Wenn dieser Filter book, bookmark und reading light angibt und ein Nutzerprofil mindestens einen dieser Strings hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das String-Attribut mit keinem der eingegebenen Strings genau übereinstimmt	IS NONE OF	STRING Case-sensitiv; mehrere Strings erlaubt (maximal 256)	Wenn dieser Filter book, bookmark und reading light angibt und ein Nutzerprofil keinen dieser Strings enthält, stimmt der/die Nutzer:in mit dem Filter überein.
Prüfen, ob das String-Attribut teilweise mit einem der eingegebenen Strings übereinstimmt	CONTAINS ANY OF	STRING Case-sensitiv; mehrere Strings erlaubt (maximal 256)	Wenn dieser Filter gold angibt und ein Nutzerprofil gold in einem beliebigen String enthält, z. B. gold_tier oder former_gold_tier, stimmt der/die Nutzer:in mit dem Filter überein.
Prüfen, ob das String-Attribut nicht teilweise mit einem der eingegebenen Strings übereinstimmt	DOESN’T CONTAIN ANY OF	STRING Case-sensitiv; mehrere Strings erlaubt (maximal 256)	Wenn dieser Filter gold angibt und ein Nutzerprofil gold in keinem String enthält, stimmt der/die Nutzer:in mit diesem Filter überein.

Hinweis

Ein Datums-String wie „12-1-2021“ oder „12/1/2021“ wird in ein Datetime-Objekt umgewandelt und als Zeitattribut behandelt.

Wichtig

Bei der Segmentierung mit dem Filter DOES NOT MATCH REGEX muss im Nutzerprofil bereits ein angepasstes Attribut mit einem zugewiesenen Wert vorhanden sein. Braze empfiehlt die Verwendung von „ODER“-Logik, um zu prüfen, ob ein angepasstes Attribut leer ist, damit Nutzer:innen korrekt angesprochen werden.

Arrays

Arrays haben eine maximale Größe von 100 KB. Die Standardlänge für ein Attribut beträgt bis zu 500 Elemente (wenn Sie z. B. ein Attribut wie „Gesehene Filme“ mit 500 Einträgen senden und ein:e Nutzer:in einen 501. Film ansieht, wird der erste Film entfernt und der neueste hinzugefügt). Beachten Sie, dass Braze bei der Eingabe von Werten mit Leerzeichen zwischen, vor oder nach Wörtern auch nach denselben Leerzeichen sucht.

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

Hinweis

Die Option zur Erhöhung der maximalen Länge ist nicht verfügbar, wenn das Attribut auf automatische Erkennung des Datentyps eingestellt ist; der Datentyp muss auf Array gesetzt sein.

Fehlerbehebung: Angepasstes Array-Attribut zeigt keinen Wert im Nutzerprofil 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 überprüfen Sie seine Max Length.
4. Wenn Max Length 0 ist, aktualisieren Sie den Wert auf einen Wert größer als 0.

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

Für SDK-bezogene Beispiele zum Array-Verhalten siehe 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 mit einem eingegebenen Wert übereinstimmt	INCLUDES VALUE	STRING	Wenn dieser Filter sci-fi angibt und ein Nutzerprofil den Wert sci-fi hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Array-Attribut keinen Wert enthält, der genau mit einem eingegebenen Wert übereinstimmt	DOESN’T INCLUDE VALUE	STRING	Wenn dieser Filter sci-fi angibt und ein Nutzerprofil den Wert sci-fi nicht hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Array-Attribut einen Wert enthält, der teilweise mit einem eingegebenen Wert ODER regulären Ausdruck übereinstimmt	MATCHES REGEX	STRING ODER REGULÄRER AUSDRUCK Maximal 32.764 Zeichen
Prüfen, ob das Array-Attribut einen beliebigen Wert hat oder 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, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Array-Attribut leer ist oder nicht existiert	IS EMPTY	N/A	Wenn dieser Filter favorite_genres angibt und ein Nutzerprofil favorite_genres nicht enthält oder favorite_genres enthält, aber keine Werte hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Array-Attribut einen Wert enthält, der genau mit einem der eingegebenen Werte übereinstimmt	INCLUDES ANY OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil eine beliebige Kombination von sci-fi, fantasy oder romance hat, einschließlich nur eines davon (z. B. nur sci-fi). Ein:e Nutzer:in kann horror oder einen anderen Wert in seinem/ihrem String haben, wenn er/sie auch einen der Werte sci-fi, fantasy und romance hat.
Prüfen, ob das Array-Attribut keinen Wert enthält, der genau mit einem der eingegebenen Werte übereinstimmt	INCLUDES NONE OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil keine Kombination von sci-fi, fantasy oder romance hat, stimmt der/die Nutzer:in mit diesem Filter überein. Der/die Nutzer:in kann horror oder einen anderen Wert haben, wenn er/sie keinen der Werte sci-fi, fantasy oder romance hat.
Prüfen, ob das Array-Attribut einen Wert enthält, der teilweise mit einem der eingegebenen Werte übereinstimmt	VALUES CONTAIN ANY OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter gold angibt und ein Nutzerprofil-Array gold in mindestens einem String enthält, stimmt der/die Nutzer:in mit diesem Filter überein. Dies schließt String-Werte wie gold_tier, former_gold_tier und andere ein.
Prüfen, ob das Array-Attribut keinen Wert enthält, der teilweise mit einem der eingegebenen Werte übereinstimmt	VALUES DON’T CONTAIN ANY OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter gold angibt und ein Nutzerprofil-Array gold in keinem String enthält, stimmt der/die Nutzer:in mit diesem Filter überein. Das bedeutet, dass Nutzer:innen mit String-Werten wie gold_tier und former_gold_tier nicht mit diesem Filter übereinstimmen.
Prüfen, ob das Array-Attribut alle eingegebenen Werte enthält	IS ALL OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil alle diese Werte hat, stimmt der/die Nutzer:in mit diesem Filter überein. Der/die Nutzer:in kann auch horror oder andere Werte haben und trotzdem mit diesem Filter übereinstimmen.
Prüfen, ob das Array-Attribut nicht alle eingegebenen Werte enthält	ISN’T ALL OF	STRING Case-sensitiv; mehrere Werte erlaubt (maximal 256)	Wenn dieser Filter sci-fi, fantasy, romance angibt und ein Nutzerprofil nicht alle diese Werte hat, stimmt der/die Nutzer:in mit diesem Filter überein.

Tipp

Weitere Informationen zur Verwendung regulärer Ausdrücke (Regex) finden Sie in diesen Ressourcen:

• Perl-kompatible reguläre Ausdrücke (PCRE)
• Regex mit Braze
• Regex-Debugger und -Tester
• Regex-Tutorial

Zeitattribute eignen sich zum Speichern des letzten Zeitpunkts, zu dem eine bestimmte Aktion durchgeführt wurde, sodass Sie Ihren Nutzer:innen inhaltsspezifische Re-Engagement-Nachrichten anbieten können.

Zeitfilter mit relativen Datumsangaben (z. B. 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, schließt alle Nutzer:innen in 24-Stunden-Schritten ein. Zum Beispiel erfasst App zuletzt vor mehr als 1 Tag verwendet alle Nutzer:innen, die „die App vor mehr als 24 Stunden zuletzt verwendet haben“, gerechnet ab dem genauen Zeitpunkt der Campaign-Ausführung. Dasselbe gilt für Campaigns mit längeren Zeiträumen – fünf Tage ab Aktivierung bedeuten die vorherigen 120 Stunden.

Um Nutzer:innen anzusprechen, deren Zeitattribut in einen bestimmten Zeitraum fällt, verwenden Sie zwei Zielgruppenfilter: in more than für die untere Grenze und in less than für die obere Grenze. Ein einzelner Filter kann nicht beide Seiten dieses Bereichs abdecken. Um beispielsweise Nutzer:innen mit einem Zeitattribut 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.

Warnung

Das letzte Datum, an dem ein angepasstes Event oder Kauf-Event stattgefunden hat, wird automatisch erfasst und sollte nicht erneut über ein angepasstes Zeitattribut aufgezeichnet werden.

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

Segmentierungsoptionen	Dropdown-Filter	Eingabeoptionen	Beispiele
Prüfen, ob das Zeitattribut vor einem ausgewählten Datum liegt	BEFORE	KALENDER-DATUMSAUSWAHL	Wenn dieser Filter 2024-01-31 angibt und ein Nutzerprofil ein Datum vor 2024-1-31 hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut nach einem ausgewählten Datum liegt	AFTER	KALENDER-DATUMSAUSWAHL	Wenn dieser Filter 2024-01-31 angibt und ein Nutzerprofil ein Datum nach 2024-1-31 hat, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut mehr als X Tage zurückliegt	MORE THAN	ANZAHL TAGE IN DER VERGANGENHEIT	Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das mehr als sieben Tage zurückliegt, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut weniger als X Tage zurückliegt	LESS THAN	ANZAHL TAGE IN DER VERGANGENHEIT	Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das weniger als sieben Tage zurückliegt, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut mehr als X Tage in der Zukunft liegt	IN MORE THAN	ANZAHL TAGE IN DER ZUKUNFT	Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das mehr als sieben Tage in der Zukunft liegt, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut weniger als X Tage in der Zukunft liegt	IN LESS THAN	ANZAHL TAGE IN DER ZUKUNFT	Wenn dieser Filter 7 angibt und ein Nutzerprofil ein Datum hat, das weniger als sieben Tage in der Zukunft liegt, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut im Nutzerprofil vorhanden und nicht null ist	IS NOT BLANK	N/A	Wenn dieser Filter ein Zeitattribut angibt, das in einem Nutzerprofil vorhanden ist, stimmt der/die Nutzer:in mit diesem Filter überein.
Prüfen, ob das Zeitattribut im Nutzerprofil nicht vorhanden oder null ist	IS BLANK	N/A	Wenn dieser Filter ein Zeitattribut angibt, das nicht in einem Nutzerprofil vorhanden ist, stimmt der/die Nutzer:in mit diesem Filter überein.

Hinweis

Bei Verwendung der Operatoren in less than oder in more than mit 90 Tagen oder mehr konvertiert Braze den Wert beim Speichern des Segments automatisch in Wochen. Zum Beispiel werden 90 Tage in 13 Wochen umgerechnet.

Details zu Zeitattributen

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

Sie können verschachtelte angepasste Attribute verwenden, um Objekte als Datentyp für angepasste Attribute zu 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 jedoch der Auswirkungen bewusst sein. Weitere Informationen finden Sie unter Datentyp eines angepassten Attributs oder Events ändern.

Konsolidierte Operatoren

Wir haben die Liste der verfügbaren Operatoren für Attributfilter, Filter für angepasste Attribute und Filter für verschachtelte angepasste Attribute konsolidiert. Wenn Sie bestehende Filter mit diesen Operatoren haben, werden diese automatisch auf die neuen Operatoren aktualisiert.

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.

Hinweis

Empfohlene Events haben vordefinierte Schemas mit festgelegten Datentypen. Weitere Details finden Sie unter Empfohlene E-Commerce-Events.

Das Protokollieren von Kauf-Events legt den Lifetime-Value (LTV) für jedes Nutzerprofil 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:

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 Custom Attributes 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 Nutzerprofil 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.

Wichtig

Die Möglichkeit, die automatische Erkennung daran zu hindern, den Datentyp des angepassten Attributs zu aktualisieren, befindet sich derzeit im Early Access. Wenden Sie sich an Ihren Customer-Success-Manager, wenn Sie daran teilnehmen möchten.

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.

Format und Beispiele

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