Troubleshooting

Kommt nichts an oder stimmt eine Zahl nicht? Gehe diese Liste von oben nach unten durch, meistens liegt es an einem der ersten Punkte.

Check what your browser sends

1. Öffne deine Website, öffne die Entwicklertools (F12), wechsle zum Tab Network und lade die Seite neu.
2. Filtere nach a.js. Der Eintrag soll Status 200 haben. Fehlt er, wird das Script gar nicht geladen (siehe Script does not load).
3. Filtere nach events. Es soll ein POST an https://app.lienks.com/api/events auftauchen. Fehlt er, startet das Script nicht (siehe No request is sent).
4. Lies den Status der Antwort:

Zum Vergleich, so sieht das Snippet aus:

<script defer src="https://app.lienks.com/a.js" data-site="YOUR_SITE_ID"></script>

No request is sent

Das Script läuft, schickt aber nichts. Mögliche Ursachen:

• Das Attribut data-site fehlt oder ist leer. Dann tut das Script nichts und zeigt keinen Fehler.
• Das Script ist als Modul eingebunden (type="module"). Das Snippet muss ein normales Script-Tag sein, genau wie in Quick start.
• Ein Adblocker, Tracking-Schutz oder eine Browser-Erweiterung blockiert das Script oder den Request. Öffne deine Seite zum Testen in einem privaten Fenster ohne Erweiterungen. Das ist ein Hinweis, keine Garantie.
• Ein Cookie- oder Consent-Tool auf deiner Seite blockiert Scripte, bis jemand zustimmt. Lienks selbst wartet nicht auf Zustimmung, außer im Modus Cookie.

Script does not load

• Das Snippet steht nicht im HTML, das deine Seite ausliefert. Prüfe es mit „Seitenquelltext anzeigen“ (nicht im Inspektor, der zeigt das Ergebnis nach den Scripten). Achte auf Caches, CDNs und Cache-Plugins, die noch die alte Version ausliefern, und leere den Cache.
• Die URL im Snippet stimmt nicht. Sie muss https://app.lienks.com/a.js lauten.
• Content Security Policy: Nutzt deine Seite eine, muss sie Scripte von und Verbindungen zu app.lienks.com erlauben (script-src und connect-src).
• Fehlermeldungen zu blockierten Scripts stehen im Tab Console der Entwicklertools.

Status 204: the event is dropped

Der Request kommt an und wird bewusst ignoriert. Prüfe die Gründe in dieser Reihenfolge:

1. Die Domain stimmt nicht. Events werden nur akzeptiert, wenn sie von der in der Site hinterlegten Domain kommen. www. wird ignoriert, aber Subdomains zählen als eigene Domain (blog.example.com ist nicht example.com). Auch Staging-Domains, Vorschau-URLs und localhost passen nicht: Lege Staging als eigene Site an, wenn du dort testen willst. Dateien, die du direkt aus einem Ordner öffnest (file://), senden keine passende Herkunft und werden ebenfalls verworfen.
2. Der Workspace hat keinen Zugang. Die Testphase ist abgelaufen, es ist noch kein Plan gewählt, das Abo ist beendet, oder eine Zahlung ist fehlgeschlagen und die Frist ist abgelaufen. Prüfe den Billing-Bereich (Billing and plans).
3. Das Limit des Plans ist aufgebraucht. Das Tracking stoppt, wenn das Kontingent samt Puffer von 10 % erreicht ist, bis zum nächsten Abrechnungszeitraum (Billing and plans).

Der Server sagt nicht, welcher Grund zutrifft: Der Request läuft im Browser jedes Besuchers, deshalb gibt es bewusst keine Fehlermeldung und keine Details zu Billing.

Events arrive but numbers look off

• Unique Visitors, Sessions und Bounce Rate fehlen oder sind 0: Die Site läuft im Modus Minimal, dort gibt es keine Besucherkennung (Tracking modes).
• Browser, OS, Device oder Countries sind leer: Die jeweiligen Schalter in den Site-Einstellungen sind aus (Standard bei neuen Sites) und wirken nur für neue Events (Data collection).
• Meine eigenen Besuche oder Tests fehlen: Bekannte Bots werden aus den Statistiken herausgehalten. Automatisierte Browser, zum Beispiel Test- oder Headless-Tools, können als Bot erkannt werden. Die Events-Ansicht zeigt den Bot-Status (Events).
• Zahlen weichen um Mitternacht ab: Im Modus Cookieless wechselt die Kennung um Mitternacht UTC. Außerdem bestimmt die Zeitzone der Site, wie Tage gruppiert werden (Metrics and filters).
• Es sind weniger Besucher als erwartet: Adblocker und Tracking-Schutz können Aufrufe verhindern, und kein Analytics-Tool zählt Besucher exakt.
• Der Zeitraum passt nicht: Prüfe, ob Today, Last 7 Days usw. wirklich der gewünschte Bereich ist, und die Zeitzone der Site.
• Es dauert: Das Dashboard aktualisiert sich automatisch alle paar Sekunden. Warte kurz und lade bei Bedarf neu.

Single-page apps and page navigation

• Lienks zählt Seitenwechsel über die History-API (pushState und Zurück/Vor). Dafür ist keine Framework-Integration nötig.
• replaceState wird bewusst nicht gezählt.
• Dieselbe Seite direkt hintereinander wird nicht doppelt gezählt: Ein erneuter Wechsel auf denselben Pfad löst keinen neuen Pageview aus.
• Gezählt wird der Pfad ohne Query-String und ohne Hash. Apps, die nur mit Hash-Routing arbeiten (/#/seite), erscheinen daher als eine einzige Seite.

Custom events do not show up

• Prüfe den Namen: nur Kleinbuchstaben, Ziffern und Unterstriche, beginnt mit einem Buchstaben, maximal 100 Zeichen. pageview ist reserviert. Ungültige Namen werden verworfen, ohne Fehlermeldung und ohne Request (Custom events).
• window.lienks existiert erst, wenn das Script geladen und ausgeführt wurde. Wegen defer ist das nach dem Parsen der Seite der Fall. Rufe window.lienks?.event(...) daher in Event-Handlern oder nach DOMContentLoaded auf, nicht direkt im <head>.
• Ein Adblocker kann das Script blockieren. Dann gibt es window.lienks nicht, und das ?. verhindert Fehler auf deiner Seite.
• Auch für Custom events gelten die Gründe unter „Status 204“.
• Prüfe in der Ansicht Latest Events, ob das Event dort auftaucht, nicht nur im Dashboard (Events).

Cookie mode and consent

• Es wird kein Cookie angelegt: Prüfe, ob die Site wirklich im Modus Cookie läuft (nicht Minimal oder Cookieless) und ob window.lienks.setConsent(true) auf dieser Seite aufgerufen wurde.
• Die Zustimmung wird nicht gespeichert und nach jedem Neuladen zurückgesetzt. Dein Consent-Tool muss setConsent(true) bei jedem Seitenaufruf erneut aufrufen (Consent).
• Das allererste Event direkt nach der Zustimmung kann noch ohne Cookie rausgehen. Das Cookie entsteht beim nächsten Event.
• Das Cookie heißt _lienks_vid und gilt 24 Stunden.

Still stuck?

Schreib uns über das Feedback-Formular in der App (Feedback in der Seitenleiste). Diese Angaben helfen:

• die Domain der Site
• der Status der Antwort im Network-Tab
• der Zeitpunkt deines Tests
• dein Browser