Inbetriebnahme

Von null zum laufenden Analytics-Server — in etwa 15 Minuten.

1. Voraussetzungen

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:

# 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

9. Fehlersuche

ProblemLösung
Keine Daten im DashboardKonsole des Browsers prüfen; Host/Port im Snippet müssen exakt passen. CORS ist serverseitig aktiviert.
Server startet nichtPort belegt? Anderen Port wählen oder den blockierenden Prozess beenden.
HTTPS klappt nichtserver.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 BotsBot-Traffic wird nur geflaggt, nicht gelöscht. Im Graphen per Schalter ausblenden.

10. Backup & Update