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.

Tipp

Beginnen Sie nach dem Start mit Phase 5: Überwachung nach dem Start in der Canvas-QA-Checkliste, um häufige Muster in der ersten Stunde zu erkennen (Zustellbarkeitsspitzen, viele Eintritte bei wenigen Sendungen, leere Zielgruppe und Schritt-Abbrüche). Kehren Sie hierher zurück, wenn Sie einen tiefergehenden Untersuchungspfad benötigen.

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 bestimmten Nutzer:in oder einem aggregierten Versand zu untersuchen. Beginnen Sie bei jedem Vorfall mit Schritt 1.

1. Bestätigen Sie, dass das Canvas aktiv ist (nicht im Entwurf, gestoppt oder archiviert).
2. Bestätigen Sie, dass der Entry-Zeitplan (geplantes Fenster, Zeitzone, aktionsbasierter Trigger oder API-gesteuerter Entry) mit dem Zeitpunkt übereinstimmt, zu dem Nutzer:innen eintreten sollen.
3. Überprüfen Sie den Nachrichtenverlauf einer Nutzer:in, indem Sie zu Audience > Search users navigieren, das Profil öffnen und Messaging History (letzte 30 Tage) auswählen.
   • Wenn kein Eintrag für die erwartete Sendezeit vorhanden ist, liegt das Problem beim Entry, nicht bei der Nachricht. Gehen Sie zu Nutzer:in ist nicht in das Canvas eingetreten.
4. Überprüfen Sie den Canvas-Changelog und die Changelogs aller im Targeting verwendeten Segmente. Bestätigen Sie, dass die Zielgruppe, Schritte oder Sendeeinstellungen während des Vorfalls nicht geändert wurden.
5. Überprüfen Sie die aggregierten Ergebnisse auf der Canvas-Analytics-Seite, indem Sie Messaging Observability öffnen und Abbruch- und Drop-Gründe überprüfen.
   • Wenn Sie ein Ergebnis sehen, das Sie nicht erkennen, lesen Sie Abbruch-Ergebnisse in der Messaging-Observability-Dokumentation.
   • Wenn ein Schritt null Eintritte anzeigt (nicht null Sends), überprüfen Sie den vorherigen Schritttyp (Aktionspfade, Verzögerung, Zielgruppenpfade oder Decision-Split).
6. Wenn Sie weiterhin blockiert sind, wenden Sie sich innerhalb von 30 Tagen an den Braze-Support mit der Canvas-ID, den betroffenen Nutzer:innen-IDs, Zeitstempeln (mit Zeitzone) und Screenshots aus Messaging History oder Messaging Observability.

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

Nutzer:in ist nicht in das Canvas eingetreten

Symptom: Ein:e Nutzer:in ist nicht wie erwartet in das 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 oder der Nutzer:in zum Zeitpunkt der Auswertung nicht zur Zielgruppe gehörte.

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

• Wiederberechtigung: Legt fest, ob ein:e Nutzer:in nach dem Verlassen erneut in das Canvas eintreten darf (Zeitfenster und Einstellung Nutzer:innen den Wiedereintritt in das Canvas erlauben).
• Wiedereintritt: Legt fest, ob ein:e Nutzer:in, die oder der sich derzeit im Canvas befindet, einen parallelen Pfad betreten kann.

Ein:e Nutzer:in kann wiederberechtigt, aber blockiert sein, weil sie oder er sich noch im Canvas befindet, oder kann das Canvas verlassen haben, sich aber noch außerhalb des Wiederberechtigungsfensters befinden. Prüfen Sie beide Einstellungen, wenn ein:e Nutzer:in nicht erneut in ein Canvas eintritt.

Prüfen Sie Folgendes:

• Entry-Zeitplan und Zeitzone: Bestätigen Sie, dass das Canvas aktiv war und die oder 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 bestimmten Filtertypen falsch-positive Ergebnisse anzeigen (z. B. bei als String formatierten Datumsattributen).
• 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 bei Canvas-Analytics.
• Exit-Kriterien: Die oder 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 oder 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 über /users/export/segment exportieren.

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

Symptom: Das Trigger-Event-Volumen ist höher als die Canvas-Entry-Zahlen.

Braze dedupliziert mehrere Entry-Versuche, die im selben Moment auftreten, sodass Sie möglicherweise weniger Canvas-Eintritte als Trigger-Events sehen. Um mehrere Eintritte zu testen, sollten Sie Trigger-Events mindestens eine Sekunde auseinander liegen lassen.

Wenn ein:e Nutzer:in denselben Trigger innerhalb einer Sekunde mehrfach auslöst, verarbeitet Braze nur einen Entry. Prüfen Sie Messaging Observability 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.

Prüfen Sie den Nachrichtenverlauf der/des Nutzer:in 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.

Prüfen Sie dann Folgendes nach Trigger- oder Schritttyp:

• Angepasste Events oder Kauf-Trigger: Bestätigen Sie, dass das Event unter Analytics > Bericht für angepasste Events (oder Umsatz für Käufe) angezeigt wird. Vergleichen Sie den Zeitstempel des Events mit dem Startzeitpunkt des Canvas und mit einer eventuellen geplanten Verzögerung des Schritts.
• API-ausgelöster Eintritt: Bestätigen Sie den Eintritt mit einem Canvas-Segmentfilter und Export, wie unter Nutzer:in ist nicht in den Canvas eingetreten beschrieben.
• Aktionspfade oder Nachrichtenschritt-Trigger: Bestätigen Sie, dass die/der Nutzer:in das erforderliche Event ausgeführt hat und dass Event-Eigenschaften im Schritt verfügbar sind.
• In-App-Nachricht-Schritte: In-App-Nachrichten werden beim nächsten Sitzungsstart gesendet, nachdem die/der Nutzer:in den Schritt erreicht hat, 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/der Nutzer:in beim Eintritt nicht der Canvas-Kontrollgruppe zugewiesen wurde.
• 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 bei Multi-Channel-Canvases keine Einzelkanalfilter zur Zielgruppe hinzu.
• Zustellungsvalidierungen: Wenn Sie Zielgruppe beim Nachrichtenversand validieren für einen Nachrichtenschritt 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 auch nach einem Abbruch durch Ruhezeiten im Canvas verbleiben.
• Race-Conditions: Wenn die/der Nutzer:in mehrere Aktionen gleichzeitig ausgelöst hat, siehe Race-Conditions.

Wichtig

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

Informationen zum Sendezeitpunkt von In-App-Nachrichten nach Verzögerungen oder Verzweigungen finden Sie in den Canvas-FAQ. Informationen zum Vorrücken im Nachrichtenschritt mit Decision-Split oder Aktionspfaden finden Sie unter Nachrichtenschritte für das Vorrücken von Nutzer:innen überprüfen in der Canvas-QA-Checkliste.

Wichtig

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

Wenige oder keine Canvas-Eintritte

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

Beginnen Sie mit der Canvas-QA-Checkliste und überprüfen Sie dann Folgendes:

• Das Canvas ist aktiv und der aktuelle Zeitpunkt liegt innerhalb des geplanten Eintrittsfensters.
• Die Eintrittseinstellungen (Wiedereintritt, maximale Eintritte und Eintrittsbegrenzungen) erlauben den Nutzer:innen, die Sie erwarten, den Eintritt.
• 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 im Vergleich zu denen, die Nachrichten erhalten.
• Es ist zu erwarten, dass Workspace-Rate-Limits oder Entry-Warteschlangen Verzögerungen zwischen dem Zeitpunkt verursachen, zu dem Nutzer:innen sich qualifizieren, und dem Zeitpunkt, zu dem sie eintreten oder in einen Schritt fortschreiten.

Für eine:n einzelne:n Nutzer:in folgen Sie dem standardmäßigen Untersuchungspfad. Für Null-Eintritte im Zusammenhang mit der Zeitumstellung lesen Sie den aufklappbaren Abschnitt unter Nutzer:in ist nicht in das Canvas eingetreten.

Weniger Versendungen als erwartet

Symptom: Versendungen oder Zustellungen liegen unter der geschätzten Zielgruppengröße eines Canvas-Schritts.

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

Wenn ein Nachrichten-Schritt viele eingetretene Nutzer:innen, aber wenige Versendungen zeigt, prüfen Sie, ob Liquid abort_message() den Versand abgebrochen hat. Informationen zur Bestätigung dieser Abbrüche, fehlender Attribute und Testversendungen finden Sie unter Fehlerbehebung bei hohen Abbruchraten.

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

Verwenden Sie Messaging Observability, um Abbruch- und Verwerfungsgründe auf Schrittebene einzusehen.

Abweichungen in den Canvas-Analytics

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

Die Zuweisung zu Kontrollgruppe und Variante 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 stattdessen die Sendeeinstellungen pro Schritt, um einzuschränken, wer jeden Nachrichtentyp erhält, anstatt die Zielgruppe mit Kanalfiltern einzuengen.

Unterscheiden Sie die Canvas-Kontrollgruppe von der globalen Kontrollgruppe. Filterdefinitionen finden Sie unter Was ist der Unterschied zwischen „Hat Canvas-Variante nicht betreten“ und „Ist nicht in der Canvas-Kontrollgruppe“? 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 eingetreten sind.

Dies kann passieren, wenn Sie den Datumsbereich-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/jedes Nutzer:in 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 einschließt, in dem sie Nachrichten erhalten haben.
• Sie sehen möglicherweise mehr Nutzer:innen, die zum nächsten Schritt wechseln, als den vorherigen Schritt betreten haben, wenn Ihr Bereich nur Austritte, aber nicht die vorherigen Eintritte erfasst.

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

Informationen zu Konversionsratendefinitionen und Analytics auf Schrittebene finden Sie unter Analytics und Konversionen in den Canvas-FAQ.

Editor- und Speicherprobleme

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

Hinweis

Wenn Sie denselben Canvas in mehreren Browser-Tabs geöffnet haben, kann das Speichern in einem Tab Änderungen überschreiben, die in einem anderen veralteten Tab vorgenommen wurden. Diese Race-Condition kann dazu führen, dass Zielgruppenfilter entfernt oder unbeabsichtigte Änderungen angewendet werden. Um Datenverlust zu vermeiden, schließen Sie alle doppelten Tabs, bevor Sie einen Canvas bearbeiten und speichern.

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 damit die Menge an UI zu verringern, die der Browser rendern muss.
• Versuchen Sie es mit einem anderen Webbrowser.

Wenn der Canvas nicht geladen wird und nicht weiter fortschreitet, wurde eine vorherige Version nicht korrekt gespeichert und enthält möglicherweise ungültige Schritte. Duplizieren Sie den Canvas über das Dashboard. Wenn das Problem weiterhin besteht, erstellen Sie ein Support-Ticket.

Fügen Sie bei „Request Timed Out“-Support-Tickets eine Bildschirmaufnahme, Zeitstempel und Zeitzone, Browser und Version, Schritte zur Reproduktion und optional ein HAR-Protokoll aus den Entwicklertools Ihres Browsers bei. Weitere Informationen finden Sie unter Was sollte ich bei der Einreichung eines Support-Tickets für einen „Request Timed Out“-Fehler angeben? in den Canvas-FAQ.

Eine Canvas-Variante kann aufgrund eines archivierten Segments nicht gelöscht werden

Wenn Braze das Löschen einer Canvas-Variante blockiert, weil ein Segment-Filter diese Variante noch referenziert, öffnen Sie das Segment, das die Referenz verwendet – einschließlich archivierter Segmente – und entfernen Sie die Variante aus den Filtern. Nachdem Sie das Segment gespeichert haben, kehren Sie zum Canvas zurück und versuchen Sie erneut, die Variante zu löschen.

Um herauszufinden, welche Segmente ein Canvas referenzieren, öffnen Sie das Canvas und überprüfen Sie seine Zielgruppenfilter, oder prüfen Sie den Abschnitt Messaging-Nutzung jedes Segments auf verknüpfte Canvases.

Verhalten bei gestopptem Canvas

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

Wenn Sie ein Canvas stoppen, können Nutzer:innen nicht 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 Aktionspfade-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 sie ausstehende Schritte noch erhalten.

Weitere Details finden Sie unter Was passiert, wenn Sie ein Canvas stoppen? in den Canvas-FAQ.

Fehler „Zu viele Canvas-Verzweigungen“

Symptom: Sie sehen den Fehler „Too many Canvas branches“, wenn Sie ein geplantes Canvas starten.

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

So beheben Sie das Problem:

• Reduzieren Sie die Schrittverzweigungen im Canvas.
• Reduzieren Sie die Größe der Eintrittszielgruppe.
• 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 erstellen Sie es mit Canvas-Komponenten neu.

Wenn Sie das Canvas dennoch ohne Änderungen starten müssen und nicht zu Canvas Flow wechseln können, kontaktieren Sie 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 Folgendes an:

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