Messaging-Diagnose-Dashboard
Das Messaging-Diagnose-Dashboard bietet eine allgemeine Aufschlüsselung der Ergebnisse beim Nachrichtenversand, mit der Sie Trends erkennen und potenzielle Probleme in Ihrem Messaging-Setup diagnostizieren können. Dieses Dashboard kann Ihnen helfen zu verstehen, warum Nachrichten aus Ihren Campaigns oder Canvases möglicherweise nicht wie erwartet gesendet wurden.

Das Messaging-Diagnose-Dashboard befindet sich derzeit im Early Access. Kontaktieren Sie Ihren Customer-Success-Manager, wenn Sie an der Teilnahme am Early Access interessiert sind.
Wichtige Konzepte
Gesendet und zugestellt
Es ist wichtig zu verstehen, dass dieses Dashboard darüber berichtet, wie Braze eine Nachricht intern verarbeitet hat – nicht über den endgültigen Zustellungsstatus der Nachricht.
Eine in diesem Dashboard als „gesendet“ markierte Nachricht bedeutet, dass Braze die Nachricht erfolgreich verarbeitet und versandt hat. Für die meisten Kanäle bedeutet dies, dass Braze die Nachricht an den entsprechenden Drittanbieter-Versandpartner übergeben hat. Es garantiert jedoch nicht die endgültige Zustellung an das Gerät der Nutzer:innen.
Wenn Braze eine Nachricht „sendet“, kann die endgültige Zustellung von externen Diensten abhängen. Betrachten Sie die folgenden Beispiele für jeden Kanal.
| Kanal | Beispiel für die endgültige Zustellung |
|---|---|
| Content Cards | Die Card wurde gesendet und ist zur Anzeige berechtigt. |
| Braze übergibt die Nachricht an einen E-Mail-Anbieter (ESP). Der ESP ist dann für die endgültige Zustellung verantwortlich. Dieser ESP kann beispielsweise einen „Bounce“ melden, wenn die E-Mail-Adresse ungültig ist oder das Postfach voll ist. | |
| In-App-Nachrichten | Die Nachricht wurde den Nutzer:innen angezeigt. |
| LINE | Die Nachricht wurde erfolgreich an einen Versandpartner übergeben. |
| Push | Braze übergibt die Nachricht an den entsprechenden Push-Benachrichtigungsdienst (wie Apple Push Notification Service für iOS oder Firebase Cloud Messaging für Android). Dieser Dienst ist für die endgültige Zustellung der Benachrichtigung an das Gerät verantwortlich. |
| SMS/MMS/RCS | Braze übergibt die Nachricht an ein SMS-Gateway (wie Twilio). Dieses Gateway ist für die endgültige Zustellung an den Mobilfunkanbieter verantwortlich. |
| Webhooks | Die Webhook-Anfrage wurde erfolgreich durchgeführt und hat eine 2xx-Antwort zurückgegeben. |
| Die Nachricht wurde erfolgreich an einen Versandpartner übergeben. |
Datenaktualität
Die Häufigkeit, mit der die Daten in diesem Dashboard aktualisiert werden, kann je nach Systemlast variieren. Obwohl die Aktualisierungshäufigkeit nicht garantiert wird, beträgt sie in den meisten Fällen wahrscheinlich weniger als eine Stunde.
Dashboard konfigurieren
Sie können auf das Diagnose-Dashboard zugreifen, indem Sie zu Analytics > Dashboard Builder navigieren und Messaging Diagnostics aus der Liste der von Braze erstellten Dashboards auswählen.
Um das Dashboard auszuführen und Ihre Daten anzuzeigen:
- Wählen Sie entweder Campaigns oder Canvases als Quelle für Ihre Dashboard-Berichte.
- Wählen Sie eine oder mehrere Campaigns oder Canvases aus.
- Wählen Sie Run Dashboard, um die Daten für Ihre ausgewählten Filter zu laden.

Daten interpretieren

Das Dashboard zeigt nur Daten der letzten sieben Tage an. Alle Zeitstempel werden in der Zeitzone Ihres Workspace angezeigt.
Zusammenfassungskacheln
Am oberen Rand der Seite befinden sich wichtige Zusammenfassungskacheln für Ihren ausgewählten Zeitraum, die Folgendes anzeigen:
- Total Aborts: Die Gesamtanzahl der abgebrochenen Nachrichten. Dies umfasst Canvas-Zielgruppenmitglieder, die den Canvas nicht betreten haben oder den Canvas verlassen haben, weil bei einem Schritt ein Fehler aufgetreten ist oder sie die Ausstiegskriterien erfüllt haben, während sie ein Ausstiegs-Event ausgeführt haben.
- Message Sends: Die Gesamtanzahl der Nachrichten, die Braze erfolgreich verarbeitet und gesendet hat.
- E-Mail, SMS/MMS/RCS, WhatsApp, LINE und Push: Die Nachricht wurde erfolgreich an einen Versandpartner übergeben.
- Webhooks: Die Webhook-Anfrage wurde erfolgreich durchgeführt und hat eine
2xx-Antwort zurückgegeben. - Content Cards: Die Card wurde gesendet und ist zur Anzeige berechtigt.
- In-App-Nachrichten: Die Nachricht wurde den Nutzer:innen angezeigt.
Nachrichtenergebnisse im Zeitverlauf
Dieses Zeitreihen-Chart zeigt eine tägliche Aufschlüsselung der verschiedenen Gründe, warum eine Nachricht abgebrochen oder Nutzer:innen aus einem Canvas entfernt wurden. Dieses Chart zeigt nicht die Anzahl der Sends an.

Um das Chart übersichtlich zu halten, werden Abbruch- oder Drop-Gründe mit null Vorkommen in Ihrem ausgewählten Zeitraum nicht im Chart angezeigt.
Detailliertes Protokoll der Nachrichtenergebnisse
Unterhalb des Zeitreihen-Charts zeigt das Dashboard eine detaillierte Tabelle einzelner Nachrichtenergebnisse für Ihre ausgewählten Filter und den Zeitraum. Verwenden Sie diese Tabelle, um bestimmte Datensätze zu überprüfen, einschließlich Zeitstempel, Nutzer-ID, Canvas-Schritt, Ergebnis und Kanal.
Sie können die Tabelle filtern, um sich auf bestimmte Datensätze zu konzentrieren:
- Nach Ergebnis filtern: Wählen Sie ein Ergebnis aus dem Ergebnisfilter, um nur Zeilen mit diesem Ergebnis anzuzeigen (z. B.
Frequency cappedoderUser not eligible). - Nach Nutzer-ID suchen: Geben Sie eine Nutzer-ID in das Suchfeld ein, um Zeilen für diese bestimmten Nutzer:innen anzuzeigen.
Wenn Sie beide Filter anwenden, gibt die Tabelle Zeilen zurück, die sowohl dem ausgewählten Ergebnis als auch der eingegebenen Nutzer-ID entsprechen.
Abbruchergebnisse
Die folgenden Definitionen erklären die im Dashboard angezeigten Abbruchergebnisse. Die Ergebnisse sind nach Kategorien gruppiert, um das Auffinden des gesuchten Ergebnisses zu erleichtern.
Inhalt und Rendering
| Abbruchergebnis | Erklärung |
|---|---|
| Content-Card abgelaufen | Die Content-Card ist abgelaufen, bevor die Nutzer:innen sie gesehen haben. |
| Content-Card ungültig | Die Content-Card enthielt Fehler und wurde nicht an die Nutzer:innen gesendet. Einige häufige Gründe dafür sind:
|
| Connected-Content fehlgeschlagen | Braze hat versucht, die Nachricht zu senden, aber Connected-Content ist nach der maximalen Anzahl von Wiederholungsversuchen (Standard ist fünf) fehlgeschlagen. Hinweis: Diese Zahl stellt die Anzahl der Nachrichten dar, die aufgrund des Erreichens der maximalen Anzahl von Wiederholungsversuchen abgebrochen wurden, nicht die Gesamtanzahl der fehlgeschlagenen Connected-Content-Anfragen. |
| In-App-Nachrichten-Rendering-Timeout | Nach mehreren Wiederholungsversuchen konnte das Liquid nicht gerendert werden und es kam zu einem Timeout. |
| Liquid-Abbruch | Der abort_message-Liquid-Tag wurde aufgerufen, sodass der Versand abgebrochen wurde. |
| Liquid-Rendering-Timeout | Das Rendern des Liquid-Templates hat zu lange gedauert. Tritt am häufigsten bei Bannern, In-App-Nachrichten und E-Mails auf. |
| Liquid-Syntaxfehler | Das Liquid-Template hatte einen Parsing-Fehler, sodass die Nachricht abgebrochen wurde. |
Campaign- und Canvas-Status
| Abbruchergebnis | Erklärung |
|---|---|
| Verzögerungsschritt fehlgeschlagen | Der Verzögerungsschritt ist fehlgeschlagen, wodurch die Nutzer:innen den Canvas verlassen haben. Dieser Fehler kann auftreten, wenn:
|
| Ausnahme- oder Ausstiegs-Event | Die Nutzer:innen waren zuvor berechtigt, die Nachricht zu erhalten, haben aber entweder
|
| Inactive campaign | Die Campaign wurde gestoppt, während die Nachricht unterwegs war, sodass sie abgebrochen wurde. |
| Inactive Canvas | Der Canvas wurde gestoppt, bevor die Nutzer:innen die Journey betreten haben. |
| Inactive Canvas step | Dies kann im Canvas auftreten, wenn:
|
| Volumenlimit erreicht | Die Campaign hat das festgelegte Volumenlimit erreicht, sodass der Versand abgebrochen wurde. |
Rate-Limiting und Timing
| Abbruchergebnis | Erklärung |
|---|---|
| Frequency-Capping erreicht | Die Nutzer:innen haben bereits die maximale Anzahl an Nachrichten erhalten, die gemäß den Frequency-Capping-Regeln Ihres Workspace zulässig sind, sodass der Versand abgebrochen wurde. |
| Ruhezeiten-Abbruch | Ruhezeiten waren für die Campaign oder den Canvas-Schritt aktiviert, wobei der Fallback auf Nachricht abbrechen eingestellt war. Die Nutzer:innen haben die Campaign getriggert oder den Canvas-Nachrichtenschritt während der Ruhezeiten betreten, sodass die Nachricht abgebrochen wurde. Dies führt jedoch nicht dazu, dass die Nutzer:innen den Canvas verlassen. |
| Rate-Limiting über 72 Stunden | Die Nachricht wurde aufgrund von Rate-Limits für die Zustellgeschwindigkeit länger als 72 Stunden gedrosselt, sodass der Versand abgebrochen wurde. |
Nutzerberechtigung und Profil
| Abbruchergebnis | Erklärung |
|---|---|
| Doppelter Nutzerbezeichner | Mehrere Nutzer:innen mit einem übereinstimmenden Bezeichner (wie externe ID, E-Mail-Adresse, Telefonnummer) waren berechtigt, diese Nachricht zu erhalten. Um doppelte Sends an dieselben Nutzer:innen zu verhindern, wurde diese Nachricht abgebrochen. |
| Nutzer:innen haben Vorprüfung für Nachrichtenschritt nicht bestanden | Diese Vorprüfung wird vor den Zustellungsvalidierungen durchgeführt. In diesem Fall haben die Nutzer:innen die grundlegende Vorprüfung für diesen Nachrichtenschritt nicht bestanden (Nutzer:innen nicht gefunden oder nicht für den Kanal des Nachrichtenschritts berechtigt). Hinweis: Bei einem Mehrkanal-Nachrichtenschritt bedeutet dies, dass die Nutzer:innen nicht gefunden wurden; die Kanalberechtigung wird hier nur für Einkanal-Nachrichtenschritte geprüft. |
| Nutzer:innen haben Vorprüfung für getriggerte Nachricht nicht bestanden | Für eine getriggerte Nachricht führt Braze einen ersten Durchlauf grundlegender Vorprüfungen für Zielgruppenberechtigung, Wiederberechtigung und Kanalberechtigung durch, bevor eine Nachricht aus diesem Trigger erstellt wird. |
| Nutzer:innen nicht mehr berechtigt | Die Nutzer:innen waren ursprünglich in der Zielgruppe, entsprachen aber nicht mehr den Zielgruppenkriterien, bevor Braze die Nachricht gesendet oder sie in den Canvas aufgenommen hat. Die Zeit zwischen dem ursprünglichen Erfüllen der Zielgruppenkriterien und dem Herausfallen aus der Zielgruppe kann auf Verzögerungen zurückzuführen sein durch:
|
| Nutzer:innen nicht für Schritt berechtigt | Die Nutzer:innen haben die festgelegten Zustellungsvalidierungen für den Nachrichtenschritt nicht erfüllt oder waren Teil einer Unterdrückungsliste. Abhängig von den Einstellungen der Zustellungsvalidierungen haben die Nutzer:innen den Canvas verlassen oder sind zum nächsten Schritt weitergegangen. |
| Nutzer:innen nicht wiederberechtigt | Die Nutzer:innen waren berechtigt, die Nachricht zu erhalten oder den Canvas zu betreten, aber der Versand wurde aufgrund von Wiederberechtigungs- oder Wiedereintrittseinstellungen abgebrochen. Dies kann passieren, wenn die Nutzer:innen die Campaign bereits erhalten haben oder den Canvas zu kürzlich betreten haben, wenn ein anderer Versand für dieselbe Campaign bereits für diese Nutzer:innen läuft, oder wenn die Wiederberechtigung oder der Wiedereintritt deaktiviert ist. |
| Nutzerprofil nicht gefunden | Die Nutzer:innen haben entweder nie existiert oder existieren nicht mehr in Braze. Einige häufige Fälle sind:
|
Kanal und Zustellung
| Abbruchergebnis | Erklärung |
|---|---|
| Partner-Zustellungs-Timeout | Braze hat 24 Stunden lang versucht, diese Nachricht an Ihren Zustellungspartner zu senden, aber der Partner hat während des gesamten Zeitfensters temporäre Fehler zurückgegeben. |
| Push-Zugangsdaten ungültig | Die Push-Zugangsdaten für diese App fehlen oder sind ungültig, sodass der Versand abgebrochen wurde. Aktualisieren Sie Ihre Zugangsdaten in den App Settings. |
| Nutzer:innen nicht für Android-Push, App oder Gerät aktiviert | Push kann nicht an diese Nutzer:innen gesendet werden. Einige häufige Gründe:
|
| Nutzer:innen nicht für iOS-Push, App oder Gerät aktiviert | Gleich wie das Abbruchergebnis „Nutzer:innen nicht für Android-Push, App oder Gerät aktiviert“. |
| Nutzer:innen nicht für Kindle-Push, App oder Gerät aktiviert | Gleich wie das Abbruchergebnis „Nutzer:innen nicht für Android-Push, App oder Gerät aktiviert“. |
| Nutzer:innen nicht für Web-Push, App oder Gerät aktiviert | Gleich wie das Abbruchergebnis „Nutzer:innen nicht für Android-Push, App oder Gerät aktiviert“. |
| Nutzer:innen nicht für Content Cards aktiviert | Die Nutzer:innen haben keine Apps verwendet, die diese Content-Card enthalten. |
| Nutzer:innen nicht für E-Mail aktiviert | E-Mails können nicht an diese Nutzer:innen gesendet werden. Einige häufige Gründe:
|
| Nutzer:innen nicht für LINE aktiviert | LINE-Nachrichten können nicht an diese Nutzer:innen gesendet werden. Einige häufige Gründe:
|
| Nutzer:innen nicht für SMS/MMS/RCS aktiviert | SMS-Nachrichten können nicht an diese Nutzer:innen gesendet werden. Einige häufige Gründe:
|
| Nutzer:innen nicht für WhatsApp aktiviert | WhatsApp-Nachrichten können nicht an diese Nutzer:innen gesendet werden. Einige häufige Gründe:
|
| Webhook fehlgeschlagen | Der Webhook hat einen nicht erfolgreichen Antwortcode (nicht 2xx) erhalten. Weitere Details finden Sie im Nachrichten-Aktivitätsprotokoll. Protokolle, die älter als 60 Stunden sind, werden bereinigt und sind nicht mehr zugänglich; Webhook-Fehler werden mit bis zu 20 Protokollen pro Stunde erfasst. |
Häufig gestellte Fragen
Was bedeutet ein „Vorprüfungs“-Fehler?
Eine „Vorprüfung“ bezieht sich auf eine schnelle, gebündelte Validierungsprüfung, die ganz am Anfang einer Pipeline-Stufe ausgeführt wird (z. B. wenn eine Nachricht getriggert wird oder ein Canvas-Nachrichtenschritt gesendet wird). Stellen Sie sich dies als einen frühen Ausstieg vor, der auf maximale Geschwindigkeit ausgelegt ist. Anstatt viele separate, ressourcenintensive Prüfungen durchzuführen (wie die Validierung jedes Details eines Nutzerprofils), bündelt Braze mehrere grundlegende Validierungen in einem „ersten Durchlauf“.
Wenn Nutzer:innen diese einzelne gebündelte Prüfung nicht bestehen, werden sie sofort entfernt. Dieser gebündelte Ansatz ermöglicht es Braze, massive Nachrichtenvolumen mit hoher Geschwindigkeit zu verarbeiten, und kann zu einer schnelleren, stabileren Performance Ihrer Campaigns und Canvases beitragen, indem die Verarbeitungslatenz für jede Nachricht reduziert wird.
Was bedeutet ein „Sonstiges“-Abbruchergebnis?
Dies sind Abbrüche, die in keine der bestehenden Braze-Kategorien fallen. Wenn Sie einen großen Anteil an Abbrüchen mit diesem Ergebnis feststellen, kontaktieren Sie den Braze-Support für weitere Unterstützung.
Warum ist die Summe von Total Aborts und Message Sends niedriger als meine erwartete Zielgruppengröße?
Dies kann mehrere Gründe haben:
- Zielgruppenkriterien: Weniger Nutzer:innen als erwartet haben möglicherweise die Zielgruppenkriterien erfüllt (z. B. waren sie nicht im Segment oder hatten nicht die erforderlichen Attribute), als die Campaign oder der Canvas gestartet wurde.
- Verarbeitung läuft: Nachrichten werden möglicherweise noch aktiv verarbeitet. Nutzer:innen befinden sich möglicherweise noch in früheren Schritten des Canvas und haben noch keine Nachrichtenschritte erreicht.
- Datenaktualität: Die Dashboard-Daten werden ungefähr alle 15 Minuten aktualisiert, dies ist jedoch nicht garantiert. Die neuesten Daten für diese Campaign oder diesen Canvas haben das Dashboard möglicherweise noch nicht erreicht.
- Sonderfälle: Es besteht eine geringe Wahrscheinlichkeit, dass Sie auf einen Sonderfall stoßen, der derzeit nicht in diesem Dashboard erfasst wird. Wenn Sie dies vermuten, kontaktieren Sie den Braze-Support.
Warum ist die Summe von Total Aborts und Message Sends größer als die Zielgruppe einer Campaign oder eines Canvas?
Dies kann aus folgenden Gründen auftreten:
- Mehrkanal-Nachrichten: Die Campaign oder der Canvas-Schritt war so konfiguriert, dass über mehrere Kanäle gesendet wird (z. B. SMS und E-Mail). Einzelne Nutzer:innen können ein „Gesendet“-Ergebnis für einen Kanal (z. B. E-Mail) und ein „Abbruch“-Ergebnis für einen anderen erhalten (z. B. „Nutzer:innen nicht für SMS/MMS/RCS aktiviert“). In diesem Fall würden diese Nutzer:innen im Chart zweimal gezählt: einmal als „Gesendet“ und einmal als „Abbruch“.
- Beispiel: Sie senden eine Push-Campaign an 100 Nutzer:innen, die sowohl iOS als auch Android anspricht. Wenn Nutzer:innen nur ein iOS-Gerät haben, erhalten sie den iOS-Push („Gesendet“), lösen aber auch einen Abbruch für den Android-Push aus („Nutzer:innen nicht für Android-Push, App oder Gerät aktiviert“).
- Mehrere Nachrichtenschritte (nur Canvas): Ihr Canvas kann mehr als einen Nachrichtenschritt in einem bestimmten Pfad haben. Dieses Dashboard aggregiert alle Ergebnisse, sodass einzelne Nutzer:innen mehrfach gezählt werden können, wenn sie innerhalb des ausgewählten Zeitraums mehrere Nachrichtenschritte durchlaufen.
- Testnachrichten: Testversand (der im Dashboard gezählt wird) lässt die Gesamtzahlen höher erscheinen als die Zielgruppengröße.