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 von unserem SDK automatisch erfasst, z. B. die zuerst verwendete App, die zuletzt verwendete App, die Gesamtzahl der Sitzungen, das Betriebssystem des Geräts usw. Wenn Sie unseren Integrationsleitfäden folgen, um unsere SDKs zu implementieren, können Sie die Vorteile dieser Standard-Datenerfassung nutzen. Wenn Sie diese Liste überprüfen, können Sie vermeiden, die gleichen Informationen über Nutzer:innen mehrfach zu speichern. Mit Ausnahme des Beginns und Endes einer Sitzung werden alle anderen automatisch erfassten Daten nicht auf Ihre Datenpunkt-Nutzung angerechnet.

In unserem Artikel zum SDK-Primer können Sie Prozesse auf eine Zulassungsliste setzen, die die standardmäßige Datenerfassung bestimmter Elemente blockieren.

Angepasste Events

Angepasste Events sind Aktionen, die von Ihren Nutzer:innen ausgeführt werden. Sie eignen sich am besten für das Tracking hochwertiger Nutzer:innen-Interaktionen mit Ihrer Anwendung. Die Protokollierung eines angepassten Events kann eine beliebige Anzahl von Folgekampagnen mit konfigurierbaren Verzögerungen triggern und ermöglicht die folgenden Segmentierungsfilter in Bezug auf 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 stattgefunden hat MORE THAN NUMBER OF DAYS AGO (positive Zahl)
Prüfen, ob das angepasste Event zuletzt vor weniger als X Tagen stattgefunden hat 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 Days (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 Days (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 Days (Y = 1,3,7,14,21,30)

Braze merkt sich für die Segmentierung, wie oft diese Events aufgetreten sind und wann sie von den einzelnen Nutzer:innen zuletzt ausgeführt wurden. Auf der Analytics-Seite für Custom Events können Sie sich ansehen, wie oft die einzelnen angepassten Events insgesamt auftreten, und für eine detailliertere Analyse auch nach Segmenten im Zeitverlauf. Dies ist besonders nützlich, um zu sehen, wie sich Ihre Campaigns auf die Aktivität angepasster Events ausgewirkt haben. Dazu sehen Sie sich die grauen Linien an, die Braze über die Zeitreihe legt, um anzuzeigen, wann zuletzt eine Campaign gesendet wurde.

Ein Diagramm zur Analyse angepasster Events, das Statistiken zu Nutzer:innen anzeigt, die eine Kreditkarte hinzugefügt und innerhalb eines Zeitraums von dreißig Tagen eine Suche durchgeführt haben.

Speicherung angepasster Events

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

Angepasste Event-Eigenschaften

Mit angepassten Event-Eigenschaften ermöglicht Braze Ihnen, Eigenschaften für angepasste Events und Käufe festzulegen. Diese Eigenschaften können dann zur weiteren Qualifizierung von Trigger-Bedingungen, zur stärkeren Personalisierung des Messagings und zur Erstellung ausgefeilterer Analytics durch den Export von Rohdaten verwendet werden. Eigenschaftswerte können Strings, Zahlen, boolesche Werte oder Zeitobjekte sein. Eigenschaftswerte können jedoch keine Array-Objekte sein.

Wenn eine E-Commerce-Anwendung beispielsweise eine Nachricht an Nutzer:innen senden möchte, wenn diese ihren Warenkorb abbrechen, könnte sie zusätzlich ihre Zielgruppe verbessern und eine stärkere Personalisierung der Campaign 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 verlassen haben und deren Warenkorbwert zwischen 100 und 200 liegt.

Angepasste Event-Eigenschaften können auch zur Personalisierung im Messaging-Template verwendet werden. Jede Campaign, die aktionsbasierte Zustellung mit einem triggernden Event verwendet, kann angepasste Event-Eigenschaften aus diesem Event für die Personalisierung von Nachrichten nutzen. Wenn eine Spielanwendung eine Nachricht an Nutzer:innen senden möchte, die ein Level abgeschlossen haben, kann sie die Nachricht mit einer Eigenschaft für die Zeit personalisieren, die Nutzer:innen für den Abschluss dieses Levels benötigt haben. In diesem Beispiel wird die Nachricht mithilfe bedingter Logik für drei verschiedene Segmente personalisiert. Die angepasste Event-Eigenschaft namens time_spent kann durch den Aufruf von {{event_properties.${time_spent}}} in die Nachricht aufgenommen werden.

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 %}

Angepasste Event-Eigenschaften helfen Ihnen dabei, Ihr Messaging anzupassen oder granulare aktionsbasierte Zustellungskampagnen zu erstellen. Wenn Sie Segmente basierend auf der Aktualität und Häufigkeit von Event-Eigenschaften erstellen möchten, wenden Sie sich bitte an Ihren Customer-Success-Manager oder unser Support-Team.

Angepasste Attribute

Angepasste Attribute sind außerordentlich flexible Werkzeuge, mit denen Sie Nutzer:innen noch gezielter ansprechen können als mit Standardattributen. Angepasste Attribute eignen sich hervorragend, um markenspezifische Informationen über Ihre Nutzer:innen zu speichern. Sie sollten bedenken, dass wir für angepasste Attribute keine Zeitreiheninformationen speichern. Sie erhalten also keine darauf basierenden Diagramme wie im vorangegangenen 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 sind nützlich, um Nutzereingaben zu speichern, z. B. eine Lieblingsmarke, eine Telefonnummer oder einen letzten Suchstring in Ihrer Anwendung. String-Attribute unterliegen den Längenbeschränkungen für angepasste Daten (479 Byte; 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 mit einem eingegebenen String exakt übereinstimmt EQUALS STRING
Prüfen, ob das String-Attribut mit einem eingegebenen String ODER einem regulären Ausdruck teilweise übereinstimmt MATCHES REGEX STRING OR REGULAR EXPRESSION
Prüfen, ob das String-Attribut mit einem eingegebenen String ODER regulären Ausdruck nicht teilweise übereinstimmt DOES NOT MATCH REGEX STRING OR REGULAR EXPRESSION
Prüfen, ob das String-Attribut mit einem eingegebenen String nicht übereinstimmt DOES NOT EQUAL STRING
Prüfen, ob das String-Attribut in einem Nutzerprofil vorhanden ist IS BLANK N/A
Prüfen, ob das String-Attribut in einem Nutzerprofil nicht vorhanden ist IS NOT BLANK N/A

Arrays

Array-Attribute sind gut geeignet, um zusammenhängende Listen mit Informationen über Ihre Nutzer:innen zu speichern. Wenn Sie zum Beispiel die letzten 100 Inhalte, die Nutzer:innen gesehen haben, in einem Array speichern, ist eine Segmentierung nach Interessen möglich.

Angepasste Attribut-Arrays sind eindimensionale Sets; mehrdimensionale Arrays werden nicht unterstützt. Wenn Sie ein Element zu einem angepassten Attribut-Array hinzufügen, wird das Element an das Ende des Arrays angehängt, es sei denn, es ist bereits vorhanden. In diesem Fall wird es von seiner aktuellen Position an das Ende des Arrays verschoben. Wenn zum Beispiel das Array ['hotdog','hotdog','hotdog','pizza'] importiert wurde, wird es im Array-Attribut als ['hotdog', 'pizza'] angezeigt, 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. Im Folgenden finden Sie einige Beispiele für Code, der das Array-Verhalten im Web SDK zeigt:

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 Dateneinstellungen > Angepasste Attribute aktualisieren. Arrays, die die Höchstzahl an Elementen überschreiten, werden gekürzt, sodass nur die Höchstzahl an Elementen erhalten bleibt.

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 mit einem eingegebenen Wert exakt übereinstimmt INCLUDES VALUE STRING
Prüfen, ob das Array-Attribut einen Wert enthält, der mit einem eingegebenen Wert nicht exakt übereinstimmt DOESN’T INCLUDE VALUE STRING
Prüfen, ob das Array-Attribut einen Wert enthält, der mit einem eingegebenen Wert ODER regulären Ausdruck teilweise übereinstimmt MATCHES REGEX STRING OR 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

Daten

Zeitattribute sind nützlich, um zu speichern, wann eine bestimmte Aktion das letzte Mal durchgeführt wurde, damit Sie Ihren Nutzer:innen inhaltsspezifische Nachrichten zur erneuten Interaktion anbieten können.

Datumsfilter mit relativen Daten (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 durchführen, schließt alle Nutzer:innen in einem 24-Stunden-Inkrement ein. Ein Beispiel: „Letzte Nutzung der App vor mehr als 1 Tag“ erfasst alle Nutzer:innen, die „die App zuletzt vor mehr als 24 Stunden genutzt haben“, genau ab dem Zeitpunkt, an dem die Campaign läuft. Dasselbe gilt für Campaigns mit längeren Datumsbereichen – fünf Tage nach der Aktivierung sind also 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 mehr als X Tage in der Zukunft liegt IN MORE THAN NUMBER OF DAYS IN FUTURE
Prüfen, ob das Zeitattribut weniger als X Tage in der Zukunft liegt IN LESS THAN NUMBER OF DAYS IN FUTURE
Prüfen, ob das Zeitattribut in einem Nutzerprofil vorhanden ist BLANK N/A
Prüfen, ob das Zeitattribut in einem Nutzerprofil nicht vorhanden ist IS NOT BLANK N/A

Zahlen

Für numerische Attribute gibt es eine Vielzahl von Anwendungsfällen. Angepasste Attribute mit inkrementeller Zahl sind nützlich, um zu speichern, wie oft eine bestimmte Aktion oder ein bestimmtes Ereignis stattgefunden hat. Standardzahlen haben alle möglichen Verwendungszwecke, wie z. B. die Erfassung der Schuhgröße, des Taillenumfangs oder der Anzahl, wie oft Nutzer:innen ein bestimmtes Produkt-Feature oder eine Kategorie angesehen haben.

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

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob das numerische Attribut mehr als eine Zahl beträgt MORE THAN NUMBER
Prüfen, ob das numerische Attribut weniger als eine Zahl beträgt LESS THAN NUMBER
Prüfen, ob das numerische Attribut exakt einer Zahl entspricht EXACTLY NUMBER
Prüfen, ob das numerische Attribut nicht einer Zahl entspricht DOES NOT EQUAL NUMBER
Prüfen, ob das numerische Attribut in einem Nutzerprofil vorhanden ist EXISTS N/A
Prüfen, ob das numerische Attribut in einem Nutzerprofil nicht vorhanden ist DOES NOT EXIST N/A

Boolesche Werte (wahr/falsch)

Boolesche Attribute sind nützlich, um den Status von Abos und andere einfache binäre Daten über Ihre Nutzer:innen zu speichern. Die Eingabeoptionen, die wir Ihnen zur Verfügung stellen, erlauben es Ihnen, sowohl Nutzer:innen zu finden, bei denen eine Variable explizit auf einen booleschen Wert gesetzt wurde, als auch Nutzer:innen, bei denen dieses Attribut noch nicht aufgezeichnet 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 in einem Nutzerprofil nicht vorhanden ist DOES NOT EXIST N/A

Kauf-Events / Umsatz-Tracking

Durch die Verwendung unserer Kaufmethoden zur Erfassung von In-App-Käufen wird der Life-time Value (LTV) für jedes einzelne Nutzerprofil ermittelt. Diese Daten können Sie auf unserer Umsatzseite in Zeitreihendiagrammen einsehen.

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

Segmentierungsoptionen Dropdown-Filter Eingabeoptionen
Prüfen, ob die Gesamtsumme der Ausgaben größer als eine Zahl ist GREATER THAN NUMBER
Prüfen, ob die Gesamtsumme der Ausgaben weniger als eine Zahl ist LESS THAN NUMBER
Prüfen, ob die Gesamtsumme der Ausgaben exakt einer Zahl entspricht EXACTLY NUMBER
Prüfen, ob der letzte Kauf nach dem Datum X stattgefunden hat AFTER TIME
Prüfen, ob der letzte Kauf vor dem Datum X stattgefunden hat BEFORE TIME
Prüfen, ob der letzte Kauf mehr als X Tage zurückliegt MORE THAN TIME
Prüfen, ob der letzte Kauf weniger als X Tage zurückliegt LESS THAN TIME
Prüfen, ob der Kauf mehr als X (Max = 50) Mal stattgefunden hat MORE THAN in den letzten Y Days (Y = 1,3,7,14,21,30)
Prüfen, ob der Kauf weniger als X (Max = 50) Mal stattgefunden hat LESS THAN in den letzten Y Days (Y = 1,3,7,14,21,30)
Prüfen, ob der Kauf exakt X (Max = 50) Mal stattgefunden hat EXACTLY in den letzten Y Days (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 Nutzer:innen ausführen.
  • Machen Sie großzügigen Gebrauch von angepassten Event-Eigenschaften, um wichtige Daten zu einem Event darzustellen.
  • Anstatt z. B. für jeden von 50 verschiedenen Filmen ein eigenes angepasstes Event zu erfassen, wäre es effektiver, einfach das Ansehen eines Films als Event zu erfassen und eine Event-Eigenschaft zu haben, die den Namen des Films enthält.

Best Practices für die Entwicklung

Nutzer-IDs für alle Nutzer:innen festlegen

Für alle Ihre Nutzer:innen sollten Nutzer-IDs festgelegt werden. Diese sollten unveränderlich und zugänglich sein, wenn Nutzer:innen die App öffnen. Wir empfehlen dringend, diesen Bezeichner anzugeben, da Sie damit folgende Möglichkeiten haben:

  • Verfolgen Sie Ihre Nutzer:innen geräte- und plattformübergreifend und verbessern Sie so die Qualität Ihrer verhaltensbezogenen und demografischen Daten.
  • Importieren Sie Daten über Ihre Nutzer:innen mit unserer Nutzerdaten-API.
  • Sprechen Sie bestimmte Nutzer:innen mit unserer Messaging-API für allgemeine und transaktionsbezogene Nachrichten an.

Nutzer-IDs müssen weniger als 512 Zeichen lang sein und sollten privat und nicht leicht erhältlich sein (z. B. keine einfache E-Mail-Adresse oder kein Benutzername). Wenn ein solcher Bezeichner nicht verfügbar ist, weist Braze Ihren Nutzer:innen einen eindeutigen Bezeichner zu, aber Ihnen fehlen dann die für Nutzer-IDs aufgeführten Möglichkeiten. Sie sollten es vermeiden, Nutzer-IDs für Nutzer:innen festzulegen, für die Sie keinen eindeutigen Bezeichner haben, der mit ihnen als Individuum verbunden ist. Die Übergabe eines Gerätebezeichners bietet keinen Vorteil gegenüber dem automatischen anonymen 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 Benutzername
  • 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

Geben Sie angepassten Events und Attributen lesbare Namen

Stellen Sie sich vor, Sie sind ein Marketer, der 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 kann einschüchternd wirken. 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 numerisches Zeichen am Anfang erschwert die Segmentierung nach dem gewünschten Filter.
  • Versuchen Sie, möglichst keine obskuren Abkürzungen oder Fachausdrücke zu verwenden.
    • Beispiel: usr_ctry mag als Variablenname für das Land von Nutzer:innen innerhalb eines Codes in Ordnung sein, aber das angepasste Attribut sollte als user_country an Braze gesendet werden, um Marketern, die das Dashboard später verwenden, mehr Klarheit zu verschaffen.

Nur Attribute protokollieren, wenn sie sich ändern

Wir zählen jedes an Braze übergebene Attribut als Datenpunkt, auch wenn das übergebene Attribut denselben Wert enthält wie zuvor gespeichert. Wenn Sie Daten nur dann protokollieren, wenn sie sich ändern, vermeiden Sie die redundante Verwendung von Datenpunkten und sorgen durch die Vermeidung unnötiger API-Aufrufe für eine reibungslosere Nutzung.

Vermeiden Sie die programmatische Erzeugung von Event-Namen

Wenn Sie ständig neue Event-Namen erstellen, wird es unmöglich sein, Ihre Nutzer:innen sinnvoll zu segmentieren. Sie sollten in der Regel allgemeine Events erfassen („Video angesehen“ oder „Artikel gelesen“) und keine hochspezifischen Events wie „Gangnam Style angesehen“ oder „Artikel gelesen: Die 10 besten Orte zum Mittagessen in Midtown Manhattan“. Die spezifischen Daten zum Event sollten als Event-Eigenschaft und nicht als Teil des Event-Namens enthalten sein.

Technische Beschränkungen und Bedingungen

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

Längenbeschränkungen

Braze legt eine Längenbeschränkung in Bytes (479 Bytes) für Namen angepasster Events, Namen angepasster Attribute (Schlüssel) und String-Werte angepasster Events fest. Werte, die diesen Grenzwert überschreiten, werden abgeschnitten. In Zeichen ausgedrückt entspricht dies etwa 479 Einzelbyte-Zeichen (z. B. ASCII) oder etwa 160 Zeichen für Mehrbyte-Schriften wie Japanisch (unter der Annahme von etwa 3 Bytes pro Zeichen in UTF-8). Idealerweise sollten Namen und Werte so kurz wie möglich gehalten werden, um die Netzwerk- und Batterie-Performance Ihrer App zu verbessern – wenn möglich, beschränken Sie sie auf 50 Zeichen.

Inhaltliche Beschränkungen

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

  • Führende und nachgestellte Leerzeichen
  • Zeilenumbrüche
  • Zeichen, die keine Ziffern sind, in Telefonnummern
    • Beispiel: „(732) 178-1038“ wird zu „7321781038“ verkürzt
  • Zeichen ohne Leerzeichen müssen in Leerzeichen umgewandelt werden
  • $ sollte nicht als Präfix für angepasste Events verwendet werden
  • Alle ungültigen UTF-8-Kodierungswerte
    • „Mein \x80 Feld“ würde zu „Mein Feld“ verkürzt werden

Reservierte Schlüssel

Die folgenden Schlüssel sind reserviert und können nicht als angepasste Event-Eigenschaften verwendet werden:

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

Wertdefinitionen

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

Parsen eines generischen Namensfeldes

Wenn für Nutzer:innen nur ein einziges generisches Namensfeld existiert (z. B. „JohnDoe“), können Sie diesen gesamten Titel dem Vornamen-Attribut zuordnen. Sie können auch versuchen, sowohl den Vor- als auch den Nachnamen mithilfe von Leerzeichen zu parsen, aber diese Methode birgt das Risiko, dass einige Ihrer Nutzer:innen falsch benannt werden.

New Stuff!