Dein Conversion-Tracking löst nicht mehr aus. Der Traffic verschwindet. Ein Ereignis wird nicht mehr ausgelöst. Etwas ist kaputtgegangen, aber du weißt nicht, was. Debugging ist der Prozess, das Problem zu finden und zu beheben.
Die meisten Tracking-Probleme haben offensichtliche Ursachen, wenn du weißt, wo du suchen musst. Wer Debugging beherrscht, spart sich Stunden des Ratens.
Der Debugging-Prozess
Schritt 1: Bestätige, dass das Problem existiert
Ist das Tracking wirklich defekt, oder hast du die Daten falsch gelesen? Prüfe mehrere Ansichten. Prüfe verschiedene Zeiträume. Bestätige, dass das Problem echt und dauerhaft ist.
Schritt 2: Finde heraus, wann es angefangen hat
Wann hat das Tracking aufgehört? Gestern? Letzte Woche? Kannst du den Tag genau bestimmen? Sieh dir historische Daten an. Wann kam der Einbruch? Das grenzt die möglichen Ursachen ein.
Schritt 3: Prüfe, ob sich etwas geändert hat
Hast du kürzlich Code veröffentlicht? Die Konfiguration geändert? Eine neue Funktion gestartet? Änderungen verursachen oft Probleme. Was hat sich rund um den Zeitpunkt geändert, als das Tracking ausfiel?
Schritt 4: Nutze Debug-Werkzeuge
Nutze den Debug-Modus deines Analysetools. Nutze die Entwicklertools des Browsers. Nutze Netzwerküberwachung. Beobachte Anfragen in Echtzeit, um zu sehen, wo sie scheitern.
Schritt 5: Teste manuell
Erzeuge Test-Traffic. Teste die Conversion. Teste das Ereignis. Wenn dein Test das Tracking auslöst, echter Traffic aber nicht, liegt das Problem in der Live-Umgebung. Wenn der Test auch nicht funktioniert, liegt das Problem in der Umsetzung.
Schritt 6: Behebe und prüfe
Wende die Korrektur an. Teste erneut. Prüfe, ob die Korrektur funktioniert, bevor du das Problem für erledigt erklärst.
Häufige Tracking-Probleme und wie du sie debuggst
Der Tracking-Code löst nicht aus
Öffne die Entwicklertools des Browsers. Gehe zum Tab "Netzwerk". Suche nach Anfragen an deine Analyse-Domain. Siehst du sie? Wenn nicht, löst der Code nicht aus.
Prüfe die Browser-Konsole auf JavaScript-Fehler. Fehler verhindern, dass der Tracking-Code läuft. Behebe den Fehler, dann löst das Tracking aus.
Der Tracking-Code lädt, aber Daten erscheinen nicht in den Berichten
Die Anfrage wird gesendet (du siehst sie im Tab "Netzwerk"), erscheint aber nicht in den Berichten. Mögliche Ursachen: Eine Firewall blockiert die Anfrage, ein Werbeblocker blockiert sie, die Property-ID ist falsch oder das Conversion-Ziel ist falsch konfiguriert.
Prüfe, ob du die richtige Property trackst. Prüfe, ob Filter die Testdaten nicht ausschließen. Prüfe, ob die Bot-Filterung deinen Test nicht erfasst.
Das Tracking löst manchmal aus, aber nicht zuverlässig
Sporadische Probleme sind schwerer zu debuggen. Es können Race Conditions sein (das Tracking löst aus, bevor die Daten bereit sind). Es können Netzwerk-Timeouts sein. Es kann Code mit Bedingungen sein, der nicht immer läuft.
Sieh dir den Code an. Gibt es Bedingungen, die das Auslösen des Trackings manchmal verhindern? Gibt es Timeouts? Passiert das Tracking im richtigen Moment?
Das Conversion-Tracking löst aus, aber Conversions erscheinen nicht
Der Tracking-Code löst aus. Die Anfrage erreicht den Server. Aber Conversions erscheinen nicht in den Berichten. Mögliche Ursachen: Das Conversion-Ziel ist nicht konfiguriert, die Ziel-URL passt nicht zur tatsächlichen Conversion-Seite oder das Ziel löst mehrfach pro Sitzung aus (und zählt als eine).
Prüfe die Konfiguration deines Conversion-Ziels. Passt die URL? Löst das Ziel beim richtigen Ereignis aus? Ist es so eingestellt, dass es einmal oder mehrfach zählt?
Das Event-Tracking löst aus, aber die Daten sind unvollständig
Ereignisse lösen aus, aber manche Ereignisparameter fehlen. Der Umsatz steht bei 0 $. Die Produkt-ID ist leer. Das Ereignis wird erfasst, aber unvollständig.
Prüfe deinen Tracking-Code. Werden Parameter richtig erfasst? Werden sie an den Tracking-Aufruf übergeben? Sind die Daten zum Zeitpunkt des Trackings verfügbar?
Werkzeuge zum Debuggen
Entwicklertools des Browsers
Tab "Netzwerk": Zeigt die gesendeten Anfragen. Tab "Konsole": Zeigt JavaScript-Fehler. Beides ist für das Debugging von clientseitigem Tracking unverzichtbar.
Debug-Modus der Analyse
Die meisten Tools haben einen Debug-Modus. Google Analytics hat DebugView. Produktanalyse-Plattformen haben eine Live-Ansicht der Ereignisse. Sie zeigen Ereignisse in Echtzeit, während sie auslösen.
Browser-Erweiterungen
Erweiterungen zur Prüfung von Tags und Tracking-Code helfen, den Tracking-Code zu untersuchen und Probleme zu debuggen.
Server-Logs
Server-Logs zeigen alle Anfragen, auch Tracking-Anfragen. Prüfe dort, ob Tracking-Anfragen deinen Server überhaupt erreichen.
Tracking-Probleme verhindern
Teste vor dem Ausspielen
Spiele Änderungen am Tracking-Code nicht ungetestet in die Live-Umgebung aus. Teste zuerst im Staging. Prüfe, dass das Tracking im Staging funktioniert, bevor du live gehst.
Überwache nach dem Ausspielen
Beobachte nach dem Ausspielen von Änderungen 24 Stunden lang. Achte auf Einbrüche bei Traffic oder Conversions. Finde Probleme schnell.
Führe ein Änderungsprotokoll
Dokumentiere jede Änderung am Tracking-Code. Wann sie gemacht wurde, was sich geändert hat und warum. So kannst du Probleme zu ihrer Ursache zurückverfolgen.
Nutze Versionskontrolle
Halte den Tracking-Code in der Versionskontrolle (Git). So kannst du Versionen vergleichen, wenn etwas kaputtgeht. Bei Bedarf kannst du zur vorherigen Version zurückkehren.
Häufig gestellte Fragen
Woher weiß ich, ob mein Tracking defekt ist oder der Traffic nur niedrig?
Vergleiche mit normalen Mustern. Wenn der Traffic normalerweise bei 1000 liegt und plötzlich auf 100 fällt, stimmt etwas nicht. Wenn er auf 800 fällt und du in der Woche keine Kampagnen hattest, ist wahrscheinlich alles in Ordnung. Mit dem Website-Builder von WEMASY kannst du das direkt auf deiner Website einrichten.
Kann ich Tracking ohne Entwicklertools debuggen?
Nicht leicht. Entwicklertools sind unverzichtbar. Wenn du dich damit nicht wohlfühlst, bitte einen Entwickler um Hilfe oder nutze die eingebauten Debug-Funktionen deines Analysetools.
Wie lange sollte Debugging dauern?
Einfache Probleme (falsche Property-ID, falsch konfiguriertes Ziel): 15-30 Minuten. Komplexe Probleme (Race Conditions, Netzwerkprobleme): 1-4 Stunden. Halte einen Entwickler bereit, wenn das Debugging länger als eine Stunde dauert.
Was, wenn ich das Problem nicht finde?
Dokumentiere, was du schon geprüft hast. Bitte den Anbieter deines Analysetools oder einen Berater um Hilfe. Manchmal entdeckt ein frischer Blick das Problem.
Soll ich Änderungen zurücknehmen, wenn das Tracking nach dem Ausspielen kaputtgeht?
Wenn du gerade ausgespielt hast und das Tracking ausfällt, ja. Nimm sie sofort zurück. Debugge dann im Staging, bevor du erneut ausspielst.
Können Werbeblocker mein Tracking dauerhaft kaputtmachen?
Werbeblocker beeinträchtigen das Tracking bei Nutzern ohne Blocker nicht. Sie blockieren es nur bei Nutzern mit Blocker. Dein Tracking funktioniert für die Mehrheit der Nutzer ohne Blocker einwandfrei.