Skip to content

Analytics

Erfahren Sie mehr über die Analytics des Braze SDK, damit Sie besser verstehen, welche Daten Braze erfasst, was der Unterschied zwischen angepassten Events und angepassten Attributen ist und wie Sie Analytics am besten verwalten.

Automatisch erfasste Daten

Bestimmte Nutzerdaten werden automatisch von unserem SDK erfasst – zum Beispiel „App erstmals verwendet“, „App zuletzt verwendet“, Gesamtanzahl der Sitzungen, Geräte-Betriebssystem usw. Wenn Sie unsere Integrationsleitfäden zur Implementierung unserer SDKs befolgen, können Sie diese standardmäßige Datenerfassung nutzen. Ein Blick auf diese Liste kann Ihnen helfen, dieselben Informationen über Nutzer:innen nicht mehrfach zu speichern. Mit Ausnahme von Sitzungsstart und -ende zählen alle anderen automatisch erfassten Daten nicht zur Datenpunkt-Nutzung.

Lesen Sie unseren Artikel SDK-Überblick, um Prozesse auf eine Zulassungsliste zu setzen, die die standardmäßige Erfassung bestimmter Datenelemente blockieren.

Angepasste Events

Angepasste Events sind Aktionen, die Ihre Nutzer:innen ausführen. Sie eignen sich am besten für das Tracking von besonders wertvollen Nutzer:innen-Interaktionen mit Ihrer Anwendung. Das Protokollieren eines angepassten Events kann eine beliebige Anzahl von Folgekampagnen mit konfigurierbaren Verzögerungen auslösen und ermöglicht die folgenden Segmentierungsfilter rund um die Aktualität und Häufigkeit dieses Events:

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das angepasste Event mehr als X Mal aufgetreten ist MORE THAN NUMBER
Prüfen, ob das angepasste Event weniger als X Mal aufgetreten ist LESS THAN NUMBER
Prüfen, ob das angepasste Event genau X Mal aufgetreten ist EXACTLY NUMBER
Prüfen, ob das angepasste Event zuletzt nach dem Datum X aufgetreten ist AFTER TIME
Prüfen, ob das angepasste Event zuletzt vor dem Datum X aufgetreten ist BEFORE TIME
Prüfen, ob das angepasste Event zuletzt vor mehr als X Tagen aufgetreten ist MORE THAN NUMBER OF DAYS AGO (positive Zahl)
Prüfen, ob das angepasste Event zuletzt vor weniger als X Tagen aufgetreten ist LESS THAN NUMBER OF DAYS AGO (positive Zahl)
Prüfen, ob das angepasste Event mehr als X (Max = 50) Mal aufgetreten ist MORE THAN in den letzten Y Tagen (Y = 1,3,7,14,21,30)
Prüfen, ob das angepasste Event weniger als X (Max = 50) Mal aufgetreten ist LESS THAN in den letzten Y Tagen (Y = 1,3,7,14,21,30)
Prüfen, ob das angepasste Event genau X (Max = 50) Mal aufgetreten ist EXACTLY in den letzten Y Tagen (Y = 1,3,7,14,21,30)

Braze erfasst, wie oft diese Events aufgetreten sind und wann sie zuletzt von den einzelnen Nutzer:innen ausgeführt wurden, um sie für die Segmentierung zu nutzen. Auf der Analytics-Seite Custom Events können Sie aggregiert sehen, wie oft jedes angepasste Event auftritt, sowie nach Segment über die Zeit für eine detailliertere Analyse. Dies ist besonders nützlich, um zu sehen, wie Ihre Campaigns die Aktivität angepasster Events beeinflusst haben, indem Sie die grauen Linien betrachten, die Braze über die Zeitreihe legt, um den letzten Versandzeitpunkt einer Campaign anzuzeigen.

Ein Analytics-Diagramm für angepasste Events, das Statistiken zu Nutzer:innen zeigt, die eine Kreditkarte hinzugefügt und eine Suche durchgeführt haben, über einen Zeitraum von dreißig Tagen.

Speicherung angepasster Events

Alle Nutzerprofildaten (angepasste Events, angepasste Attribute, angepasste Daten) werden gespeichert, solange diese Profile aktiv sind.

Eigenschaften angepasster Events

Mit Eigenschaften angepasster Events ermöglicht Braze Ihnen, Eigenschaften für angepasste Events und Käufe festzulegen. Diese Eigenschaften können dann verwendet werden, um Trigger-Bedingungen weiter zu qualifizieren, die Personalisierung im Messaging zu verbessern und durch den Rohdatenexport anspruchsvollere Analysen zu erstellen. Eigenschaftswerte können String, Zahl, boolescher Wert oder Zeitobjekte sein. Eigenschaftswerte können jedoch keine Array-Objekte sein.

Wenn beispielsweise eine E-Commerce-Anwendung eine Nachricht an Nutzer:innen senden möchte, die ihren Warenkorb abgebrochen haben, könnte sie zusätzlich ihre Zielgruppe verbessern und eine stärkere Campaign-Personalisierung ermöglichen, indem sie eine angepasste Event-Eigenschaft für den cart_value der Warenkörbe der Nutzer:innen hinzufügt.

Ein Beispiel für ein angepasstes Event, das eine Campaign an Nutzer:innen sendet, die ihren Warenkorb abgebrochen haben und deren Warenkorbwert zwischen 100 und 200 liegt.

Eigenschaften angepasster Events können auch für die Personalisierung innerhalb des Messaging-Templates verwendet werden. Jede Campaign, die aktionsbasierte Zustellung mit einem Trigger-Event nutzt, kann Eigenschaften angepasster Events aus diesem Event für die Messaging-Personalisierung verwenden. Wenn eine Gaming-Anwendung eine Nachricht an Nutzer:innen senden möchte, die ein Level abgeschlossen haben, könnte sie die Nachricht zusätzlich mit einer Eigenschaft für die Zeit personalisieren, die die Nutzer:innen zum Abschließen dieses Levels benötigt haben. In diesem Beispiel wird die Nachricht für drei verschiedene Segmente mithilfe von bedingter Logik personalisiert. Die angepasste Event-Eigenschaft namens time_spent kann in die Nachricht eingefügt werden, indem {{event_properties.${time_spent}}} aufgerufen wird.

1
2
3
4
5
6
7
{% if {{event_properties.${time_spent}}} < 600 %}
Congratulations on beating that level so fast! Check out our online portal where you can play against top players from around the world!
{% elsif {{event_properties.${time_spent}}} < 1800 %}
Don't forget to visit the town store between levels to upgrade your tools.
{% else %}
Talk to villagers for essential tips on how to beat levels!
{% endif %}

Eigenschaften angepasster Events sind dafür konzipiert, Ihnen bei der Personalisierung Ihres Messagings oder beim Aufbau granularer aktionsbasierter Zustellungskampagnen zu helfen. Wenn Sie Segmente basierend auf der Aktualität und Häufigkeit von Event-Eigenschaften erstellen möchten, wenden Sie sich an Ihren Customer-Success-Manager oder unser Support-Team.

Angepasste Attribute

Angepasste Attribute sind außerordentlich flexible Werkzeuge, mit denen Sie Nutzer:innen gezielter ansprechen können als mit Standardattributen. Angepasste Attribute eignen sich hervorragend zum Speichern markenspezifischer Informationen über Ihre Nutzer:innen. Beachten Sie, dass wir keine Zeitreihendaten für angepasste Attribute speichern, sodass Sie keine Diagramme auf deren Basis erhalten – anders als im vorherigen Beispiel für angepasste Events.

Speicherung angepasster Attribute

Alle Nutzerprofildaten (angepasste Events, angepasste Attribute, angepasste Daten) werden gespeichert, solange diese Profile aktiv sind.

Datentypen angepasster Attribute

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

Strings (alphanumerische Zeichen)

String-Attribute eignen sich zum Speichern von Nutzereingaben, wie z. B. einer Lieblingsmarke, einer Telefonnummer oder eines letzten Suchbegriffs innerhalb Ihrer Anwendung. String-Attribute unterliegen den Längenbeschränkungen für angepasste Daten (479 Bytes; ca. 479 Einzelbyte-Zeichen oder ca. 160 Zeichen für Mehrbyte-Schriften wie Japanisch).

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für String-Attribute.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das String-Attribut exakt mit einem eingegebenen String übereinstimmt EQUALS STRING
Prüfen, ob das String-Attribut teilweise mit einem eingegebenen String ODER regulären Ausdruck übereinstimmt MATCHES REGEX STRING ODER REGULAR EXPRESSION
Prüfen, ob das String-Attribut nicht teilweise mit einem eingegebenen String ODER regulären Ausdruck übereinstimmt DOES NOT MATCH REGEX STRING ODER REGULAR EXPRESSION
Prüfen, ob das String-Attribut nicht mit einem eingegebenen String übereinstimmt DOES NOT EQUAL STRING
Prüfen, ob das String-Attribut im Nutzerprofil vorhanden ist IS BLANK N/A
Prüfen, ob das String-Attribut im Nutzerprofil nicht vorhanden ist IS NOT BLANK N/A

Arrays

Array-Attribute eignen sich gut zum Speichern zusammengehöriger Informationslisten über Ihre Nutzer:innen. Wenn Sie beispielsweise die letzten 100 Inhalte, die ein:e Nutzer:in angesehen hat, in einem Array speichern, ermöglicht dies eine spezifische Interessensegmentierung.

Angepasste Attribut-Arrays sind eindimensionale Mengen; mehrdimensionale Arrays werden nicht unterstützt. Wenn ein Element zu einem angepassten Attribut-Array hinzugefügt wird, wird es am Ende des Arrays angefügt – es sei denn, es ist bereits vorhanden. In diesem Fall wird es von seiner aktuellen Position an das Ende des Arrays verschoben. Wenn beispielsweise ein Array ['hotdog','hotdog','hotdog','pizza'] importiert wird, erscheint es im Array-Attribut als ['hotdog', 'pizza'], da nur eindeutige Werte unterstützt werden.

Wenn das Array seine Höchstzahl an Elementen enthält, wird das erste Element verworfen und das neue Element am Ende hinzugefügt. Der folgende Beispielcode zeigt das Array-Verhalten im Web-SDK:

1
2
3
4
5
6
var abUser = appboy.getUser();
// initialize array for this user, assuming max length of favorite_foods is set to 4.
abUser.setCustomUserAttribute('favorite_foods', ['pizza', 'wings', 'pasta']); // => ['pizza', 'wings', 'pasta']
abUser.addToCustomAttributeArray('favorite_foods', 'fries'); // => ['pizza', 'wings', 'pasta', 'fries']
abUser.addToCustomAttributeArray('favorite_foods', 'pizza'); // => ['wings', 'pasta', 'fries', 'pizza']
abUser.addToCustomAttributeArray('favorite_foods', 'ice cream'); // => ['pasta', 'fries', 'pizza', 'ice cream']

Die Standard- und Höchstzahl an Elementen in einem Array beträgt 500. Sie können die Höchstzahl der Arrays im Braze-Dashboard unter Data Settings > Custom Attributes aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden auf die Höchstzahl gekürzt.

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für Array-Attribute.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das Array-Attribut einen Wert enthält, der exakt mit einem eingegebenen Wert übereinstimmt INCLUDES VALUE STRING
Prüfen, ob das Array-Attribut keinen Wert enthält, der exakt mit einem eingegebenen Wert übereinstimmt DOESN’T INCLUDE VALUE STRING
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 REGULAR EXPRESSION
Prüfen, ob das Array-Attribut einen Wert hat HAS A VALUE N/A
Prüfen, ob das Array-Attribut leer ist IS EMPTY N/A

Datumsangaben

Zeitattribute eignen sich zum Speichern des letzten Zeitpunkts, an dem eine bestimmte Aktion durchgeführt wurde, sodass Sie Ihren Nutzer:innen inhaltsspezifische Nachrichten zur erneuten Interaktion senden können.

Datumsfilter 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, erfasst alle Nutzer:innen in 24-Stunden-Schritten. Beispielsweise erfasst „App zuletzt vor mehr als 1 Tag verwendet“ alle Nutzer:innen, die die App „vor mehr als 24 Stunden“ ab dem genauen Zeitpunkt der Campaign-Ausführung zuletzt verwendet haben. Dasselbe gilt für Campaigns mit längeren Zeiträumen – fünf Tage ab Aktivierung bedeuten die vorherigen 120 Stunden.

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für Zeitattribute.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das Zeitattribut vor einem ausgewählten Datum liegt BEFORE CALENDAR DATE SELECTOR
Prüfen, ob das Zeitattribut nach einem ausgewählten Datum liegt AFTER CALENDAR DATE SELECTOR
Prüfen, ob das Zeitattribut mehr als X Tage zurückliegt MORE THAN NUMBER OF DAYS AGO
Prüfen, ob das Zeitattribut weniger als X Tage zurückliegt LESS THAN NUMBER OF DAYS AGO
Prüfen, ob das Zeitattribut in mehr als X Tagen in der Zukunft liegt IN MORE THAN NUMBER OF DAYS IN FUTURE
Prüfen, ob das Zeitattribut in weniger als X Tagen in der Zukunft liegt IN LESS THAN NUMBER OF DAYS IN FUTURE
Prüfen, ob das Zeitattribut im Nutzerprofil vorhanden ist BLANK N/A
Prüfen, ob das Zeitattribut im Nutzerprofil nicht vorhanden ist IS NOT BLANK N/A

Zahlen

Numerische Attribute haben eine Vielzahl von Anwendungsfällen. Inkrementierende numerische angepasste Attribute eignen sich zum Speichern der Häufigkeit, mit der eine bestimmte Aktion oder ein bestimmtes Ereignis aufgetreten ist. Standardzahlen haben vielfältige Einsatzmöglichkeiten, wie z. B. das Erfassen von Schuhgröße, Taillenumfang oder der Anzahl, wie oft ein:e Nutzer:in ein bestimmtes Produkt-Feature oder eine Kategorie angesehen hat.

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für numerische Attribute.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das numerische Attribut größer als eine Zahl ist MORE THAN NUMBER
Prüfen, ob das numerische Attribut kleiner als eine Zahl ist LESS THAN NUMBER
Prüfen, ob das numerische Attribut genau einer Zahl entspricht EXACTLY NUMBER
Prüfen, ob das numerische Attribut nicht gleich einer Zahl ist DOES NOT EQUAL NUMBER
Prüfen, ob das numerische Attribut im Nutzerprofil vorhanden ist EXISTS N/A
Prüfen, ob das numerische Attribut im Nutzerprofil nicht vorhanden ist DOES NOT EXIST N/A

Boolesche Werte (wahr/falsch)

Boolesche Attribute eignen sich zum Speichern von Abo-Status und anderen einfachen binären Daten über Ihre Nutzer:innen. Die bereitgestellten Eingabeoptionen ermöglichen es Ihnen, Nutzer:innen zu finden, bei denen eine Variable explizit auf einen booleschen Wert gesetzt wurde, sowie solche, bei denen dieses Attribut noch nicht erfasst wurde.

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für boolesche Attribute.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob der boolesche Wert ist IS TRUE, FALSE, TRUE OR NOT SET oder FALSE OR NOT SET
Prüfen, ob der boolesche Wert im Nutzerprofil vorhanden ist EXISTS N/A
Prüfen, ob der boolesche Wert im Nutzerprofil nicht vorhanden ist DOES NOT EXIST N/A

Kauf-Events / Umsatz-Tracking

Die Verwendung unserer Kaufmethoden zur Erfassung von In-App-Käufen legt den Lifetime Value (LTV) für jedes einzelne Nutzerprofil fest. Diese Daten sind auf unserer Umsatzseite in Zeitreihendiagrammen einsehbar.

Die folgende Tabelle beschreibt die verfügbaren Segmentierungsoptionen für Kauf-Events.

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob der ausgegebene Gesamtbetrag in Dollar größer als eine Zahl ist GREATER THAN NUMBER
Prüfen, ob der ausgegebene Gesamtbetrag in Dollar kleiner als eine Zahl ist LESS THAN NUMBER
Prüfen, ob der ausgegebene Gesamtbetrag in Dollar genau einer Zahl entspricht EXACTLY NUMBER
Prüfen, ob der letzte Kauf nach Datum X stattfand AFTER TIME
Prüfen, ob der letzte Kauf vor Datum X stattfand BEFORE TIME
Prüfen, ob der letzte Kauf vor mehr als X Tagen stattfand MORE THAN TIME
Prüfen, ob der letzte Kauf vor weniger als X Tagen stattfand LESS THAN TIME
Prüfen, ob der Kauf mehr als X-mal (Max = 50) stattfand MORE THAN in den letzten Y Tagen (Y = 1,3,7,14,21,30)
Prüfen, ob der Kauf weniger als X-mal (Max = 50) stattfand LESS THAN in den letzten Y Tagen (Y = 1,3,7,14,21,30)
Prüfen, ob der Kauf genau X-mal (Max = 50) stattfand EXACTLY in den letzten Y Tagen (Y = 1,3,7,14,21,30)

Anwendungsfall Taxi-/Mitfahr-App

Nehmen wir als Beispiel eine Mitfahr-App, die entscheiden möchte, welche Nutzerdaten sie erfassen will. Die folgenden Fragen und der Brainstorming-Prozess sind ein hervorragendes Modell für Marketing- und Entwicklungsteams. Am Ende dieser Übung sollten beide Teams ein solides Verständnis davon haben, welche angepassten Events und Attribute sinnvollerweise erfasst werden sollten, um ihr Ziel zu erreichen.

Fallfrage Nr. 1: Was ist das Ziel?

Ihr Ziel ist ganz einfach: Sie wollen, dass Nutzer:innen über ihre App Taxifahrten anfordern.

Fallfrage Nr. 2: Was sind die Zwischenschritte auf dem Weg von der App-Installation zu diesem Ziel?

  1. Die Nutzer:innen müssen den Registrierungsprozess beginnen und ihre persönlichen Daten ausfüllen.
  2. Die Nutzer:innen müssen den Registrierungsprozess abschließen und verifizieren, indem sie einen Code in die App eingeben, den sie per SMS erhalten.
  3. Sie müssen versuchen, ein Taxi zu rufen.
  4. Um ein Taxi anzufordern, muss eines verfügbar sein, wenn sie suchen.

Diese Aktionen könnten dann als die folgenden angepassten Events getaggt werden:

  • Registrierung begonnen
  • Registrierung abgeschlossen
  • Erfolgreiche Taxirufe
  • Erfolglose Taxirufe

Nachdem Sie die Events implementiert haben, können Sie nun die folgenden Campaigns durchführen:

  1. Nachrichten an Nutzer:innen senden, die mit der Registrierung begonnen, aber das Event „Registrierung abgeschlossen“ nicht innerhalb eines bestimmten Zeitrahmens ausgelöst haben.
  2. Glückwunschnachrichten an Nutzer:innen senden, die die Registrierung abgeschlossen haben.
  3. Entschuldigungen und Aktionsguthaben an Nutzer:innen senden, die erfolglos ein Taxi gerufen haben und auf die nicht innerhalb einer bestimmten Zeitspanne ein erfolgreicher Taxiruf folgte.
  4. Aktionen an leistungsstarke Nutzer:innen mit vielen erfolgreichen Taxirufen senden, um ihnen für ihre Treue zu danken.

Und viele mehr!

Fallfrage Nr. 3: Welche anderen Informationen sollten wir über unsere Nutzer:innen wissen, um unser Messaging zu verbessern?

  • Ob sie über Aktionsguthaben verfügen oder nicht?
  • Die durchschnittliche Bewertung, die sie ihren Fahrer:innen geben?
  • Eindeutige Aktionscodes für die Nutzer:innen?

Diese Merkmale könnten dann als die folgenden angepassten Attribute getaggt werden:

  • Aktionsguthaben (Dezimaltyp)
  • Durchschnittliche Fahrerbewertung (Zahlentyp)
  • Eindeutiger Aktionscode (String-Typ)

Wenn Sie diese Attribute hinzufügen, haben Sie die Möglichkeit, Campaigns an Nutzer:innen zu senden, z. B.:

  1. Erinnern Sie Nutzer:innen, die sich seit sieben Tagen nicht mehr eingeloggt haben, aber über ein Aktionsguthaben verfügen, daran, dass ihr Guthaben existiert und dass sie die App erneut besuchen sollten, um es zu nutzen!
  2. Schreiben Sie Nutzer:innen, die niedrige Fahrerbewertungen abgeben, eine Nachricht, um direktes Kundenfeedback zu erhalten und zu erfahren, warum ihnen die Fahrt nicht gefallen hat.
  3. Nutzen Sie unsere Features zur Template-Erstellung und Personalisierung von Nachrichten, um das eindeutige Aktionscode-Attribut in das Messaging für die Nutzer:innen einzufügen.

Best Practices

Allgemeine Best Practices

Event-Eigenschaften verwenden

  • Benennen Sie ein angepasstes Event so, dass es eine Aktion beschreibt, die ein:e Nutzer:in ausführt.
  • Nutzen Sie angepasste Event-Eigenschaften großzügig, um wichtige Daten über ein Event darzustellen.
  • Anstatt beispielsweise für jeden der 50 verschiedenen Filme ein separates angepasstes Event zu erfassen, wäre es effektiver, einfach das Ansehen eines Films als Event zu erfassen und eine Event-Eigenschaft zu verwenden, die den Namen des Films enthält.

Best Practices für die Entwicklung

Nutzer-IDs für alle Nutzer:innen festlegen

Nutzer-IDs sollten für alle Ihre Nutzer:innen festgelegt werden. Diese sollten unveränderlich und zugänglich sein, wenn ein:e Nutzer:in die App öffnet. Wir empfehlen dringend, diesen Bezeichner bereitzustellen, da er Ihnen Folgendes ermöglicht:

  • Ihre Nutzer:innen geräte- und plattformübergreifend zu verfolgen und so die Qualität Ihrer Verhaltens- und demografischen Daten zu verbessern.
  • Daten über Ihre Nutzer:innen mithilfe unserer Nutzerdaten-API zu importieren.
  • Bestimmte Nutzer:innen mit unserer Messaging-API sowohl für allgemeine als auch für transaktionale Nachrichten anzusprechen.

Nutzer-IDs müssen weniger als 512 Zeichen lang sein und sollten privat und nicht leicht zu ermitteln sein (z. B. keine einfache E-Mail-Adresse oder kein Nutzername). Wenn ein solcher Bezeichner nicht verfügbar ist, weist Braze Ihren Nutzer:innen einen eindeutigen Bezeichner zu, aber Ihnen fehlen die für Nutzer-IDs aufgeführten Funktionen. Sie sollten es vermeiden, Nutzer-IDs für Nutzer:innen festzulegen, für die Sie keinen eindeutigen Bezeichner haben, der an sie als Individuum gebunden ist. Die Übergabe eines Gerätebezeichners bietet keinen Vorteil gegenüber dem automatischen anonymen Nutzer:innen-Tracking, das Braze standardmäßig anbietet. Im Folgenden finden Sie einige Beispiele für geeignete und ungeeignete Nutzer-IDs.

Gute Optionen für Nutzer-IDs:

  • Gehashte E-Mail-Adresse oder eindeutiger Nutzername
  • Eindeutiger Datenbankbezeichner

Diese sollten nicht als Nutzer-IDs verwendet werden:

  • Geräte-ID
  • Zufallszahl oder Sitzungs-ID
  • Jede nicht-eindeutige ID
  • E-Mail-Adresse
  • Nutzer-ID eines anderen Drittanbieters

Angepassten Events und Attributen lesbare Namen geben

Stellen Sie sich vor, Sie sind ein:e Marketer, der/die ein oder zwei Jahre nach der Implementierung mit der Nutzung von Braze beginnt. Eine Dropdown-Liste voller Namen wie „usr_no_acct“ ohne weiteren Kontext zu lesen, kann einschüchternd sein. Wenn Sie Ihren Events und Attributen identifizierbare und lesbare Namen geben, wird es für alle Nutzer:innen Ihrer Plattform einfacher. Beachten Sie die folgenden Best Practices:

  • Beginnen Sie ein angepasstes Event nicht mit einem numerischen Zeichen. Die Dropdown-Liste ist alphabetisch sortiert, und ein Anfang mit einem numerischen Zeichen erschwert die Segmentierung nach dem gewünschten Filter.
  • Versuchen Sie, nach Möglichkeit keine unverständlichen Abkürzungen oder Fachjargon zu verwenden.
    • Beispiel: usr_ctry mag als Variablenname für das Land eines Nutzers/einer Nutzerin in einem Stück Code in Ordnung sein, aber das angepasste Attribut sollte als etwas wie user_country an Braze gesendet werden, um einem/einer Marketer, der/die das Dashboard später nutzt, mehr Klarheit zu bieten.

Attribute nur protokollieren, wenn sie sich ändern

Wir zählen jedes an Braze übergebene Attribut als Datenpunkt, auch wenn das übergebene Attribut denselben Wert wie der zuvor gespeicherte enthält. Daten nur bei Änderungen zu protokollieren hilft, redundante Datenpunkt-Nutzung zu vermeiden, und unterstützt ein reibungsloseres Erlebnis, indem unnötige API-Aufrufe vermieden werden.

Programmatisches Generieren von Event-Namen vermeiden

Wenn Sie ständig neue Event-Namen erstellen, wird es unmöglich sein, Ihre Nutzer:innen sinnvoll zu segmentieren. Sie sollten generell generische Events erfassen (z. B. „Video angesehen“ oder „Artikel gelesen“) anstelle von hochspezifischen Events wie „Gangnam Style angesehen“ oder „Artikel gelesen: Die 10 besten Mittagslokale in Midtown Manhattan“. Die spezifischen Daten über das Event sollten als Event-Eigenschaft und nicht als Teil des Event-Namens enthalten sein.

Technische Einschränkungen und Beschränkungen

Beachten Sie die folgenden Einschränkungen und Beschränkungen bei der Implementierung angepasster Events:

Längenbeschränkungen

Braze erzwingt eine Längenbegrenzung in Bytes (479 Bytes) für Namen angepasster Events, Namen angepasster Attribute (Schlüssel) und String-Werte angepasster Events. Werte, die dieses Limit überschreiten, werden abgeschnitten. In Zeichen ausgedrückt entspricht dies ungefähr 479 Einzelbyte-Zeichen (z. B. ASCII) oder ungefähr 160 Zeichen für Mehrbyte-Schriften wie Japanisch (bei etwa 3 Bytes pro Zeichen in UTF-8). Idealerweise sollten Namen und Werte so kurz wie möglich gehalten werden, um die Netzwerk- und Akku-Performance Ihrer App zu verbessern – begrenzen Sie sie nach Möglichkeit auf 50 Zeichen.

Inhaltsbeschränkungen

Die folgenden Inhalte werden programmatisch aus Ihren Attributen und Events entfernt. Achten Sie darauf, Folgendes nicht zu verwenden:

  • Führende und nachgestellte Leerzeichen
  • Zeilenumbrüche
  • Alle Nicht-Ziffern in Telefonnummern
    • Beispiel: „(732) 178-1038“ wird zu „7321781038“ zusammengefasst
  • Nicht-Leerzeichen müssen in Leerzeichen umgewandelt werden
  • $ sollte nicht als Präfix für angepasste Events verwendet werden
  • Alle ungültigen UTF-8-Kodierungswerte
    • „My \x80 Field“ wird zu „My Field“ zusammengefasst

Reservierte Schlüssel

Die folgenden Schlüssel sind reserviert und können nicht als Eigenschaften angepasster Events verwendet werden:

  • time
  • product_id
  • quantity
  • event_name
  • price
  • currency

Wertdefinitionen

  • Ganzzahlwerte sind 64 Bit
  • Dezimalzahlen haben standardmäßig 15 Dezimalstellen

Parsen eines generischen Namensfelds

Wenn für eine:n Nutzer:in nur ein einzelnes generisches Namensfeld vorhanden ist (z. B. „JohnDoe“), können Sie diesen gesamten Titel dem Vornamen-Attribut Ihres Nutzers/Ihrer Nutzerin zuweisen. Zusätzlich können Sie versuchen, sowohl den Vor- als auch den Nachnamen des Nutzers/der Nutzerin anhand von Leerzeichen zu parsen, aber diese letztere Methode birgt das potenzielle Risiko, einige Ihrer Nutzer:innen falsch zu benennen.

New Stuff!