Inbetriebnahme
Von null zum laufenden Analytics-Server — in etwa 15 Minuten.
1. Voraussetzungen
- Windows 10/11, eine gängige Linux-Distribution oder macOS.
- Ein freier TCP-Port (Standard:
8080) für den Analytics-Server. - Optional, für den Produktivbetrieb empfohlen: eine (Sub-)Domain und ein TLS-Zertifikat.
- Für Website-Einbindung: Zugriff auf den Quellcode Ihrer Website (oder Tag-Manager).
2. Programm starten
Entpacken Sie das Archiv und starten Sie die Anwendung:
# Windows
CookielessTracker.exe
# Linux
./CookielessTracker.x86_64
# Optional headless, z. B. auf einem Server ohne Bildschirm:
./CookielessTracker.x86_64 --headless --port 8080
Der Server beginnt sofort auf Port 8080 zu lauschen und öffnet das Dashboard.
Ein Test mit curl bestätigt den Betrieb:
curl http://localhost:8080/health
# {"status":"ok","uptime_seconds":12,"storage":"sqlite","tls":false,"open_connections":0}
3. TLS / HTTPS aktivieren (empfohlen)
Legen Sie Zertifikat und Schlüssel im Datenverzeichnis der Anwendung ab. Dieses
user://-Verzeichnis ist:
- Windows:
%APPDATA%\Godot\app_userdata\AI-Driven Cookieless Tracker\ - Linux:
~/.local/share/godot/app_userdata/AI-Driven Cookieless Tracker/
# Dateien exakt so benennen:
user://server.key # privater Schlüssel (PEM)
user://server.crt # Zertifikat (PEM, ggf. mit Kette)
Sind beide Dateien vorhanden und lesbar, spricht der Server automatisch HTTPS. Fehlt oder bricht eine Datei, fällt er ohne Absturz auf HTTP zurück und schreibt einen Hinweis ins Log.
4. Reverse-Proxy (optional)
Läuft bereits ein Webserver, kann dieser TLS übernehmen und an den Tracker weiterleiten. Beispiel für nginx:
server {
listen 443 ssl http2;
server_name analytics.ai-drivencookielesstracker.com;
ssl_certificate /etc/letsencrypt/live/analytics.ai-drivencookielesstracker.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/analytics.ai-drivencookielesstracker.com/privkey.pem;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
Der Tracker vertraut X-Real-IP / X-Forwarded-For nur dann, wenn die
Verbindung von einer lokalen/privaten Adresse kommt — Spoofing aus dem Internet ist damit
ausgeschlossen.
5. Tracking-Snippet einbinden
Fügen Sie direkt vor </body> Ihrer Website eine Zeile ein:
<script src="https://analytics.ai-drivencookielesstracker.com/tracker.js" defer></script>
Die Datei tracker.js liefert der Tracker selbst aus. Das Skript erkennt seine
eigene Adresse und schickt die Daten an denselben Host zurück — Host, Port und Zertifikat
müssen Sie also nicht konfigurieren. Es setzt kein Cookie und speichert nichts auf dem
Endgerät der Besucher.
Bei Bedarf können Sie vorher einstellen:
<script>
window.ZIVA_ANALYTICS = {
path: "/track", // Endpunkt (Standard)
heartbeat: 15000, // Verweildauer-Heartbeat in ms (Minimum 5000)
include_query: false, // true: auch ?parameter an die Statistik senden
page_url: "" // feste Seitenkennung statt des Pfads
};
</script>
Standardmäßig wird nur der Pfad übermittelt, nicht die Query-Zeichenkette und
kein Anker — Kampagnenparameter wie ?utm_… landen also nicht in den Zahlen.
Wer im Browser Do Not Track gesetzt hat, wird nicht gezählt; ein versteckter Tab
sendet keinen Heartbeat. Somit wird auch keine Verweildauer für ungelesene Seiten erfasst.
6. Lizenz aktivieren
Ohne Lizenz läuft die Anwendung im Testmodus mit reduziertem Monatsvolumen. Nach dem Kauf erhalten Sie einen signierten Lizenzschlüssel (Textdatei). Klicken Sie im Dashboard oben auf „Activate licence“ und fügen Sie den Schlüssel ein — oder wählen Sie mit „Load file…“ direkt die heruntergeladene Datei aus. Die Signatur wird geprüft, bevor etwas gespeichert wird: ein abgeschnittener, verfälschter oder fremder Schlüssel wird mit Begründung abgelehnt, eine bereits installierte Lizenz bleibt dabei unangetastet. Mit „Remove licence“ kehren Sie jederzeit in den Testmodus zurück.
Alternativ können Sie die Textdatei auch manuell ablegen als:
user://license.key
Den vollständigen Pfad zeigt das Aktivierungsfenster unten an (unter Windows üblicherweise
%APPDATA%\Godot\app_userdata\…).
Im Dashboard zeigt ein Badge den aktiven Tarif (z. B. STARTER); darunter zeigt eine Auslastungsanzeige den Verbrauch des laufenden Monats — grün, ab 70 % orange, ab 90 % rot — zusammen mit einer Sparkline der letzten sechs Monate. Nähert sich Ihr Volumen dem Limit, sehen Sie das also rechtzeitig. Erst bei Überschreitung pausiert das Erfassen neuer Seitenaufrufe (die Statuszeile weist darauf hin); die Heartbeat-Signale für die Verweildauer laufen weiter. Ein Neustart ist nicht erforderlich, wenn Sie die Datei bei laufendem Programm ersetzen — spätestens nach dem nächsten Aktualisierungsintervall wird sie gelesen.
7. Autostart als Dienst (Linux)
Das Archiv enthält eine systemd-Unit-Vorlage. Nach Anpassung der Pfade:
sudo cp analytics-server.service /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now analytics-server
systemctl status analytics-server
8. Datenschutz & AVV
- IP-Adressen werden vor der Verarbeitung gekürzt und nicht gespeichert; gespeichert wird nur ein täglicher, nicht rückrechenbarer Hash.
- Es werden keine Cookies gesetzt und keine Daten auf dem Endgerät gespeichert.
- Nehmen Sie eine kurze Beschreibung in Ihre Datenschutzerklärung auf (Rechtsgrundlage: berechtigtes Interesse, Art. 6 Abs. 1 lit. f DSGVO).
- Für den Business-/Ultimate-Tarif stellen wir auf Wunsch einen Auftragsverarbeitungsvertrag (Art. 28 DSGVO) bereit.
9. Fehlersuche
| Problem | Lösung |
|---|---|
| Keine Daten im Dashboard | Konsole des Browsers prüfen; Host/Port im Snippet müssen exakt passen. CORS ist serverseitig aktiviert. |
| Server startet nicht | Port belegt? Anderen Port wählen oder den blockierenden Prozess beenden. |
| HTTPS klappt nicht | server.key/server.crt prüfen — bei Fehlern startet der Server bewusst als HTTP. |
| „Quota exceeded“ | Monatsvolumen des Tarifs erreicht; Upgrade in einen höheren Tarif durchführen. |
| Zu viele Bots | Bot-Traffic wird nur geflaggt, nicht gelöscht. Im Graphen per Schalter ausblenden. |
10. Backup & Update
- Alle Daten liegen in einer
SQLite-Datei imuser://-Verzeichnis. Ein Backup ist eine Kopie dieser Datei. - Für ein Update tauschen Sie die Programmdatei aus; Ihre Daten und die Lizenz bleiben erhalten.