Fehlerbehebung bei Aufzeichnungen

Pro Plan

Lösen Sie häufige Probleme mit Session-Replay und Heatmaps mit diesem Fehlerbehebungsleitfaden.

Keine Aufzeichnungen vorhanden

Aufzeichnungsstatus prüfen

Überprüfen Sie zunächst, ob die Aufzeichnung für die Website aktiviert ist:

Öffnen Sie die Website in Domains, öffnen Sie deren Einstellungen und gehen Sie zur Registerkarte Erweitert
Bestätigen Sie unter den Feature-Umschaltern, dass Session Replay aktiviert ist
Wenn Sie nur Aufzeichnungen um Fehler herum möchten, überprüfen Sie den Aufzeichnungsmodus (er kann auf „Nur Sitzungen mit Fehlern" oder „Alle Sitzungen aufzeichnen" eingestellt werden)

Tracking-Script überprüfen

Stellen Sie sicher, dass das Script installiert ist:

Seitenquelltext anzeigen
Nach „zenovay" suchen
Überprüfen Sie, ob das Script fehlerfrei geladen wird

Konsole auf Fehler prüfen

Öffnen Sie die Browser-Konsole:

Rechtsklick → Untersuchen
Gehen Sie zur Registerkarte Konsole
Suchen Sie nach Zenovay-Fehlern

Häufige Fehler:

Fehler	Lösung
Script nicht gefunden	Tracking-Code neu installieren
CORS-Fehler	Domain-Konfiguration prüfen
Von CSP blockiert	Content Security Policy aktualisieren
Netzwerkfehler	Internet/Firewall prüfen

Tarif-Limits

Überprüfen Sie, ob Ihr Tarif Session Replay beinhaltet (Pro-Tarif oder höher) und ob die Aufzeichnungen innerhalb des Aufbewahrungszeitraums liegen:

Tarif	Aufbewahrung
Pro	60 Tage
Scale	120 Tage
Enterprise	180 Tage

Einwilligungskonfiguration

Bei Verwendung von Einwilligungen:

Überprüfen Sie, ob die Einwilligung erteilt wird
Prüfen Sie die Einwilligungsintegration
Testen Sie mit erteilter Einwilligung

Aufzeichnungen werden nicht abgespielt

Ladeprobleme

Wenn die Wiedergabe nicht startet:

Seite neu laden
- Cache leeren, falls nötig
Internetverbindung prüfen
- Anderes Netzwerk versuchen
Anderen Browser versuchen
- Chrome empfohlen
Erweiterungen deaktivieren
- Werbeblocker können stören

Wiedergabefehler

Wenn Fehlermeldungen erscheinen:

Fehler	Lösung
„Laden fehlgeschlagen"	Sitzung ist möglicherweise beschädigt
„Sitzung abgelaufen"	Außerhalb des Aufbewahrungszeitraums
„Zugriff verweigert"	Berechtigungen prüfen
„Ungültige Sitzung"	Support kontaktieren

Browser-Anforderungen

Stellen Sie sicher, dass der Browser folgende Funktionen unterstützt:

WebGL
Modernes JavaScript
Ausreichend Arbeitsspeicher

Visuelle Fehler

Fehlende Inhalte

Wenn Elemente leer erscheinen:

Ursache	Lösung
Datenschutz-Maskierung	Maskierungseinstellungen prüfen
Dynamische Inhalte	Können unterschiedlich geladen werden
Drittanbieter-Inhalte	Cross-Origin kann nicht erfasst werden
Lazy Loading	Wird möglicherweise vor dem Laden nicht erfasst

Fehlerhafte Darstellung

Wenn das Styling falsch aussieht:

Schriftartersetzung
- Benutzerdefinierte Schriftarten laden möglicherweise nicht
- Ersatzschriftarten werden verwendet
CSS-Unterschiede
- Einige dynamische CSS können unterschiedlich sein
- Überprüfen Sie auf CSS-in-JS-Probleme
Responsive-Probleme
- Viewport kann unterschiedlich sein
- Unterschiede bei Breakpoints

Fehlende Bilder

Bilder werden möglicherweise nicht angezeigt, wenn:

Sie von einer anderen Domain bereitgestellt werden
Sie durch Authentifizierung geschützt sind
Sie nicht mehr verfügbar sind

Layout-Verschiebungen

Wenn das Layout nicht übereinstimmt:

Dynamische Inhaltsänderungen
A/B-Test-Varianten
Zeitbasierte Inhalte

Heatmap-Probleme

Leere Heatmap

Wenn die Heatmap keine Daten anzeigt:

Datenvolumen prüfen
- Eine Seite benötigt ausreichend aktuelle Aufrufe, bevor eine Heatmap generiert wird
- Zeigen Sie sie innerhalb eines Zeitfensters an, das tatsächlich Besuche hat
Seite überprüfen
- Wählen Sie denselben Pfad, der den Traffic erhielt
- Abfrageparameter können Traffic auf verschiedene URLs aufteilen
Heatmap-Typ prüfen
- Der Viewer wechselt zwischen Click- und Scroll-Heatmaps
- Wechseln Sie die Typen, um zu bestätigen, dass Sie den mit Daten ansehen

Ungenaue Klickdaten

Wenn Klicks nicht stimmen:

Problem	Ursache
Klicks auf falschen Elementen	Viewport-Unterschiede
Falsch gruppiert	Responsive-Layout-Änderungen
Fehlende Klicks	Sampling oder Limits

Fehlende Scroll-Daten

Wenn die Scroll-Heatmap leer ist:

Überprüfen Sie, ob Scroll-Events erfasst werden
Seitenlänge prüfen
Bestätigen Sie, dass JavaScript ausgeführt wird

Leistungsprobleme

Langsame Wiedergabe

Wenn die Wiedergabe ruckelt:

Wiedergabegeschwindigkeit reduzieren
- 0,5x oder 1x versuchen
Andere Tabs schließen
- Arbeitsspeicher freigeben
Netzwerkgeschwindigkeit prüfen
- Pufferung kann auftreten
Anderen Browser versuchen
- Chrome ist oft am schnellsten

Hoher Ressourcenverbrauch

Wenn zu viel CPU/Arbeitsspeicher verbraucht wird:

Zu relevanten Abschnitten springen
- Nicht die gesamte Sitzung abspielen
Ereignis-Panel schließen
- Reduziert das Rendering
Animationen deaktivieren
- In den Einstellungen, falls verfügbar

Auswirkungen auf die Website-Leistung

Wenn die Aufzeichnung Ihre Website beeinträchtigt:

Aufzeichnungsumfang reduzieren
- Fügen Sie schwere oder sensible Seiten zu Ausgeschlossene Routes in Einstellungen → Erweitert hinzu
- Setzen Sie Aufzeichnungsmodus auf „Nur Sitzungen mit Fehlern", damit Sitzungen nur erfasst werden, wenn etwas schiefgeht
Metriken überwachen
- Core Web Vitals prüfen
- Mit deaktivierter Aufzeichnung vergleichen

Probleme mit der Datengenauigkeit

Abweichung bei der Sitzungsanzahl

Wenn die Zahlen nicht mit den Analytics übereinstimmen:

Grund	Erklärung
Sampling	Bei hohem Traffic wird möglicherweise nur eine Stichprobe erfasst
Einwilligung	Nicht alle Benutzer haben zugestimmt
Werbeblocker	Blockieren das Aufzeichnungs-Script
Seitentypen	Einige Seiten sind ausgeschlossen

Abweichungen bei der Dauer

Wenn die Dauer falsch erscheint:

Leerlaufzeit wird möglicherweise übersprungen
Tab-Wechsel beeinflusst die Zeitmessung
Hintergrund-Tabs können pausiert werden

Abweichung bei der Klickanzahl

Klickzahlen können von Analytics abweichen:

Heatmaps verwenden möglicherweise Sampling
Unterschiedliche Klick-Definitionen
Viewport-/Element-Zuordnung

Konfigurationsprobleme

Maskierung zu aggressiv

Die Maskierung wird durch zwei Umschalter in der Registerkarte Einstellungen → Erweitert der Website gesteuert:

Alle Eingabefelder maskieren (standardmäßig aktiviert) ersetzt das, was Besucher eingeben, durch Platzhalter.
Textinhalte maskieren maskiert auch den sichtbaren Seitentext.

Wenn zu viel verborgen wird, deaktivieren Sie Textinhalte maskieren, damit der reguläre Seiteneinhalt erfasst wird, während Eingabewerte maskiert bleiben.

Maskierung funktioniert nicht

Wenn sensible Daten immer noch in einer Aufzeichnung sichtbar sind:

Bestätigen Sie, dass die Maskierungs-Umschalter aktiviert sind in Einstellungen → Erweitert. Alle Eingabefelder maskieren sollte aktiviert sein.
Zeichnen Sie nach dem Speichern neu auf. Die Maskierung gilt für neue Aufzeichnungen, daher behalten bestehende Aufzeichnungen die Maskierung bei, die beim Erfassen gültig war.
Halten Sie sensible Seiten ganz aus dem Replay heraus. Fügen Sie sie zu Ausgeschlossene Routes hinzu (siehe unten), wenn sie nie aufgezeichnet werden sollen.

Ausgeschlossene Seiten werden aufgezeichnet

Seiten, die Sie nicht aufgezeichnet haben möchten, werden unter Ausgeschlossene Routes in Einstellungen → Erweitert aufgelistet (ein Pfad pro Zeile). Wenn eine ausgeschlossene Seite immer noch angezeigt wird:

Überprüfen Sie, dass der Pfad dem URL-Pfad der Seite entspricht
Bestätigen Sie, dass Sie die Änderung gespeichert haben
Denken Sie daran, dass Ausschlüsse für neue Aufzeichnungen gelten, nicht für bereits erfasste

Integrationsprobleme

Wenn die Integration nicht richtig funktioniert:

Timing prüfen
- Einwilligung vor der Aufzeichnung
Events überprüfen
- Einwilligungssignale werden gesendet
Manuell testen
- Einwilligung erteilen, Aufzeichnung prüfen

Single Page Apps

Das Tracking-Script handhabt SPA-Routenänderungen automatisch (es lauscht auf History API-Navigation), daher ist keine zusätzliche Einstellung erforderlich. Wenn eine Single-Page-App immer noch nicht ordnungsgemäß funktioniert:

Problem	Was zu überprüfen ist
Seitenwechsel werden nicht erfasst	Bestätigen Sie, dass das Script einmal beim ersten Rendern geladen wird und nicht bei jedem Routenwechsel erneut injiziert wird
Doppelte Sitzungen	Stellen Sie sicher, dass das Script-Tag nur einmal in Ihrer App-Shell enthalten ist
Fehlende Navigation	Überprüfen Sie, dass Ihr Router die Standard-History API (pushState) verwendet, damit Routenänderungen erkannt werden können

Drittanbieter-Scripts

Konflikte mit anderen Tools:

Überprüfen Sie auf Script-Konflikte
Überprüfen Sie die Ladereihenfolge
Testen Sie isoliert

Datenwiederherstellung

Verlorene Sitzungen

Leider:

Gelöschte Sitzungen können nicht wiederhergestellt werden
Abgelaufene Sitzungen werden dauerhaft entfernt
Exportieren Sie vor Ablauf der Aufbewahrungsfrist

Beschädigte Sitzungen

Wenn Sitzungen beschädigt erscheinen:

Möglicherweise unvollständiger Upload
Netzwerkunterbrechung während der Erfassung
Kontaktieren Sie den Support mit der Sitzungs-ID

Hilfe erhalten

Bereitzustellende Informationen

Wenn Sie den Support kontaktieren:

Sitzungs-ID (bei einer bestimmten Sitzung)
Betroffene Seiten-URL
Browser und Version
Fehlermeldungen
Schritte zur Reproduktion
Screenshots/Aufzeichnungen

Support-Kanäle

In-App-Chat
[email protected]
Hilfe-Center-Tickets

Debug-Modus

Aktivieren Sie die Debug-Protokollierung, indem Sie data-debug zu Ihrem Script-Tag hinzufügen:

<script defer
  src="https://api.zenovay.com/z.js"
  data-tracking-code="YOUR_TRACKING_CODE"
  data-debug="true">
</script>

Überprüfen Sie die Konsole auf detaillierte Protokolle.

Vorbeugende Maßnahmen

Regelmäßiges Testen

Testen Sie die Aufzeichnung regelmäßig:

Nach Website-Updates
Nach Tracking-Änderungen
Nach Einwilligungs-Updates

Überwachung

Richten Sie Benachrichtigungen ein für:

Rückgang der Aufzeichnungsanzahl
Anstieg der Fehlerrate
Leistungsveränderungen

Dokumentation

Führen Sie Aufzeichnungen über:

Konfigurationsänderungen
Ausschlussregeln
Bekannte Probleme