Fehlersuche im Braze SDK
Erfahren Sie, wie Sie den integrierten Debugger des Braze SDK verwenden, damit Sie Probleme in Ihren SDK-gestützten Kanälen beheben können, ohne die ausführliche Protokollierung in Ihrer App aktivieren zu müssen.
Für eine eingehendere Untersuchung können Sie auch die ausführliche Protokollierung aktivieren, um detaillierte SDK-Ausgaben zu erfassen, und erfahren, wie Sie ausführliche Protokolle lesen – für bestimmte Kanäle.
Voraussetzungen
Um den Braze SDK-Debugger nutzen zu können, benötigen Sie die Berechtigungen „PII anzeigen“ und „Nutzerprofile anzeigen (PII geschwärzt)“. Um Ihre Debugging-Sitzungsprotokolle herunterzuladen, benötigen Sie außerdem die Berechtigung „Nutzerdaten exportieren“. Darüber hinaus muss Ihr Braze SDK die folgenden Mindestversionen erfüllen oder darauf verweisen:
Um Debugger-Protokolle zu erfassen, wenn Braze.configuration.logger.level auf .disabled gesetzt ist, verwenden Sie Swift SDK 11.9.0 oder höher. Weitere Informationen finden Sie in den Swift-Changelogs.
Fehlersuche im Braze SDK
Um das Debugging für das Braze Web SDK zu aktivieren, können Sie einen URL-Parameter verwenden.
1. Schritt: Schließen Sie Ihre App
Bevor Sie mit der Fehlersuche beginnen, schließen Sie die App, bei der gerade ein Problem auftritt. Sie können die App zu Beginn Ihrer Sitzung neu starten.
2. Schritt: Erstellen Sie eine Debugging-Sitzung
Gehen Sie in Braze zu Einstellungen und wählen Sie dann unter Einrichtung und Tests die Option SDK-Debugger aus.
Wählen Sie Debugging-Sitzung erstellen.
3. Schritt: Nutzer:in auswählen
Suchen Sie nach einer Nutzer:in anhand der E-Mail-Adresse, der external_id, des Nutzer-Alias oder des Push-Tokens. Wenn Sie bereit sind, Ihre Sitzung zu starten, wählen Sie Nutzer:in auswählen.
4. Schritt: App neu starten
Starten Sie zunächst die App und bestätigen Sie, dass Ihr Gerät gekoppelt ist. Wenn die Kopplung erfolgreich war, starten Sie Ihre App neu—so stellen Sie sicher, dass die Initialisierungsprotokolle der App vollständig erfasst werden.
5. Schritt: Führen Sie die Reproduktionsschritte durch
Nachdem Sie Ihre App neu gestartet haben, folgen Sie den Schritten, um den Fehler zu reproduzieren.
Achten Sie bei der Reproduktion des Fehlers darauf, die Reproduktionsschritte so genau wie möglich zu befolgen, damit Sie hochwertige Protokolle erstellen können.
6. Schritt: Beenden Sie die Sitzung
Wenn Sie mit Ihren Reproduktionsschritten fertig sind, wählen Sie Sitzung beenden > Schließen.
Es kann einige Minuten dauern, bis die Protokolle generiert sind – je nach Länge der Sitzung und der Qualität der Netzwerkverbindung.
7. Schritt: Sitzung teilen oder exportieren (optional)
Nach der Sitzung können Sie Ihre Sitzungsprotokolle als CSV-Datei exportieren. Außerdem können andere Personen Ihre Sitzungs-ID verwenden, um nach Ihrer Debug-Sitzung zu suchen, sodass Sie ihnen Ihre Protokolle nicht direkt senden müssen.
