Nutzerprofile
Nutzerprofile sind eine hervorragende Möglichkeit, Informationen über bestimmte Nutzer:innen zu finden. Alle persistenten Daten, die mit einer Nutzerin oder einem Nutzer verknüpft sind, werden in ihrem Nutzerprofil gespeichert.
Auf Profile zugreifen
Um auf das Profil von Nutzer:innen zuzugreifen, gehen Sie zur Seite Search Users und suchen Sie nach Nutzer:innen anhand einer der folgenden Angaben:
- Externe Nutzer-ID
- Braze-ID
- Telefonnummer
- Push-Token
- Nutzer-Alias im Format „[user_alias]:[alias_name]“, z. B. „amplitude_id:user_123“
Wenn eine Übereinstimmung gefunden wird, können Sie die Informationen einsehen, die Sie für diese:n Nutzer:in mit dem Braze SDK erfasst haben. Falls Ihre Suche mehrere Nutzerprofile zurückgibt, können Sie jedes Profil einzeln zusammenführen oder eine Massenzusammenführung durchführen. Eine vollständige Anleitung finden Sie unter Doppelte Nutzer:innen zusammenführen.

Search Users ist nicht dasselbe wie User Lookup im Segment- oder Campaign-Composer. User Lookup prüft, ob bestimmte Nutzer:innen Ihrer Zielgruppe entsprechen, und akzeptiert nur external_id oder braze_id. Search Users auf dieser Seite unterstützt E-Mail, Telefonnummer, Push-Token und Nutzer-Alias. Weitere Informationen finden Sie unter Segments testen.

Wenn eine Telefonnummer für die Suche verwendet wird, wird sie in das E.164-Format umgewandelt. Nutzer:innen, deren Telefonnummern nicht in das E.164-Format umgewandelt werden können (z. B. weil die Telefonnummer eine ungültige Landesvorwahl oder Ortsvorwahl hat), können nicht über die Telefonnummer gesucht werden.

Anwendungsfälle
Nutzerprofile sind eine hervorragende Ressource für die Fehlerbehebung und das Testen, da Sie leicht auf Informationen über den Engagement-Verlauf, die Segmentzugehörigkeit, das Gerät und das Betriebssystem von Nutzer:innen zugreifen können.
Wenn beispielsweise Nutzer:innen ein Problem melden und Sie nicht sicher sind, welches Gerät und welches Betriebssystem sie verwenden, können Sie den Tab „Übersicht“ nutzen, um diese Informationen zu finden (sofern Sie deren E-Mail-Adresse oder Nutzer-ID haben). Sie können auch die Sprache von Nutzer:innen einsehen, was hilfreich sein kann, wenn Sie eine mehrsprachige Campaign beheben, die sich nicht wie erwartet verhalten hat.
Sie können den Tab „Engagement“ verwenden, um zu überprüfen, ob bestimmte Nutzer:innen eine Campaign erhalten haben. Darüber hinaus können Sie, wenn diese Nutzer:innen die Campaign erhalten haben, sehen, wann sie sie erhalten haben. Sie können auch überprüfen, ob Nutzer:innen sich in einem bestimmten Segment befinden und ob sie für Push, E-Mail oder beides ein Opt-in erteilt haben. Diese Informationen sind für die Fehlerbehebung nützlich. Sie sollten diese Informationen beispielsweise prüfen, wenn Nutzer:innen eine Campaign nicht erhalten, die Sie erwartet hätten, oder eine Campaign erhalten, die Sie nicht erwartet hätten.
Elemente des Nutzerprofils
Es gibt fünf Hauptbereiche im Profil von Nutzer:innen.
- Übersicht: Grundlegende Informationen über Nutzer:innen, Sitzungsdaten, angepasste Attribute, angepasste Events, Käufe und das letzte Gerät, auf dem sich die Nutzer:innen angemeldet haben.
- Engagement: Informationen über die Kontakteinstellungen der Nutzer:innen, empfangene Campaigns, Segments, Kommunikationsstatistiken, Install-Attribution und zufällige Bucket-Nummer.
- Event-Verlauf: Angepasste Events und Käufe der letzten 30 Tage, mit vollständigen Event-Eigenschaften als JSON.
- Nachrichtenverlauf: Aktuelle nachrichtenbezogene Ereignisse für diese Nutzer:innen aus den letzten 30 Tagen.
- Feature-Flag-Berechtigung: Überprüfen Sie, für welche Feature-Flags Nutzer:innen derzeit über Rollouts, Canvas-Schritte und Experimente berechtigt sind.
Übersicht
Der Tab Übersicht enthält grundlegende Informationen über Nutzer:innen und deren Interaktionen mit Ihrer App oder Website.
| Übersichtskategorie | Enthält |
|---|---|
| Profil | Geschlecht, Altersgruppe, Standort, Sprache, Gebietsschema, Zeitzone und Geburtstag. |
| Sitzungsübersicht | Wie viele Sitzungen stattfanden, wann die erste und letzte Sitzung war und in welchen Apps. |
| Angepasste Attribute | Welche angepassten Attribute diesen Nutzer:innen zugeordnet sind und deren zugehörige Werte, einschließlich verschachtelter angepasster Attribute. |
| Letzte Geräte | Auf wie vielen Geräten sich die Nutzer:innen angemeldet haben, Details zu jedem Gerät und die zugehörigen Werbe-IDs (falls vorhanden). |
| Angepasste Events | Welche angepassten Events diese Nutzer:innen ausgeführt haben, wie oft und wann sie jedes Event zuletzt ausgeführt haben. |
| Käufe | Lifetime-Umsatz, der diesen Nutzer:innen zugeordnet ist, ihr letzter Kauf, die Gesamtzahl der Käufe und eine Liste jedes Kaufs. |
Weitere Informationen zu diesen Daten finden Sie unter SDK-Datenerfassung.
Engagement
Der Tab Engagement enthält Informationen über die Interaktionen von Nutzer:innen mit den Nachrichten, die Sie ihnen über Braze gesendet haben.
| Engagement-Kategorie | Enthält |
|---|---|
| Kontakteinstellungen | Abo-Status für E-Mail, SMS und Push sowie die Abo-Gruppen, denen diese Nutzer:innen für diese drei Kanäle zugeordnet sind. Dieser Bereich enthält auch Changelog-Informationen für Push-Token. Weitere Informationen zur Einrichtung von Abos und Opt-ins finden Sie unter E-Mail, SMS und Push. |
| Empfangene Campaigns | Empfangene Campaigns zeigt kanalspezifische Sende- und Anzeigezeitpunkte. Die meisten Kanäle protokollieren einen Versand, wenn Braze die Nachricht an den Zustellungsanbieter übergibt, auch wenn die Nachricht letztendlich nicht zugestellt wird. Content Cards sind anders: Campaigns erscheinen hier erst, nachdem die Nutzer:innen die Karte in der App angesehen haben. Eine Aufschlüsselung nach Kanal finden Sie unter Wann Campaigns unter „Empfangene Campaigns“ erscheinen. Wenn eine Nachricht empfangen, geöffnet oder angeklickt wird, aktualisiert Braze die Daten für alle Profile, die denselben Kanalbezeichner wie das Profil teilen, das die Interaktion protokolliert hat (z. B. dieselbe E-Mail-Adresse für E-Mail oder dieselbe Telefonnummer für SMS oder WhatsApp). Nutzer:innen, die einen Bezeichner mit jemandem teilen, der die Nachricht empfangen, geöffnet oder angeklickt hat, können diesen Filter erfüllen, auch wenn sie ursprünglich nicht in der Campaign waren oder die Nachricht nicht direkt erhalten haben. Diese Listen verwenden Nachrichteninteraktionsdaten (einschließlich Ablaufregeln), um zu bestimmen, was für Retargeting und Verlauf angezeigt wird. Wählen Sie eine Campaign aus der Liste aus, um sie anzuzeigen. |
| Segments | Segments, in denen diese Nutzer:innen enthalten sind. Wählen Sie ein Segment aus der Liste aus, um es anzuzeigen. |
| Kommunikationsstatistiken | Wann diese Nutzer:innen zuletzt Nachrichten von Ihnen über jeden Kanal erhalten haben. |
| Install-Attribution | Informationen darüber, wie und wann Nutzer:innen Ihre App installiert haben. Erfahren Sie mehr über das Verstehen von Nutzerinstallationen. |
| Sonstiges | Die zufällige Bucket-Nummer der Nutzer:innen. |
| Empfangene Canvas-Nachrichten | Canvas-Nachrichten, die diese Nutzer:innen erhalten haben, und wann. Die Sendezeitpunkte folgen denselben Kanalregeln wie Empfangene Campaigns; siehe Wann Campaigns unter „Empfangene Campaigns“ erscheinen. Wenn eine Nachricht empfangen, geöffnet oder angeklickt wird, aktualisiert Braze die Daten für alle Profile, die denselben Kanalbezeichner wie das Profil teilen, das die Interaktion protokolliert hat (z. B. dieselbe E-Mail-Adresse für E-Mail oder dieselbe Telefonnummer für SMS oder WhatsApp). Nutzer:innen, die einen Bezeichner mit jemandem teilen, der die Nachricht empfangen, geöffnet oder angeklickt hat, können diesen Filter erfüllen, auch wenn sie ursprünglich nicht in der Campaign waren oder die Nachricht nicht direkt erhalten haben. Wählen Sie eine Nachricht aus der Liste aus, um sie anzuzeigen. |
| Prognosen | Churn-Prognose und Event-Prognose für diese Nutzer:innen. |
Event-Verlauf

Um den Tab Event-Verlauf anzuzeigen, benötigen Sie die Berechtigungen Search Users, View User Event Properties und View PII, da Event-Eigenschaften personenbezogene Daten enthalten können.
Der Tab Event-Verlauf zeigt die angepassten Events und Käufe, die Nutzer:innen protokolliert haben. Verwenden Sie ihn, um zu überprüfen, ob Event-Daten korrekt eingehen, und um Probleme auf Nutzerebene direkt im Dashboard zu beheben – ohne Datenexporte oder externe Tools.
| Event-Verlauf-Kategorie | Enthält |
|---|---|
| Event-Liste | Angepasste Events und Käufe der letzten 30 Tage (bis zu 100 neueste), sortiert nach Aktualität. |
| Event-Typ | Ob die Zeile ein angepasstes Event oder ein Kauf ist. |
| Zeitstempel | Wann das Event protokolliert wurde. |
| Event-Name | Der Name des angepassten Events oder Kaufs. |
| Event-Eigenschaften | Vollständige Event-Eigenschaften für das Event, dargestellt als JSON. |
Wann Campaigns unter „Empfangene Campaigns“ erscheinen
Im Allgemeinen listet Braze eine Campaign unter Empfangene Campaigns auf, nachdem versucht wurde, die Nachricht zu senden. Eine Zustellung an das Gerät oder den Posteingang der Nutzer:innen ist nicht erforderlich, damit ein Versand protokolliert wird. Empfangene Canvas-Nachrichten folgt denselben kanalspezifischen Regeln für jeden Canvas-Nachrichtentyp.

Wenn Zeitstempel im relativen Format angezeigt werden (z. B. „vor 6 Tagen“), fahren Sie mit der Maus darüber, um das genaue Datum und die Uhrzeit zu sehen.
- E-Mail: Braze protokolliert einen Versand, wenn die Nachricht an Ihren E-Mail-Anbieter (ESP) übergeben wird. Nach dieser Übergabe wird die Nachricht nicht aufgrund von Liquid-Logik, Rate-Limiting oder weil die Nutzer:innen als nicht erreichbar markiert sind, abgebrochen. Die nächsten Ereignisse sind oft eine Zustellung oder ein Bounce.
- Push: Braze protokolliert einen Versand, wenn die Nachricht an den Push-Anbieter übergeben wird (z. B. Apple Push Notification service (APNs) oder Firebase Cloud Messaging (FCM)). Der Anbieter versucht in der Regel, sofort zuzustellen; wenn das Gerät nicht verfügbar ist (z. B. offline), kann der Anbieter es erneut versuchen, bis die Nachricht abläuft.
- In-App Messages: Braze protokolliert einen Versand, wenn die Campaign gestartet wird.
- Content Cards: Wann Braze ein Gesendet-Event aufzeichnet, hängt vom Zustellungstyp und Ihrer Einstellung Card Creation ab. Eine Content-Card-Campaign erscheint unter Empfangene Campaigns im Nutzerprofil erst, nachdem die Nutzer:innen die Karte in der App angesehen haben. Die vollständige Aufschlüsselung finden Sie unter Wann Versendungen protokolliert werden und Empfangene Campaigns und Retargeting-Filter im Artikel zum Content-Card-Reporting.
- SMS, WhatsApp und Webhooks: Braze protokolliert einen Versand, wenn die Nachricht den Zustellungspfad für diesen Kanal betritt (z. B. den SMS- oder WhatsApp-Anbieter oder Ihren Webhook-Endpunkt).

Diese Beschreibungen behandeln, wann ein Versand für Empfangene Campaigns protokolliert wird. Sie sind getrennt von Nachrichtenabbrüchen, die eine Nachricht stoppen können, bevor sie einen Anbieter erreicht.

Tab „Nachrichtenverlauf“
Der Tab Nachrichtenverlauf des Nutzerprofils zeigt aktuelle nachrichtenbezogene Ereignisse (ca. 40) für einzelne Nutzer:innen aus den letzten 30 Tagen. Diese Ereignisse umfassen die Nachrichten, die den Nutzer:innen gesendet wurden, die sie empfangen und mit denen sie interagiert haben, und mehr.
Die Daten in diesem Tab werden nach einer Zusammenführung von Nutzer:innen nicht aktualisiert. Außerdem erscheinen Ereignisse, die mit über die API gesendeten Nachrichten verknüpft sind (z. B. der Endpunkt /messages/send), nicht in diesem Tab, wenn in diesen Sendungen keine Campaign-ID angegeben ist.

RCS-Ereignisse werden derzeit im Tab Nachrichtenverlauf nicht unterstützt.

Ereignisse anzeigen und verstehen
Für jedes Ereignis in der Tabelle Nachrichtenverlauf können Sie den Messaging-Kanal, den Ereignistyp, den Zeitstempel des Ereignisses, die zugehörige Campaign oder Canvas-Nachricht und die Gerätedaten der Nutzer:innen sehen. Um nach bestimmten Ereignissen zu filtern, klicken Sie auf Filter und wählen Sie Ereignisse aus der Liste aus.
Nachrichteninteraktions-Ereignisse
Die folgenden Nachrichteninteraktions-Ereignisse sind für E-Mail, SMS, Push, In-App Messages, Content Cards und Webhooks verfügbar. Weitere Informationen darüber, wie bestimmte Ereignisse getrackt werden, finden Sie im Glossar der Nachrichteninteraktions-Ereignisse.
| Kanal | Verfügbare Engagement-Ereignisse |
|---|---|
| Bounce Klick Verzögerungsereignisse Zustellung Als Spam markieren Öffnung (siehe Hinweis zum E-Mail-Öffnungsereignis) Versand Soft Bounce Abmeldung |
|
| SMS | Carrier-Versand Zustellung Zustellungsfehler Eingehender Empfang Ablehnung Versand |
| Push | Bounce Beeinflusste Öffnung iOS Foreground Öffnung Versand |
| In-App-Nachricht | Klick Impression |
| Content Cards | Klick Verwerfen Impression Versand |
| Webhooks | Versand |
| Abbruch Zustellung Fehler Frequency-Capping Eingehender Empfang Gelesen Versand |
Nachrichtenabbruch-Ereignisse
Nachrichtenabbruch-Ereignisse treten auf, wenn eine an Nutzer:innen gesendete Nachricht aufgrund von bedingter Logik in Liquid oder Connected-Content oder durch Liquid-Rendering-Timeouts abgebrochen wurde.
Abbruch-Ereignisse sind für die folgenden Kanäle verfügbar:
- SMS
- Push
- Webhooks
Abbruch-Ereignisse sind derzeit nicht für In-App Messages und Content Cards verfügbar.
Frequency-Capping-Ereignisse
Ein Frequency-Capping-Ereignis tritt auf, wenn Nutzer:innen für den Empfang einer Nachricht qualifiziert sind, diese aber aufgrund von Frequency-Capping-Einstellungen nicht tatsächlich erhalten. Sie können die Frequency-Capping-Einstellungen unter Einstellungen > Frequency-Capping-Regeln anpassen.
Leere Ziele
Einige Nachrichtenversendungen können im Nachrichtenverlauf mit leeren Zielen erscheinen (gekennzeichnet durch „—“). Dies liegt daran, dass einige Kanäle, wie Content Cards und Webhooks, beim Nachrichtenversand keine Gerätedaten erfassen.
Content-Card-Versendungen werden protokolliert, wenn die Karte zur Ansicht verfügbar ist. Da Content Cards auf mehreren Geräten angesehen werden können, werden Gerätedaten beim Versand nicht protokolliert. Stattdessen werden diese Informationen bei der Impression protokolliert (wenn die Karte tatsächlich angesehen wird). Webhooks werden an einen System-Endpunkt gesendet (nicht an ein Gerät), daher sind Gerätedaten nicht anwendbar.
Hinweis zum E-Mail-Öffnungsereignis
Das Tracking von E-Mail-Öffnungen ist in jedem Tool fehleranfällig, einschließlich Braze. Mit einer Vielzahl von Datenschutzfunktionen, die von verschiedenen E-Mail-Clients angeboten werden und entweder das automatische Laden von Bildern blockieren oder sie proaktiv auf dem Server laden, sind E-Mail-Öffnungsereignisse sowohl für falsch positive als auch für falsch negative Ergebnisse anfällig.
Während E-Mail-Öffnungsstatistiken in der Gesamtbetrachtung nützlich sein können, z. B. um die Wirksamkeit verschiedener Betreffzeilen zu vergleichen, sollten Sie nicht davon ausgehen, dass ein einzelnes Öffnungsereignis für einzelne Nutzer:innen aussagekräftig ist.
Warum sind bestimmte Felder im Tab „Nachrichtenverlauf“ leer?
Einige Felder können im Tab Nachrichtenverlauf von Nutzer:innen in den folgenden Szenarien fehlen:
- Wenn bei einem Ereignis Daten für Nachricht gesendet fehlen, bedeutet dies, dass die Campaign keine Nachrichtenvarianten hat.
- Wenn bei einem Ereignis Daten für Campaign/Canvas und Nachricht gesendet fehlen, bedeutet dies, dass diese Nachricht über eine API-Campaign (nicht API-getriggerte Campaigns) gesendet wurde, die
campaign_idundmessage_variation_idnicht angegeben hat. Diese Felder sind optional und können im Anfragekörper weggelassen werden. Wenn diese Felder angegeben werden, werden die Informationen in den Nachrichtenverlaufsprotokollen ausgefüllt.- Wenn eine bestimmte Nachricht im Nachrichtenverlauf vollständig fehlt, aber im Protokoll Empfangene Campaigns erscheint, haben die Nutzer:innen die Campaign wahrscheinlich erhalten, bevor sie als aktuelle Nutzer:innen identifiziert wurden. Wenn ein bestehendes Profil verwaist ist, wird das Protokoll Empfangene Campaigns übertragen, der Nachrichtenverlauf jedoch nicht.
- Wenn Daten für Campaign/Canvas fehlen, wurde möglicherweise ein manueller Test gesendet. Manuelle Tests werden im Tab Nachrichtenverlauf protokolliert, aber die Campaign oder der Canvas, die gesendet wurden, werden nicht protokolliert.
- Wenn Nutzer:innen in einer Seed-Gruppe oder einer anderen internen Testzielgruppe sind, kann der Nachrichtenverlauf im Vergleich zu Produktionsversendungen eingeschränkte Campaign- oder Canvas-Metadaten anzeigen.