Messaging Observability

Messaging Observability verfolgt Events über Ihr Canvas oder Ihre Kampagne hinweg, sodass Sie Ihr Messaging überprüfen und Fehler beheben können. Nutzen Sie es, um Trends zu erkennen, zu sehen, wie Nutzer:innen ein Canvas durchlaufen, und um zu diagnostizieren, warum Nachrichten möglicherweise nicht wie erwartet gesendet wurden.

Voraussetzungen

Für den Zugriff auf Messaging Observability benötigen Sie die Berechtigung „View Dashboard Reports“ für Ihren Workspace.

Wichtige Konzepte

Gesendet und zugestellt

Dieses Dashboard zeigt, wie Braze eine Nachricht intern verarbeitet hat, nicht den endgültigen Zustellungsstatus der Nachricht.

Eine Nachricht, die in diesem Dashboard als „gesendet“ markiert ist, wurde von Braze erfolgreich verarbeitet und versendet. Bei den meisten Kanälen bedeutet das, dass Braze die Nachricht an den zuständigen externen Versandpartner übergeben hat. Eine endgültige Zustellung auf dem Gerät der Nutzer:innen ist damit jedoch nicht garantiert.

Wenn Braze eine Nachricht „sendet“, kann die endgültige Zustellung von externen Diensten abhängen. Beachten Sie die folgenden Beispiele für die einzelnen Kanäle.

Canvas-Fortschritts-Events

Für Canvases zeigt Messaging Observability auch Fortschritts-Events an: Aufzeichnungen darüber, wie sich Nutzer:innen durch die Journey bewegen, etwa beim Eintritt in das Canvas, beim Eintritt in einen Schritt oder beim Verlassen des Canvas. Fortschritts-Events sind von den Ergebnissen des Nachrichtenversands getrennt. Sie helfen Ihnen zu erkennen, wo sich Nutzer:innen im Canvas befinden.

Datenaktualität

Wie häufig die Daten in diesem Dashboard aktualisiert werden, kann je nach Systemauslastung schwanken. Die Aktualisierungshäufigkeit ist zwar nicht garantiert, liegt in den meisten Fällen aber voraussichtlich unter einer Stunde.

Dashboard konfigurieren

Sie können Messaging Observability über einen der folgenden Wege öffnen:

• Gehen Sie zu Analytics > Dashboard Builder und wählen Sie dann Messaging Observability aus der Liste der von Braze erstellten Dashboards aus.
• Wählen Sie auf einer Analytics-Seite eines Canvas oder einer Kampagne Messaging Observability aus. Das Dashboard öffnet sich, sofern verfügbar, mit dem vorausgewählten Canvas bzw. der vorausgewählten Kampagne.

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

1. Wählen Sie ein Datum oder einen Zeitraum innerhalb der letzten sieben Tage aus.
2. Wählen Sie entweder Campaigns oder Canvases als Quelle für Ihre Dashboard-Berichte aus.
3. Wählen Sie eine Kampagne oder ein Canvas aus.
4. (Optional, nur für Canvases) Wählen Sie einen oder mehrere Canvas-Schritte aus, um die Ergebnisse auf diese Schritte einzugrenzen.
5. Wählen Sie Run dashboard aus, um die Daten für Ihre ausgewählten Filter zu laden.

Wichtig

Nachdem Sie einen Filter geändert haben, wählen Sie erneut Run dashboard aus, um die Übersichtskacheln, das Chart und das Event-Log zu aktualisieren. Bis dahin zeigt das Dashboard möglicherweise die Warnung „Outdated results“ an.

Daten interpretieren

Hinweis

Das Dashboard zeigt Daten der letzten sieben Tage an. Alle Zeitstempel werden in der Zeitzone Ihres Workspace angezeigt.

Übersichtskacheln

Oben auf der Seite zeigen Übersichtskacheln für den ausgewählten Zeitraum Folgendes an:

• Entries: Alle berechtigten Canvas- oder Campaign-Entries, die im ausgewählten Zeitraum ausgewertet wurden. Diese Zahlen können leicht von der Analytics-Ansicht abweichen, da Messaging Observability Daten zur Fehlerbehebung aus anderen Quellen verwendet.
• Unterdrückungen: Nachrichten, die Braze nach dem Entry absichtlich nicht gesendet hat, etwa aufgrund der Berechtigung, des Frequency-Cappings oder der Ruhezeiten. Weitere Informationen finden Sie unter Unterdrückungen.
• Fehler: Nachrichten, bei denen unerwartet ein Fehler aufgetreten ist, etwa Liquid-, Webhook- oder Push-Fehler. Weitere Informationen finden Sie unter Fehler.
• Gesendet: Nachrichten, die die Verarbeitung durch Braze erfolgreich verlassen haben. Dies garantiert keine Zustellung an die Empfänger:innen. Die Zustellung hängt vom Kanal, vom Mobilfunkanbieter und vom Gerät ab. Weitere Informationen finden Sie unter Gesendet und zugestellt.

Events im Zeitverlauf

Dieses Zeitreihen-Chart zeigt eine stündliche Aufschlüsselung der Events für Ihre ausgewählten Filter. Verwenden Sie die Chart-Ansichten, um Gesamtwerte in der Übersicht zu vergleichen oder Unterdrückungen und Fehler nach Ergebnis aufzuschlüsseln. Die Ergebnisbezeichnungen in diesem Chart sind normalisierte Dashboard-Bezeichnungen und keine Rohwerte aus Event-Payloads.

Event-Protokoll

Das Event-Protokoll listet einzelne Events auf, die Braze für Ihre ausgewählten Filter und Ihren Zeitraum für jede:n Nutzer:in erfasst hat – hauptsächlich Unterdrückungen, Progressionen und Fehler. Damit können Sie bestimmte Datensätze überprüfen, einschließlich Zeitstempel, Nutzer-ID, Canvas-Schritt, Event, Beschreibung und Messaging-Kanal.

Filtern Sie die Tabelle, um sich auf bestimmte Datensätze zu konzentrieren:

• Wählen Sie im Filter Events Event-Kategorien oder einzelne Events aus (zum Beispiel Unterdrückungen > Frequency-Capping angewendet oder Progressionen > Schritt betreten).
• Geben Sie eine Nutzer-ID in das Suchfeld ein, um die Zeilen für diese:n Nutzer:in anzuzeigen.

Wenn Sie beide Filter anwenden, gibt die Tabelle Zeilen zurück, die sowohl den ausgewählten Events als auch der eingegebenen Nutzer-ID entsprechen.

Wählen Sie in einer Zeile Anzeigen aus, um ein seitliches Panel mit weiterem Kontext zu diesem Event zu öffnen. Im Panel können Sie außerdem Operator fragen auswählen, um Hinweise zur Behebung zu erhalten.

Hinweis

Kanalfilter gelten für Events, die einem bestimmten Messaging-Kanal zugeordnet sind. Einige Events sind kanalunabhängig und können daher weiterhin in aggregierten Ansichten erscheinen, auch wenn Sie einen Kanalfilter anwenden.

Progressions-Events

Progressions-Events beschreiben, wie sich Nutzer:innen durch ein Canvas bewegen. Sie gelten nur für Canvases. Der Entry in eine Campaign erscheint unter Entries als Campaign betreten.

Hinweis

Die Bezeichnungen der Progressions-Events in Messaging Observability sind gut lesbare Dashboard-Bezeichnungen. Anzahl oder Benennung können von anderen Analytics-Bereichen in Braze abweichen, da diese Datensätze unterschiedlich dargestellt und verarbeitet werden.

Unterdrückungen

Unterdrückungen sind absichtlich nicht erfolgte Sendungen nach dem Entry, die auf Einstellungen, Berechtigungen oder Zustellungskontrollen zurückgehen.

Hinweis

Die Bezeichnungen für Unterdrückungen und Fehler in Messaging Observability sind gut lesbare Dashboard-Bezeichnungen. In den Currents-Events zum Nachrichten-Engagement werden Informationen zu Abbrüchen in Feldern wie abort_type und abort_log dargestellt. Da diese Datensätze unterschiedlich dargestellt und verarbeitet werden, können Anzahl oder Benennung zwischen Currents und Messaging Observability abweichen.

Sendeeinstellungen

Nutzerberechtigung

Fehler

Fehler sind unerwartete Probleme während der Verarbeitung oder bei Zustellungsversuchen.

Häufig gestellte Fragen

Was bedeutet ein „Pre-Check“-Fehler?

Ein „Pre-Check“ ist eine schnelle, gebündelte Validierungsprüfung, die ganz am Anfang einer Pipeline-Phase ausgeführt wird (zum Beispiel wenn eine Nachricht getriggert wird oder ein Canvas-Nachrichtenschritt versendet wird). Stellen Sie sich das als frühen Exit vor, der auf maximale Geschwindigkeit ausgelegt ist. Anstatt viele separate, ressourcenintensive Prüfungen durchzuführen (etwa 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 aussortiert. Dieser gebündelte Ansatz ermöglicht es Braze, enorme Nachrichtenmengen mit hoher Geschwindigkeit zu verarbeiten. Außerdem kann er zu einer schnelleren, stabileren Performance Ihrer Campaigns und Canvases beitragen, da die Verarbeitungslatenz für jede Nachricht sinkt.

Was bedeutet ein „Sonstige“-Fehler?

Dabei handelt es sich um Fehler, die in keine der bestehenden Dashboard-Kategorien fallen. Wenn Sie weiterhin einen hohen Anteil an „Sonstige“-Fehlern feststellen, wenden Sie sich für weitere Unterstützung an den Braze-Support.

Warum ergeben Entries, Unterdrückungen, Fehler und Gesendet zusammen nicht meine erwartete Zielgruppengröße?

Dafür kann es mehrere Gründe geben:

• Zielgruppenkriterien: Möglicherweise haben beim Start der Campaign oder des Canvas weniger Nutzer:innen als erwartet die Zielgruppenkriterien erfüllt (zum Beispiel, weil sie nicht im Segment waren oder nicht über die erforderlichen Attribute verfügten).
• Laufende Verarbeitung: Nachrichten oder Canvas-Schritte werden möglicherweise noch aktiv verarbeitet. Nutzer:innen befinden sich eventuell noch in früheren Schritten des Canvas und haben noch keinen Nachrichtenschritt erreicht.
• Fortschritt ohne Versand: Nutzer:innen können Fortschritts-Events auslösen (zum Beispiel beim Eintritt in einen Verzögerungs- oder Decision-Split-Schritt), ohne dass im selben Zeitfenster eine entsprechende Unterdrückung, ein Fehler oder ein Versand erfolgt.
• 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 sind möglicherweise noch nicht im Dashboard angekommen.
• 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, wenden Sie sich an den Braze-Support.

Warum können die Summen in Kacheln oder im Event-Log größer sein als die Zielgruppe einer Campaign oder eines Canvas?

Das kann folgende Gründe haben:

• Mehrkanalige Nachrichten: Die Campaign oder der Canvas-Schritt wurde für den Versand über mehrere Kanäle konfiguriert (zum Beispiel SMS und E-Mail). Ein:e einzelne:r Nutzer:in kann für einen Kanal (etwa E-Mail) das Ergebnis „gesendet“ erhalten und für einen anderen Kanal eine Unterdrückung oder einen Fehler (etwa „Nutzer:in für den Kanal nicht berechtigt“). In diesem Fall wird diese:r eine Nutzer:in in den Kacheln und im Event-Log mehrfach gezählt.
  • Beispiel: Sie senden eine Push-Campaign an 100 Nutzer:innen und richten sie sowohl auf iOS als auch auf Android aus. Wenn ein:e Nutzer:in nur ein iOS-Gerät besitzt, erhält er oder sie den iOS-Push („gesendet“), löst aber gleichzeitig eine Unterdrückung für den Android-Push aus („Nutzer:in für den Kanal nicht berechtigt“).
• Mehrere Nachrichtenschritte (nur Canvas): Ihr Canvas enthält in einem bestimmten Pfad möglicherweise mehr als einen Nachrichtenschritt. Dieses Dashboard aggregiert alle Events, sodass ein:e einzelne:r Nutzer:in mehrfach gezählt werden kann, wenn er oder sie im ausgewählten Zeitraum mehrere Schritte durchläuft.
• Testnachrichten: Testversände (die im Dashboard mitgezählt werden) können dazu führen, dass die Summen größer sind als die Zielgruppengröße.