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 bestimmten Nutzer:innen oder bei 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 Eintrittszeitplan (geplantes Fenster, Zeitzone, aktionsbasierter Trigger oder API-gesteuerter Eintritt) mit dem erwarteten Eintrittszeitpunkt der Nutzer:innen übereinstimmt.
3. Prüfen Sie den Messaging-Verlauf von Nutzer:innen, indem Sie zu Audience > Search users navigieren, das Profil öffnen und Messaging History (letzte 30 Tage) auswählen.
   • Wenn kein Eintrag für den erwarteten Versandzeitpunkt vorhanden ist, liegt das Problem beim Eintritt, nicht bei der Nachricht. Gehen Sie zu Nutzer:in ist nicht in das Canvas eingetreten.
4. Prüfen Sie den Canvas-Changelog und die Changelogs aller Segmente, die im Targeting verwendet werden. Bestätigen Sie, dass Zielgruppe, Schritte oder Versandeinstellungen während des Vorfalls nicht geändert wurden.
5. Prüfen Sie die aggregierten Ergebnisse auf der Canvas-Analytics-Seite, indem Sie das Messaging-Diagnostics-Dashboard öffnen und Abbruch- und Verwerfungsgründe überprüfen.
   • Wenn Sie ein Ergebnis sehen, das Sie nicht zuordnen können, lesen Sie Abbruchergebnisse in der Diagnostics-Dokumentation.
   • Wenn ein Schritt null Eintritte (nicht null Versendungen) anzeigt, prüfen Sie den vorherigen Schritttyp (Aktionspfade, Verzögerung, Zielgruppenpfade oder Decision-Split).
6. Wenn Sie weiterhin blockiert sind, kontaktieren Sie den Braze-Support innerhalb von 30 Tagen mit der Canvas-ID, den betroffenen Nutzer:innen-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 Ihre Konfiguration zu validieren.

Nutzer:in ist nicht in den Canvas eingetreten

Symptom: Eine 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 die Zielgruppe erfüllen, bevor Braze den Entry-Trigger auswertet (mit Ausnahme von Attributänderungs-Triggern). Ein Trigger allein garantiert keinen Entry, wenn die Nutzer:in zum Zeitpunkt der Auswertung nicht zur Zielgruppe gehörte.

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

• Wiederzulässigkeit: Bestimmt, ob eine Nutzer:in nach dem Verlassen des Canvas erneut eintreten darf (Zeitfenster und Einstellung Nutzer:innen erneuten Canvas-Entry erlauben).
• Wiedereintritt: Bestimmt, ob eine Nutzer:in, die sich aktuell im Canvas befindet, einen parallelen Pfad betreten kann.

Eine Nutzer:in kann wiederzulässig sein, aber blockiert werden, weil sie sich noch im Canvas befindet, oder sie kann den Canvas verlassen haben, sich aber noch außerhalb des Wiederzulässigkeitsfensters befinden. Prüfen Sie beide Einstellungen, wenn eine 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 Nutzer:in den Trigger während des Entry-Fensters ausgeführt hat.
• Zielgruppe zum Zeitpunkt der Auswertung: Überprüfen Sie die Änderungsprotokolle von Segmenten und Filtern. User Lookup kann bei einigen Filtertypen ein falsch-positives Ergebnis anzeigen (z. B. datumsbezogene Attribute im String-Format).
• Entry-Limits: Maximale Eintritte oder Zielgruppen-Obergrenzen 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 Nutzer:in hat möglicherweise die Exit-Kriterien vor oder während des Entry erfüllt. Wenn Entry und Exit dasselbe Event verwenden, siehe Übereinstimmung von Entry- und Exit-Kriterien.
• API-getriggerter Entry: Bestätigen Sie, dass die 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 Anzahl der Canvas-Eintritte.

Braze dedupliziert mehrere Entry-Versuche, die im selben Moment auftreten, sodass Sie möglicherweise weniger Canvas-Eintritte als Trigger-Events sehen. Zum Testen mehrerer Eintritte sollten Sie Trigger-Events mindestens eine Sekunde auseinanderhalten.

Wenn eine Nutzer:in denselben Trigger innerhalb einer Sekunde mehrmals ausführt, verarbeitet Braze nur einen Entry. Überprüfen Sie die Messaging-Diagnose auf Ergebnisse wie Nutzer:in nicht wiederzulässig, wenn Wiedereintritts- oder Wiederzulässigkeitsregeln gelten.

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

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

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

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

• Angepasste Events oder Kauf-Trigger: Bestätigen Sie, dass das Event in Analytics > Bericht für angepasste Events (oder Umsatz für Käufe) erscheint. Vergleichen Sie den Event-Zeitstempel mit dem Zeitpunkt, zu dem das Canvas live ging, und mit einer möglichen geplanten Verzögerung beim Schritt.
• API-getriggerter Entry: Bestätigen Sie den Entry mit einem Canvas-Segmentfilter und -export, wie in Nutzer:in ist nicht in das Canvas eingetreten beschrieben.
• Aktionspfade oder Nachrichten-Schritt-Trigger: Bestätigen Sie, dass die Nutzer:in das vorausgesetzte 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 Nutzer:in den Schritt betreten 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 Nutzer:in beim Entry der Canvas-Kontrollgruppe zugewiesen wurde.
• Kanalberechtigung und Versandeinstellungen: Bestätigen Sie den Abo-Status, den Push-Aktivierungsstatus und die Versandeinstellungen pro Schritt (zum Beispiel Abo-Einstellungen auf nur 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 verschieben, unterdrücken oder abbrechen. Nutzer:innen können nach einem Ruhezeiten-Abbruch weiterhin im Canvas verbleiben.
• Race-Conditions: Wenn die Nutzer:in mehrere Aktionen gleichzeitig ausgelöst hat, siehe Race-Conditions.

Wichtig

Wenn ein Canvas-Nachrichten-Schritt einen Versand abbricht, rückt die Nutzer:in 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.

Für Filter auf Schrittebene, Konflikte zwischen Branches und IAM-Branching-Verhalten siehe Start mit Canvas Flow – Fehlerbehebung und die Canvas-FAQ.

Wichtig

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

Niedrige oder null Canvas-Eintritte

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

Beginnen Sie mit der Checkliste zum Start mit Canvas Flow und überprüfen Sie dann Folgendes:

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

Für einzelne Nutzer:innen folgen Sie dem standardmäßigen Untersuchungspfad. Bei Null-Eintritten aufgrund von Zeitumstellungen siehe den aufklappbaren Abschnitt unter Nutzer:in ist nicht in den Canvas eingetreten.

Weniger Versendungen als erwartet

Symptom: Versendungen 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 Versendungen bei vorhandenen Impressionen ist bei In-App-Nachrichten erwartetes Verhalten).

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

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

Verwenden Sie das Messaging-Diagnose-Dashboard, um Abbruch- und Drop-Gründe auf Schrittebene einzusehen.

Analytics-Abweichungen bei Canvas

Symptom: Canvas-Analytics sehen falsch aus (Kontrollgruppenaufteilung, 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 einer Variante zugewiesen werden. Verwenden Sie die Sendeeinstellungen pro Schritt, 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 „Hat keine Canvas-Variante 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 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 dargestellten Metriken möglicherweise nur einen Teil der Journey jeder:jedes Nutzer:in an.

Beispiele:

• 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 wechseln, als den vorherigen Schritt betreten haben, wenn Ihr Datumsbereich nur die Exits, aber nicht die früheren Eintritte erfasst.

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

Informationen zu Konversionsraten-Definitionen und schrittweisen Analytics 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.

Hinweis

Wenn Sie dasselbe 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 ein 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-Zoomsteuerung, um die Ansicht auf 25 % oder 10 % zu reduzieren und so die Menge an UI zu verringern, die der Browser rendern muss.
• Versuchen Sie einen anderen Webbrowser.

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

Für Support-Tickets bei „Request Timed Out“ fügen Sie eine Bildschirmaufnahme, Zeitstempel und Zeitzone, Browser und Version, Schritte zur Reproduktion und optional ein HAR-Log 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 eines gestoppten 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-Versendungen, die bereits an Ihren E-Mail-Anbieter übergeben wurden, können nicht zurückgerufen werden.

Nutzer:innen, die sich in einem Verzögerungs- 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 noch ausstehende Schritte erhalten.

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

Fehler „Zu viele Canvas-Branches“

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 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 – beim Speichern eines Entwurfs erscheint sie nicht.

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 zu 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, 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 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 Diagnostics
• Bei „Request Timed Out“-Fehlern im Editor die unter Editor- und Speicherprobleme aufgeführten Details