Messaging Observability

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

Hinweis

Um auf Messaging Observability zuzugreifen, benötigen Sie die Nutzer:innenberechtigung „Dashboard-Berichte anzeigen“ für Ihren Workspace.

Schlüsselkonzepte

Gesendet und zugestellt

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

Eine in diesem Dashboard als „gesendet“ markierte Nachricht bedeutet, dass Braze die Nachricht erfolgreich verarbeitet und versendet hat. Bei den meisten Kanälen heißt das, dass Braze die Nachricht an den zuständigen 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.

Canvas-Fortschrittsereignisse

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

Datenaktualität

Die Häufigkeit, mit der die Daten in diesem Dashboard aktualisiert werden, kann je nach Systemlast variieren. Die Aktualisierungsfrequenz ist zwar nicht garantiert, beträgt aber in den meisten Fällen voraussichtlich weniger als eine Stunde.

Dashboard konfigurieren

Öffnen Sie Messaging Observability über einen der folgenden Wege:

• Gehen Sie zu Analytics > Dashboard Builder und wählen Sie Messaging Observability aus der Liste der von Braze erstellten Dashboards aus.
• Wählen Sie auf einer Canvas- oder Campaign-Analytics-Seite Messaging Observability aus. Das Dashboard wird mit dem entsprechenden Canvas oder der Campaign vorausgewählt geöffnet, sofern verfügbar.

So starten Sie das Dashboard und sehen Ihre Daten:

1. Wählen Sie ein Datum oder einen Datumsbereich von bis zu den letzten sieben Tagen aus.
2. Wählen Sie entweder Campaigns oder Canvases als Quelle für Ihre Dashboard-Berichte aus.
3. Wählen Sie eine Campaign oder ein Canvas aus.
4. (Optional, nur 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 Zusammenfassungskacheln, das Chart und das Event-Log zu aktualisieren. Bis dahin zeigt das Dashboard möglicherweise eine Warnung „Outdated results“ an.

Daten interpretieren

Hinweis

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

Zusammenfassungskacheln

Oben auf der Seite zeigen Zusammenfassungskacheln 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 geringfügig von der Analytics-Ansicht abweichen, da Messaging Observability Fehlerbehebungsdaten aus unterschiedlichen Quellen verwendet.
• Unterdrückungen: Nachrichten, die Braze nach dem Entry absichtlich nicht gesendet hat – zum Beispiel aufgrund von Berechtigung, Frequency-Capping oder Ruhezeiten. Details finden Sie unter Unterdrückungen.
• Fehler: Nachrichten, die unerwartet fehlgeschlagen sind, z.B. durch Liquid-, Webhook- oder Push-Fehler. Details finden Sie unter Fehler.
• Gesendet: Nachrichten, die die Braze-Verarbeitung erfolgreich verlassen haben. Dies garantiert nicht die Zustellung an die Empfänger:in. Die Zustellung hängt vom Kanal, Netzbetreiber und Gerät ab. Details finden Sie unter Gesendet und zugestellt.

Events im Zeitverlauf

Dieses Zeitreihendiagramm zeigt eine stündliche Aufschlüsselung der Events für Ihre ausgewählten Filter. Verwenden Sie die Chart-Ansichten, um Gesamtübersichten zu vergleichen oder Unterdrückungen und Fehler nach Ergebnis aufzuschlüsseln. Die Ergebnisbeschriftungen in diesem Chart sind normalisierte Dashboard-Beschriftungen, keine unverarbeiteten Event-Payload-Werte.

Event-Protokoll

Das Event-Protokoll listet einzelne Events auf, die Braze für jede Nutzer:in für Ihre ausgewählten Filter und den gewählten Zeitraum aufgezeichnet hat – hauptsächlich Unterdrückungen, Progressionen und Fehler. Verwenden Sie es, um bestimmte Einträge zu überprüfen, einschließlich Zeitstempel, Nutzer-ID, Canvas-Schritt, Event, Beschreibung und Messaging-Kanal.

Filtern Sie die Tabelle, um sich auf bestimmte Einträge zu konzentrieren:

• Wählen Sie Event-Kategorien oder einzelne Events aus dem Events-Filter aus (z.B. Unterdrückungen > Frequency-Capping, oder Progressionen > Schritt betreten).
• Geben Sie eine Nutzer-ID in das Suchfeld ein, um Zeilen für diese 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 View in einer Zeile aus, um ein Seitenpanel mit mehr Kontext zu diesem Event zu öffnen. Vom Panel aus können Sie auch Ask Operator auswählen, um Hinweise zur Behebung zu erhalten.

Hinweis

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

Progressions-Events

Progressions-Events beschreiben, wie Nutzer:innen sich durch ein Canvas bewegen. Sie gelten nur für Canvas. Campaign-Entries erscheinen unter Entries als Entered campaign.

Hinweis

Progressions-Event-Beschriftungen in Messaging Observability sind menschenlesbare Dashboard-Beschriftungen. Zähler oder Bezeichnungen können sich von anderen Braze-Analytics-Oberflächen unterscheiden, da diese Datensätze unterschiedliche Darstellungen und Verarbeitungspfade haben.

Unterdrückungen

Unterdrückungen sind absichtliche Nicht-Sendungen nach dem Entry, die durch Einstellungen, Berechtigung oder Zustellungskontrollen verursacht werden.

Hinweis

Unterdrückungs- und Fehlerbeschriftungen in Messaging Observability sind menschenlesbare Dashboard-Beschriftungen. In den Currents Message-Engagement-Events werden Abbruchinformationen durch Felder wie abort_type und abort_log dargestellt. Da diese Datensätze unterschiedliche Darstellungen und Verarbeitungspfade haben, können Zähler oder Bezeichnungen 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“ 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 oder ein Canvas-Nachrichtenschritt gesendet wird). Stellen Sie sich dies als einen frühen Abbruch vor, der auf maximale Geschwindigkeit ausgelegt ist. Anstatt viele separate, ressourcenintensive Prüfungen durchzuführen (wie die Validierung jedes Details eines Nutzerprofils), fasst Braze mehrere grundlegende Validierungen in einem einzigen „ersten Durchlauf“ zusammen.

Wenn Nutzer:innen diese einzelne gebündelte Prüfung nicht bestehen, werden sie sofort aussortiert. Dieser gebündelte Ansatz ermöglicht es Braze, große 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 „Other“-Fehler?

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

Warum ergeben Entries, Suppressions, Failures und Sent zusammen nicht 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 verfügten nicht über die erforderlichen Attribute), als die Campaign oder das Canvas gestartet wurde.
• Verarbeitung läuft noch: Nachrichten oder Canvas-Schritte 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.
• Fortschritt ohne Versand: Nutzer:innen können Fortschritts-Events erzeugen (z. B. beim Eintritt in einen Verzögerungs- oder Decision-Split-Schritt), ohne dass im selben Zeitfenster eine entsprechende Suppression, ein Fehler oder ein Versand stattfindet.
• Datenaktualität: Die Dashboard-Daten werden ungefähr alle 15 Minuten aktualisiert, dies ist jedoch keine Garantie. Die neuesten Daten für diese Campaign oder dieses 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, wenden Sie sich an den Braze-Support.

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

Dies kann aus folgenden Gründen auftreten:

• 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 für einen Kanal (z. B. E-Mail) ein „Sent“-Ergebnis erhalten und für einen anderen (z. B. „User not eligible for channel“) eine Suppression oder einen Fehler auslösen. In diesem Fall wird diese eine Nutzer:in über Kacheln und das Event-Log hinweg mehrfach gezählt.
  • Beispiel: Sie senden eine Push-Campaign an 100 Nutzer:innen und zielen dabei sowohl auf iOS als auch auf Android ab. Wenn eine Nutzer:in nur ein iOS-Gerät hat, erhält sie die iOS-Push-Benachrichtigung („Sent“), löst aber auch eine Suppression für die Android-Push-Benachrichtigung aus („User not eligible for channel“).
• Mehrere Nachrichtenschritte (nur Canvas): Ihr Canvas kann mehr als einen Nachrichtenschritt in einem bestimmten Pfad haben. Dieses Dashboard aggregiert alle Events, sodass eine einzelne Nutzer:in mehrfach gezählt werden kann, wenn sie innerhalb des ausgewählten Zeitraums mehrere Schritte durchläuft.
• Testnachrichten: Testversand (der im Dashboard mitgezählt wird) kann dazu führen, dass die Gesamtzahlen höher sind als die Zielgruppengröße.