Skip to content

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.

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 Nachricht, die in diesem Dashboard als „gesendet“ markiert ist, bedeutet, dass Braze die Nachricht erfolgreich verarbeitet und versendet hat. Bei den meisten Kanälen bedeutet dies, dass Braze die Nachricht an den entsprechenden Drittanbieter-Versandpartner übergeben hat. Dies garantiert jedoch nicht die endgültige Zustellung auf 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.
E-Mail Braze übergibt die Nachricht an einen E-Mail-Anbieter (E-Mail-Anbieter). Der E-Mail-Anbieter ist dann für die endgültige Zustellung verantwortlich. Der E-Mail-Anbieter kann beispielsweise einen „Bounce“ melden, wenn die E-Mail-Adresse ungültig oder der Posteingang voll ist.
In-App Messages Die Nachricht wurde von den Nutzer:innen angesehen und eine Impression wurde protokolliert.
LINE Die Nachricht wurde erfolgreich an einen Versandpartner übergeben.
Push Braze übergibt die Nachricht an den entsprechenden Push-Benachrichtigungsdienst (z. B. 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 auf 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 gestellt und hat eine 2xx-Antwort zurückgegeben.
WhatsApp Die Nachricht wurde erfolgreich an einen Versandpartner übergeben.

Datenaktualität

Die Häufigkeit, mit der 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 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.

So führen Sie das Dashboard aus und zeigen Ihre Daten an:

  1. Wählen Sie entweder Campaigns oder Canvases als Quelle für Ihre Dashboard-Berichte aus.
  2. Wählen Sie eine oder mehrere Campaigns oder Canvases aus.
  3. Wählen Sie Run Dashboard aus, um die Daten für Ihre ausgewählten Filter zu laden.

Beispiel für Campaign- und Canvas-Diagnose vom 25. bis 31. Mai 2025 für eine Willkommensserie-Campaign. Beispiel für Campaign- und Canvas-Diagnose mit Hover-Diagramm vom 25. bis 31. Mai 2025 für eine Willkommensserie-Campaign.

Daten interpretieren

Zusammenfassungskacheln

Oben auf der Seite befinden sich wichtige Zusammenfassungskacheln für den ausgewählten Zeitraum, die Folgendes anzeigen:

  • Gesendet: 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 Messages: Die Nachricht wurde der/dem Nutzer:in angezeigt.
  • Nicht gesendet: Die Gesamtanzahl der Nachrichten, die abgebrochen wurden. Dazu gehören Canvas-Zielgruppenmitglieder, die nicht in den Canvas eingetreten sind oder den Canvas verlassen haben, weil ein Schrittfehler aufgetreten ist oder sie die Exit-Kriterien beim Ausführen eines Exit-Events erfüllt haben.

Nachrichtenergebnisse im Zeitverlauf

Dieses Zeitreihendiagramm zeigt eine stündliche Aufschlüsselung, warum eine Nachricht abgebrochen wurde oder warum Nutzer:innen aus einem Canvas entfernt wurden. Ergebnisbezeichnungen in diesem Chart sind normalisierte Dashboard-Bezeichnungen, keine Rohwerte aus dem Event-Payload. Dieses Chart zeigt nicht die Anzahl der Sendungen an.

Detailliertes Protokoll der Nachrichtenergebnisse

Das Dashboard zeigt eine detaillierte Tabelle einzelner Nachrichtenergebnisse für Ihre ausgewählten Filter und den Zeitraum. Verwenden Sie diese Tabelle, um einzelne Datensätze zu überprüfen, einschließlich Zeitstempel, Nutzer-ID, Canvas-Schritt, Ergebnis, Details 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 (zum Beispiel Frequency capped oder User not eligible for channel).
  • Nach Nutzer-ID suchen: Geben Sie eine Nutzer-ID in das Suchfeld ein, um Zeilen für diese/n bestimmte/n Nutzer:in 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.

Wählen Sie eine Zeile in der Tabelle aus, um das Detailpanel zu öffnen. Das Detailpanel bietet zusätzlichen Kontext zu diesem Ergebnis, und Ask Operator liefert Anleitungen zur Fehlerbehebung, um Ihnen bei der Untersuchung des zugrunde liegenden Problems zu helfen.

Detailliertes Protokoll der Messaging-Diagnose mit einer ausgewählten Zeile und Zugang zum Detailpanel. Erweitertes Detailpanel der Messaging-Diagnose mit Ergebniskontext und Anleitungen zur Fehlerbehebung.

Abbruchergebnisse

Die folgenden Definitionen erklären die im Dashboard angezeigten Abbruchergebnisse. Die Ergebnisse sind nach Kategorien gruppiert, damit Sie das gesuchte Ergebnis leichter finden können.

Inhalt und Rendering

Abbruchergebnis Erklärung
Content Card abgelaufen Die Content Card ist abgelaufen, bevor die/der Nutzer:in sie gesehen hat.
Content Card ungültig Die Content Card enthielt Fehler und wurde nicht an die/den Nutzer:in gesendet. Häufige Gründe hierfür sind:
  • Maximale Größe überschritten (2 KB)
  • Ablaufdatum ist ungültig
  • Nachricht enthält ungültige Zeichen
Connected Content fehlgeschlagen Braze hat versucht, die Nachricht zu senden, aber Connected Content ist nach der maximalen Anzahl von Wiederholungsversuchen (standardmäßig fünf) fehlgeschlagen. Hinweis: Diese Zahl stellt die Anzahl der Nachrichten dar, die aufgrund des Erreichens der maximalen Wiederholungsversuche abgebrochen wurden, nicht die Gesamtzahl fehlgeschlagener Connected-Content-Anfragen.
In-App-Nachricht Rendering-Timeout Nach mehreren Wiederholungsversuchen konnte das Liquid nicht gerendert werden und hat ein Timeout erreicht.
Liquid-Abbruch Der abort_message-Liquid-Tag wurde aufgerufen, daher wurde der Versand abgebrochen.
Liquid-Rendering-Timeout Das Rendern des Liquid-Templates hat zu lange gedauert. Dies tritt am häufigsten bei Banner, In-App-Nachrichten und E-Mails auf.
Liquid-Syntaxfehler Das Liquid-Template enthielt einen Parsing-Fehler, daher wurde die Nachricht abgebrochen.
Medien-URL-Fehler Braze konnte die Medien-URL in der Nachricht nicht verarbeiten. Dies kann passieren, wenn die URL blockiert oder ungültig ist, ein Timeout erreicht, einen ungültigen HTTP-Status zurückgibt oder die SSL-Validierung fehlschlägt.

Campaign- und Canvas-Status

Abbruchergebnis Erklärung
Verzögerungsschritt fehlgeschlagen Der Verzögerungsschritt ist fehlgeschlagen, wodurch die/der Nutzer:in den Canvas verlassen hat. Dieser Fehler kann auftreten, wenn:
  • Die für den personalisierten Verzögerungsschritt angegebene Variable leer oder ein ungültiger Typ war
  • Die Verzögerung die maximal zulässige Dauer innerhalb des Canvas überschreitet
Ausnahme- oder Exit-Event Die/Der Nutzer:in war zuvor berechtigt, die Nachricht zu erhalten, hat aber entweder
  • ein Ausnahme-Event für eine aktionsbasierte Campaign ausgeführt, sodass die Nachricht abgebrochen wurde, oder
  • die Canvas-Exit-Kriterien erfüllt und wurde daher mitten in der Journey entfernt.
Inaktive Campaign Die Campaign wurde gestoppt, während die Nachricht unterwegs war, daher wurde sie abgebrochen.
Inaktiver Canvas Der Canvas wurde gestoppt, bevor die/der Nutzer:in die Journey betreten hat.
Inaktiver Canvas-Schritt Dies kann im Canvas auftreten, wenn:
  • Der Canvas-Schritt gelöscht wurde
  • Der Canvas gestoppt wurde, wodurch alle Schritte inaktiv werden
Volumenlimit erreicht Die Campaign hat das festgelegte Volumenlimit erreicht, daher wurde der Versand abgebrochen.

Rate-Limiting und Timing

Abbruchergebnis Erklärung
Frequency-Capping erreicht Die/Der Nutzer:in hat bereits die maximale Anzahl an Nachrichten erhalten, die gemäß den Frequency-Capping-Regeln Ihres Workspace zulässig sind, daher wurde der Versand abgebrochen.
Ruhezeiten-Abbruch Ruhezeiten waren für die Campaign oder den Canvas-Schritt aktiviert, wobei der Fallback auf Nachricht abbrechen eingestellt war. Die/Der Nutzer:in hat die Campaign getriggert oder den Canvas-Nachrichtenschritt während der Ruhezeiten betreten, daher wurde die Nachricht abgebrochen. Dies bewirkt jedoch nicht, dass die/der Nutzer:in den Canvas verlässt.
Rate-Limiting über 72 Stunden Die Nachricht wurde aufgrund von Zustellgeschwindigkeits-Rate-Limits länger als 72 Stunden gedrosselt, daher wurde der Versand abgebrochen.

Nutzerberechtigung und Profil

Abbruchergebnis Erklärung
Doppelter Nutzerbezeichner Mehrere Nutzer:innen mit übereinstimmendem Bezeichner (wie externe ID, E-Mail-Adresse, Telefonnummer) waren berechtigt, diese Nachricht zu erhalten. Um doppelte Sendungen an dieselbe Person zu vermeiden, wurde diese Nachricht abgebrochen.
Nutzer:in hat Vorprüfung für Nachrichtenschritt nicht bestanden Braze führt eine erste Runde grundlegender Vorprüfungen für Zielgruppenberechtigung, Wiederberechtigung und Kanalberechtigung durch, bevor die vollständigen Zustellungsvalidierungen für einen Canvas-Nachrichtenschritt erfolgen. Dieses Ergebnis bedeutet, dass die/der Nutzer:in oder die Nachricht eine dieser Prüfungen nicht bestanden hat, daher wurde die Nachricht für diesen Schritt abgebrochen.
Nutzer:in hat Vorprüfung für getriggerte Nachricht nicht bestanden Braze führt eine erste Runde grundlegender Vorprüfungen für Zielgruppenberechtigung, Wiederberechtigung und Kanalberechtigung durch, bevor eine Nachricht zum Senden aus diesem Trigger erstellt wird. Dieses Ergebnis bedeutet, dass die/der Nutzer:in oder die Nachricht eine dieser Prüfungen nicht bestanden hat, daher wurde die Nachricht abgebrochen.
Nutzer:in nicht mehr berechtigt Die/Der Nutzer:in war ursprünglich in der Zielgruppe, hat aber die Zielgruppenkriterien nicht mehr erfüllt, bevor Braze die Nachricht gesendet oder die/den Nutzer:in in den Canvas aufgenommen hat. Die Zeitspanne zwischen dem ursprünglichen Erfüllen der Zielgruppenkriterien und dem Herausfallen aus der Zielgruppe kann durch Verzögerungen verursacht werden durch:
  • Intelligentes Timing
  • Ruhezeiten
  • Ortszeit
  • Zustellgeschwindigkeits-Rate-Limits (nicht zutreffend für Canvas-Entry)
  • Messaging-Pipeline-Verzögerungen
Nutzer:in nicht für Schritt berechtigt Die/Der Nutzer:in hat die festgelegten Zustellungsvalidierungen für den Nachrichtenschritt nicht erfüllt oder war Teil einer Unterdrückungsliste. Abhängig von den Einstellungen der Zustellungsvalidierungen hat die/der Nutzer:in den Canvas möglicherweise verlassen oder ist zum nächsten Schritt weitergegangen.
Nutzer:in nicht wiederberechtigt Die/Der Nutzer:in war 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/der Nutzer:in die Campaign bereits zu kürzlich erhalten hat oder in den Canvas eingetreten ist, wenn ein anderer Versand für dieselbe Campaign bereits für diese/n Nutzer:in läuft, oder wenn die Wiederberechtigung oder der Wiedereintritt deaktiviert ist.
Kundenprofil nicht gefunden Die/Der Nutzer:in hat entweder nie existiert oder existiert nicht mehr in Braze. Häufige Fälle umfassen:
  • Die/Der Nutzer:in wurde über API-Messaging angesprochen, existierte aber nie in Braze.
  • Die/Der Nutzer:in wurde gelöscht, bevor die Nachricht gesendet oder der Canvas-Schritt ausgeführt wurde.
  • Die/Der Nutzer:in wurde mit einem anderen Profil zusammengeführt, bevor die Nachricht gesendet wurde.

Kanal und Zustellung

Abbruchergebnis Erklärung
Zustellungsfehler des Partners Braze hat 24 Stunden lang versucht, diese Nachricht an Ihren Zustellungspartner zu senden, aber der Partner hat während des gesamten Zeitraums temporäre Fehler zurückgegeben.
Push-Zugangsdaten ungültig Die Push-Zugangsdaten für diese App fehlen oder sind ungültig, daher wurde der Versand abgebrochen. Aktualisieren Sie Ihre Zugangsdaten in den App-Einstellungen.
Abo-Gruppen-Fehler Die Nachricht konnte aufgrund von Problemen mit der Abo-Gruppen- oder Messaging-Service-Konfiguration nicht gesendet werden. Häufige Gründe sind fehlende Sendenummern für SMS oder WhatsApp oder nicht unterstütztes MMS im konfigurierten Messaging-Service.
Nutzer:in nicht für Kanal berechtigt Die/Der Nutzer:in ist nicht berechtigt, diese Nachricht auf dem ausgewählten Kanal zu empfangen. Häufige Gründe sind fehlende oder ungültige Kanalbezeichner, keine berechtigten Push-Token, Abo-Status-Einschränkungen, nicht unterstützte Kanalfunktionen oder blockierte Länder für telefonbasierte Kanäle.
Webhook fehlgeschlagen Der Webhook hat einen fehlerhaften Antwortcode (nicht 2xx) erhalten. Häufige Fehlercodes sind 4XX-Client-Fehler, 5XX-Server-Fehler oder Timeout, oder 598 Host Unhealthy oder kurzzeitig angehaltene Anfragen.

Häufig gestellte Fragen

Was bedeutet ein „Pre-Check“-Fehler?

Ein „Pre-Check“ bezeichnet eine schnelle, gebündelte Validierungsprüfung, die ganz am Anfang einer Pipeline-Stufe ausgeführt wird (z. B. wenn eine Nachricht getriggert oder ein Canvas-Nachrichten-Schritt gesendet wird). Stellen Sie sich das als einen frühen Abbruch vor, der auf maximale Geschwindigkeit ausgelegt ist. Anstatt viele einzelne, 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 ausgeschlossen. Dieser gebündelte Ansatz ermöglicht es Braze, große Mengen an Nachrichten 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 Abbruchgrund „Sonstige“?

Dies sind Abbrüche, die nicht in bestehende Dashboard-Kategorien fallen. Wenn Sie weiterhin einen großen Anteil an Abbrüchen mit „Sonstige“ feststellen, wenden Sie sich an den Braze-Support für weitere Unterstützung.

Warum ist die Summe von Nicht gesendet und Gesendet kleiner als meine erwartete Zielgruppengröße?

Dies kann verschiedene 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 das Canvas gestartet wurde.
  • Verarbeitung läuft noch: Nachrichten werden möglicherweise noch aktiv verarbeitet. Nutzer:innen befinden sich möglicherweise noch in früheren Schritten des Canvas und haben noch keine Nachrichten-Schritte 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 dieses Canvas haben das Dashboard möglicherweise noch nicht erreicht.
  • Sonderfälle: Es besteht eine geringe Möglichkeit, dass Sie auf einen Sonderfall stoßen, der zu diesem Zeitpunkt nicht in diesem Dashboard erfasst wird. Wenn Sie dies vermuten, wenden Sie sich an den Braze-Support.

Warum ist die Summe von Nicht gesendet und Gesendet größer als die Zielgruppe einer Campaign oder eines Canvas?

Dies kann folgende Gründe haben:

  • Mehrkanalige Nachrichten: Die Campaign oder der Canvas-Schritt wurde so konfiguriert, dass über mehrere Kanäle gesendet wird (z. B. SMS und E-Mail). Eine einzelne Nutzer:in kann ein „Gesendet“-Ergebnis für einen Kanal (z. B. E-Mail) und ein „Abbruch“-Ergebnis für einen anderen Kanal erhalten (z. B. „Nutzer:in nicht für Kanal berechtigt“). In diesem Fall würde diese eine Nutzer:in im Chart zweimal gezählt: einmal als „Gesendet“ und einmal als „Abbruch“.
    • Beispiel: Sie senden eine Push-Campaign an 100 Nutzer:innen und sprechen sowohl iOS als auch Android an. Wenn Nutzer:innen nur ein iOS-Gerät haben, erhalten sie die iOS-Push-Benachrichtigung („Gesendet“), lösen aber auch einen Abbruch für die Android-Push-Benachrichtigung aus („Nutzer:in nicht für Kanal berechtigt“).
  • Mehrere Nachrichten-Schritte (nur Canvas): Ihr Canvas kann mehr als einen Nachrichten-Schritt in einem bestimmten Pfad haben. Dieses Dashboard aggregiert alle Ergebnisse, sodass eine einzelne Nutzer:in mehrfach gezählt werden kann, wenn sie innerhalb des ausgewählten Zeitraums mehrere Nachrichten-Schritte durchläuft.
  • Testnachrichten: Testversand (der im Dashboard gezählt wird) kann die Gesamtzahlen höher als die Zielgruppengröße erscheinen lassen.
New Stuff!