Fehlerbehebung für Canvases

Verwenden Sie diese Seite, um Probleme beim Canvas-Eintritt, beim Senden und bei Analytics zu diagnostizieren. Definitionen und weiterführende Informationen finden Sie in den Canvas-FAQ.

Hinweis

Messaging-Verlauf und Messaging-Diagnostics-Protokolle sind bis zu 30 Tage ab dem Ereignis verfügbar. Kontaktieren Sie den Braze-Support innerhalb dieses Zeitraums, wenn Sie Hilfe bei der Untersuchung eines bestimmten Vorfalls benötigen.

Hier starten: Symptom zuordnen

Standardmäßiger Untersuchungspfad

Verwenden Sie diesen Workflow, um ein Problem bei einer:m bestimmten Nutzer:in oder bei einem aggregierten Versand zu untersuchen. Beginnen Sie bei jedem Vorfall mit Schritt 1.

1. Bestätigen Sie, dass der Canvas aktiv ist (nicht im Entwurf, gestoppt oder archiviert).
2. Bestätigen Sie, dass der Entry-Zeitplan (geplantes Zeitfenster, Zeitzone, aktionsbasierter Trigger oder API-gesteuerter Entry) mit dem erwarteten Eintrittszeitpunkt der Nutzer:innen übereinstimmt.
3. Überprüfen Sie den Nachrichtenverlauf einer:s Nutzer:in, indem Sie zu Audience > Search users navigieren, das Profil öffnen und Messaging History (letzte 30 Tage) auswählen.
   • Wenn für den erwarteten Sendezeitpunkt kein Eintrag vorhanden ist, liegt das Problem beim Entry, nicht bei der Nachricht. Gehen Sie zu Nutzer:in ist nicht in den Canvas eingetreten.
4. Überprüfen Sie den Canvas-Changelog und die Changelogs aller Segmente, die beim Targeting verwendet werden. Bestätigen Sie, dass die Zielgruppe, die Schritte oder die Sendeeinstellungen während des Vorfalls nicht geändert wurden.
5. Überprüfen Sie die aggregierten Ergebnisse auf der Canvas-Analytics-Seite, indem Sie das Messaging Diagnostics Dashboard öffnen und die Abbruch- und Verwerfungsgründe prüfen.
   • Wenn Sie ein Ergebnis sehen, das Sie nicht zuordnen können, lesen Sie Abbruchergebnisse in der Diagnostik-Dokumentation.
   • Wenn ein Canvas-Schritt null Eintritte (nicht null Sendungen) anzeigt, überprüfen Sie den vorherigen Schritttyp (Aktionspfade, Verzögerung, Zielgruppenpfade oder Decision-Split).
6. Wenn Sie weiterhin nicht weiterkommen, kontaktieren Sie den Braze-Support innerhalb von 30 Tagen mit der Canvas-ID, den betroffenen Nutzer-IDs, Zeitstempeln (mit Zeitzone) und Screenshots aus Messaging History oder Messaging Diagnostics.

Verwenden Sie vor dem Start Test-Canvases senden und Nutzerpfade in der Vorschau anzeigen, um Ihr Setup zu validieren.

Nutzer:in ist nicht in den Canvas eingetreten

Symptom: Eine:r Nutzer:in ist nicht wie erwartet in den Canvas eingetreten, oder es sind weniger Nutzer:innen eingetreten, als Ihre Trigger-Events vermuten lassen.

Nutzer:innen müssen der Zielgruppe entsprechen, bevor Braze den Entry-Trigger auswertet (mit Ausnahme von Attributänderungs-Triggern). Ein Trigger allein garantiert keinen Entry, wenn die:der Nutzer:in zum Zeitpunkt der Auswertung nicht zur Zielgruppe gehörte.

Wiederberechtigung und Wiedereintritt sind separate Einstellungen unter Entry-Kontrollen auswählen:

• Wiederberechtigung: Bestimmt, ob eine:r Nutzer:in nach dem Verlassen des Canvas erneut eintreten darf (Zeitfenster und Einstellung Nutzer:innen den Wiedereintritt in den Canvas erlauben).
• Wiedereintritt: Bestimmt, ob eine:r Nutzer:in, die:der sich derzeit im Canvas befindet, einen parallelen Pfad betreten kann.

Eine:r Nutzer:in kann wiederberechtigt sein, aber blockiert werden, weil sie:er sich noch im Canvas befindet, oder sie:er kann den Canvas verlassen haben, sich aber noch außerhalb des Wiederberechtigungsfensters befinden. Überprüfen Sie beide Einstellungen, wenn eine:r Nutzer:in nicht erneut in einen Canvas eintritt.

Überprüfen Sie Folgendes:

• Entry-Zeitplan und Zeitzone: Bestätigen Sie, dass der Canvas aktiv war und die:der Nutzer:in den Trigger während des Entry-Fensters ausgelöst hat.
• Zielgruppe zum Zeitpunkt der Auswertung: Überprüfen Sie die Änderungsprotokolle von Segmenten und Filtern. Nutzersuche kann bei einigen Filtertypen falsch positive Ergebnisse anzeigen (z. B. als String formatierte Datumsattribute).
• Entry-Limits: Maximale Eintritte oder Zielgruppen-Limits wurden möglicherweise erreicht.
• Globale Kontrollgruppe: Nutzer:innen in der globalen Kontrollgruppe treten nicht in Messaging-Canvases ein.
• Canvas-Kontrollgruppe: Nutzer:innen, die beim Entry der Canvas-Kontrollgruppe zugewiesen werden, erhalten keine Varianten-Nachrichten. Die Variantenzuweisung erfolgt beim Entry, nicht über Segmentfilter. Siehe Abweichungen in Canvas Analytics.
• Exit-Kriterien: Die:der Nutzer:in hat möglicherweise die Exit-Kriterien vor oder während des Entry erfüllt. Wenn Entry und Exit dasselbe Event verwenden, siehe Übereinstimmende Entry- und Exit-Kriterien.
• API-getriggerter Entry: Bestätigen Sie, dass die:der Nutzer:in über den /canvas/trigger/send-Endpunkt hinzugefügt wurde. Sie können ein Segment erstellen mit einem Canvas-Entry-Filter und Nutzer:innen mit /users/export/segment exportieren.

Trigger-Event-Anzahl ist höher als Canvas-Eintritte

Symptom: Das Trigger-Event-Volumen ist höher als die Anzahl der Canvas-Eintritte.

Braze dedupliziert mehrere Entry-Versuche, die im selben Moment stattfinden, sodass Sie möglicherweise weniger Canvas-Eintritte als Trigger-Events sehen. Um mehrere Eintritte zu testen, planen Sie Trigger-Events mit mindestens einer Sekunde Abstand.

Wenn eine:r Nutzer:in denselben Trigger innerhalb einer Sekunde mehrmals auslöst, verarbeitet Braze nur einen Entry. Überprüfen Sie die Messaging-Diagnose auf Ergebnisse wie Nutzer:in nicht wiederberechtigt, wenn Wiedereintritts- oder Wiederberechtigungsregeln gelten.

Nutzer:in hat keine Canvas-Nachricht oder keinen Canvas-Schritt erhalten

Symptom: Eine:r Nutzer:in ist in den Canvas eingetreten, hat aber die erwartete Nachricht oder den erwarteten Schritt nicht erhalten.

Überprüfen Sie den Nachrichtenverlauf der Nutzer:innen für den Canvas-Schritt und den Zeitstempel. Wenn kein Eintrag vorhanden ist, kehren Sie zu Nutzer:in ist nicht in den Canvas eingetreten zurück.

Überprüfen Sie dann Folgendes je nach Trigger- oder Schritttyp:

• Angepasste Events oder Kauf-Trigger: Bestätigen Sie, dass das Event unter Analytics > Bericht zu angepassten Events (oder Umsatz für Käufe) angezeigt wird. Vergleichen Sie den Event-Zeitstempel mit dem Zeitpunkt, zu dem der Canvas live ging, und mit einer eventuellen geplanten Verzögerung des Schritts.
• API-getriggerter Entry: Bestätigen Sie den Entry mit einem Canvas-Segment-Filter und -Export, wie unter Nutzer:in ist nicht in den Canvas eingetreten beschrieben.
• Aktionspfade oder Nachrichten-Schritt-Trigger: Bestätigen Sie, dass die Nutzer:innen das vorausgesetzte Event ausgeführt haben und dass Event-Eigenschaften im Schritt verfügbar sind.
• In-App-Nachricht-Schritte: In-App-Nachrichten werden beim nächsten Sitzungsstart gesendet, nachdem die Nutzer:innen den Schritt betreten haben, und nur über SDK-Events (nicht über die REST API). Siehe Wann werden In-App-Nachrichten in Canvas gesendet? in den Canvas-FAQ.
• Canvas-Kontrollgruppe: Überprüfen Sie, ob die Nutzer:innen beim Entry nicht der Canvas-Kontrollgruppe zugewiesen wurden.
• Kanalberechtigung und Sendeeinstellungen: Bestätigen Sie den Abo-Status, den Push-Aktivierungsstatus und die Sendeeinstellungen pro Schritt (z. B. Abo-Einstellungen nur für Nutzer:innen mit Opt-in). Fügen Sie keine Einzelkanal-Filter zur Zielgruppe in Mehrkanalcanvases hinzu.
• Zustellungsvalidierungen: Wenn Sie Zielgruppe beim Nachrichtenversand validieren in einem Nachrichten-Schritt aktiviert haben, erhalten Nutzer:innen, die zum Sendezeitpunkt nicht mehr den Filtern entsprechen, die Nachricht nicht. Siehe Zustellungsvalidierungen.
• Ruhezeiten, intelligentes Timing, Frequency Caps und Rate-Limits: Diese können Sendungen verzögern, unterdrücken oder abbrechen. Nutzer:innen können nach einem Abbruch durch Ruhezeiten weiterhin im Canvas verbleiben.
• Race-Conditions: Wenn die Nutzer:innen mehrere Aktionen gleichzeitig ausgelöst haben, siehe Race-Conditions.

Wichtig

Wenn ein Canvas-Nachrichten-Schritt einen Versand abbricht, rücken die Nutzer:innen trotzdem zum nächsten Schritt vor. Canvas rückt bei Abbruch vor, damit nachfolgende Verzögerungs- und Aktionspfad-Schritte nicht dauerhaft blockiert werden. Siehe Wie Nutzer:innen vorrücken und Abbruch-Ergebnisse.

Informationen zu Filtern auf Schrittebene, Konflikten zwischen Branches und dem Branching-Verhalten von In-App-Nachrichten finden Sie unter Mit Canvas Flow starten – Fehlerbehebung und in den Canvas-FAQ.

Wichtig

Wenn Ihr aktionsbasierter Canvas Nachrichten früher als erwartet sendet, überprüfen Sie, ob der Zeitstempel Ihres angepassten Events die aktuelle Uhrzeit verwendet und nicht eine rückdatierte Uhrzeit. Braze berechnet Verzögerungen anhand des mit dem Event gesendeten Zeitstempels. Siehe Aktionsbasierte Zustellung.

Niedrige oder keine Canvas-Eintritte

Symptom: Keine oder weniger Nutzer:innen als erwartet sind in den Canvas eingetreten.

Beginnen Sie mit der Checkliste für den Start mit Canvas Flow und überprüfen Sie dann Folgendes:

• Der Canvas ist aktiv und die aktuelle Uhrzeit liegt innerhalb des geplanten Entry-Fensters.
• Die Entry-Einstellungen (erneute Berechtigung, maximale Eintritte und Entry-Limits) erlauben den Eintritt der erwarteten Nutzer:innen.
• Die Zielgruppe und die Segmentfilter stimmen auch nach dem Start noch mit den erwarteten Nutzer:innen überein.
• Die Prozentsätze der globalen Kontrollgruppe und der Canvas-Kontrollgruppe zeigen, welcher Anteil der Nutzer:innen in welchen Pfad eintritt und welcher Anteil Nachrichten erhält.
• Workspace-Rate-Limits oder Entry-Warteschlangen können erwartungsgemäß zu Verzögerungen zwischen dem Zeitpunkt, an dem Nutzer:innen sich qualifizieren, und dem Zeitpunkt, an dem sie eintreten oder in einen Schritt vorrücken, führen.

Für einzelne Nutzer:innen folgen Sie dem standardmäßigen Untersuchungspfad. Für Null-Eintritte im Zusammenhang mit der Sommerzeit-/Winterzeitumstellung siehe den aufklappbaren Abschnitt unter Nutzer:in ist nicht in den Canvas eingetreten.

Weniger Sendungen als erwartet

Symptom: Sendungen oder Zustellungen liegen unter der geschätzten Zielgruppe eines Canvas-Schritts.

Häufige Ursachen sind die erneute Zielgruppenbewertung zum Sendezeitpunkt, Kanalberechtigung, Kontrollgruppen, Ruhezeiten, intelligentes Timing, Rate-Limits und das Zustellverhalten von In-App-Nachrichten (null Sendungen bei vorhandenen Impressionen ist bei In-App-Nachrichten erwartetes Verhalten).

Wenn ein Nachrichtenschritt viele eingetretene Nutzer:innen, aber wenige Sendungen anzeigt, prüfen Sie, ob Liquid abort_message() den Versand abgebrochen hat. Informationen zu Prüfungen im Nachrichtenaktivitätsprotokoll, fehlenden Attributen und Testsendungen finden Sie unter Fehlerbehebung bei hohen Abbruchraten.

Eine ausführliche Liste finden Sie unter Warum sind die Sendungen niedriger als die geschätzte Zielgruppengröße? in den Canvas-FAQ und Warum sind die Sendungen niedriger als die geschätzte Zielgruppengröße? für Campaigns.

Verwenden Sie das Messaging-Diagnostics-Dashboard, um Abbruch- und Verwerfungsgründe auf Schrittebene einzusehen.

Abweichungen in Canvas-Analytics

Symptom: Canvas-Analytics sehen falsch aus (Kontrollgruppen-Aufteilung, Konversionen oder null Sendungen).

Die Zuweisung zu Kontrollgruppen und Varianten erfolgt beim Canvas-Eintritt basierend auf den Prozentsätzen, die Sie im Builder festgelegt haben – nicht über Segmentfilter. Nutzer:innen, die einen bestimmten Kanal nicht empfangen können, können trotzdem in eine Variante eintreten. Verwenden Sie die Sendeeinstellungen auf Schrittebene, um einzuschränken, wer welchen Nachrichtentyp erhält, anstatt die Zielgruppe mit Kanalfiltern einzugrenzen.

Unterscheiden Sie die Canvas-Kontrollgruppe von der globalen Kontrollgruppe. Filterdefinitionen finden Sie unter Was ist der Unterschied zwischen „Has not entered Canvas variation“ und „Is not in Canvas control group“? in den Canvas-FAQ.

Datumsbereichsfilter können unerwartete Zahlen anzeigen

Symptom: Canvas- oder Schritt-Analytics zeigen unerwartete oder unplausible Zahlen an, z. B. deutlich mehr Sendungen als Eintritte oder mehr Nutzer:innen, die einen Schritt verlassen, als ihn betreten haben.

Dies kann passieren, wenn Sie den Datumsbereichs-Kalenderfilter oben auf der Canvas-Analytics-Seite verwenden. Wenn Sie einen Datumsbereich auswählen, der einige Nutzeraktionen ausschließt, zeigen die angezeigten Metriken möglicherweise nur einen Teil der Journey jeder Nutzerin bzw. jedes Nutzers an.

Zum Beispiel:

• Sie sehen möglicherweise 100 Eintritte bei 8.000 Sendungen, wenn Ihr Datumsbereich nach dem Eintritt der meisten Nutzer:innen beginnt, aber den Zeitraum umfasst, in dem sie Nachrichten erhalten haben.
• Sie sehen möglicherweise mehr Nutzer:innen, die zum nächsten Schritt übergehen, als den vorherigen Schritt betreten haben, wenn Ihr Bereich nur die Exits, aber nicht die früheren Eintritte erfasst.

Um dies zu beheben, passen Sie den Datumsbereich so an, dass er entweder alle Daten vom Start des Canvas bis zur Gegenwart umfasst, oder wählen Sie einen Bereich, der den gesamten für die benötigten Metriken relevanten Zeitraum abdeckt.

Definitionen zu Konversionsraten und Analytics auf Schrittebene finden Sie unter Analytics und Konversionen in den Canvas-FAQ.

Editor- und Speicherprobleme

Symptom: Der Canvas-Editor lädt nicht, friert ein oder speichert Ihre Änderungen nicht.

Wenn der Editor bei einem großen oder komplexen Canvas einfriert, versuchen Sie Folgendes:

• Leeren Sie den Browser-Cache und die Cookies und laden Sie die Seite neu. Unternehmens-Werbeblocker oder Browser-Erweiterungen können die Braze-Plattform beeinträchtigen.
• Verwenden Sie die Canvas-Zoom-Steuerung, um die Ansicht auf 25 % oder 10 % zu reduzieren und so die Menge an UI zu verringern, die der Browser rendern muss.
• Versuchen Sie es mit einem anderen Webbrowser.

Wenn das Canvas nicht lädt und nicht weiterkommt, wurde eine vorherige Version nicht korrekt gespeichert und enthält möglicherweise ungültige Schritte. Duplizieren Sie das Canvas über das Dashboard. Wenn das Problem weiterhin besteht, erstellen Sie ein Support-Ticket.

Fügen Sie bei Support-Tickets zu „Request Timed Out“ eine Bildschirmaufnahme, einen Zeitstempel mit Zeitzone, Browser und Version, Schritte zur Reproduktion und optional ein HAR-Protokoll aus den Entwicklertools Ihres Browsers bei. Siehe Was sollte ich bei einem Support-Ticket für einen „Request Timed Out“-Fehler angeben? in den Canvas-FAQ.

Verhalten bei gestopptem Canvas

Symptom: Sie haben das Canvas gestoppt, aber Nutzer:innen haben weiterhin Nachrichten erhalten.

Wenn Sie ein Canvas stoppen, können keine Nutzer:innen mehr eintreten und es werden keine weiteren Nachrichten aus dem Canvas-Flow gesendet. E-Mail-Sendungen, die bereits an Ihren E-Mail-Anbieter übergeben wurden, können nicht zurückgerufen werden.

Nutzer:innen, die sich in einem Delay- oder Aktionspfad-Schritt befinden, werden nicht automatisch aus der Journey entfernt, wenn Sie das Canvas stoppen. Wenn Sie das Canvas erneut aktivieren, bevor die geplante Sendezeit abgelaufen ist, können diese Nutzer:innen ausstehende Schritte weiterhin erhalten.

Ausführliche Informationen finden Sie unter Was passiert, wenn Sie ein Canvas stoppen? in den Canvas-FAQ.

Fehler „Zu viele Canvas-Verzweigungen“

Symptom: Beim Starten eines geplanten Canvas wird der Fehler „Too many Canvas branches“ angezeigt.

Dieser Fehler tritt auf, wenn die Kombination aus Schrittverzweigungen und der Größe der Eintritts-Zielgruppe zu Cluster-Performance-Problemen führen kann, die den Nachrichtenversand verhindern. Braze zeigt diese Meldung an, wenn Sie ein Canvas mit geplantem Eintritt starten – beim Speichern eines Entwurfs erscheint sie nicht.

So beheben Sie das Problem:

• Reduzieren Sie die Schrittverzweigungen im Canvas.
• Verkleinern Sie die Eintritts-Zielgruppe.
• Verwenden Sie Zielgruppenpfade, um Verzweigungen zu konsolidieren, anstatt viele parallele Pfade zu nutzen.
• Wenn Ihr Canvas den ursprünglichen Editor verwendet, klonen Sie es in Canvas Flow und bauen Sie es mit Canvas-Komponenten neu auf.

Wenn Sie das Canvas dennoch ohne Änderungen starten müssen und nicht zu Canvas Flow wechseln können, wenden Sie sich an den Support.

Wann Sie den Support kontaktieren sollten

Kontaktieren Sie den Braze Support innerhalb von 30 Tagen nach Auftreten des Problems, wenn Sie den standardmäßigen Untersuchungspfad abgeschlossen haben und weiterhin Hilfe benötigen.

Geben Sie folgende Informationen an:

• Canvas-ID und betroffene Nutzer:innen-IDs (externe ID oder Braze-ID)
• Zeitstempel mit Zeitzone
• Screenshots oder Exporte aus Messaging History oder Messaging Diagnostics
• Bei „Request Timed Out“-Fehlern im Editor die unter Editor- und Speicherprobleme aufgeführten Details