PS PrestaShop PrestaShop Mittel

Traffic Radar — Vollständige Anleitung

Das Echtzeit-Dashboard Traffic Radar installieren, konfigurieren und betreiben: Online-Zähler Menschen/Bots, KI-Crawler-Erkennung, Diagramme, Heatmap, robots.txt-Steuerung und CSV-Export für PrestaShop 8 und 9.

Aktualisiert Modulversion 1.1.1

Traffic Radar zeigt in Echtzeit, wer Ihren PrestaShop-Shop besucht, und trennt echte Besucher von Bots und KI-Crawlern. Das Modul installiert ein eigenes Dashboard unter Statistiken → Traffic Radar: einen sofortigen Online-Zähler (Menschen gegen Bots), Verlaufsdiagramme, eine Aktivitäts-Heatmap, die Top-KI-Crawler, einen Live-Aktivitätsfeed, KI-Crawler-Steuerung über robots.txt und CSV-Export. Diese Anleitung behandelt Installation, Einstellungen, Funktionsweise der Erkennung, jede Dashboard-Ansicht, Datenschutz und Fehlerbehebung.

Installation

  1. Laden Sie das Archiv dftrafficradar.zip aus Ihrem DataFirefly-Konto herunter.
  2. PrestaShop-Backoffice → Module → Modul hochladen → ZIP senden.
  3. Bei der Installation erstellt das Modul seine zwei Tabellen (df_traffic_visit und df_traffic_online), registriert seine Hooks und fügt den Tab Statistiken → Traffic Radar hinzu.

Kompatibel mit PrestaShop 8.0 bis 9.x, mit PHP 7.4 bis 8.3. Kein Theme-Override, keine Composer-Abhängigkeit, kein CDN (Chart.js ist lokal eingebunden). Multishop und mehrsprachig (FR, EN, ES, DE, IT).

Konfiguration

Gehen Sie zu Module → DataFirefly Traffic Radar → Konfigurieren.

  • Tracking aktivieren: Hauptschalter. Wenn aus, wird kein Besuch erfasst.
  • Bots / KI-Crawler erfassen: deaktivieren, um nur menschliche Besuche zu erfassen.
  • IP-Adressen anonymisieren (DSGVO): IPs werden immer gehasht; diese Option maskiert zusätzlich das letzte Oktett vor dem Hashing.
  • Datenaufbewahrung (Tage): ältere Besuche werden automatisch gelöscht. 0 = unbegrenzt aufbewahren. Standard: 90.
  • Heartbeat-Intervall (Sekunden): wie oft ein Online-Besucher ein Signal sendet, um gezählt zu bleiben. Standard: 15.
  • Online-Fenster (Sekunden): ein Besucher gilt als „online jetzt“, wenn er innerhalb dieses Fensters gesehen wurde. Standard: 90.
  • Ausgeschlossene IP-Adressen: eine pro Zeile (oder durch Komma getrennt). Ideal, um Ihren eigenen Traffic und den Ihres Teams zu ignorieren.

Tragen Sie Ihre Büro-IPs gleich nach der Installation in die Ausschlussliste ein, damit Ihre eigenen Tests die Statistiken nicht aufblähen.

Wie die Erkennung funktioniert

Traffic Radar kombiniert zwei sich ergänzende Signale, was die echte Trennung von Menschen und Crawlern ermöglicht.

Serverseitige Erkennung

Bei jedem Seitenaufruf klassifiziert das Modul über den Hook actionFrontControllerSetMedia den User-Agent anhand einer Basis von über 40 Signaturen (KI, Suchmaschinen, SEO, Social, Monitoring) und weist einen Typ zu. Genau das erfasst KI-Crawler, die fast nie JavaScript ausführen.

Clientseitiger Heartbeat

Ein kleines Skript (tracker.js) sendet regelmäßig ein Signal an den Front-Controller track, um echte Besucher zwischen Seitenaufrufen als „online“ gezählt zu halten. Da Bots diesen Schlag nicht auslösen, bleibt der Echtzeit-Zähler der Menschen sauber.

AJAX-Anfragen und Modul-Unteranfragen (in den Warenkorb legen, Wunschliste, Bewertungen sowie der Heartbeat selbst) werden nicht als Seitenaufrufe gezählt: nur echte, navigierbare Seiten werden erfasst.

Das Dashboard

Der Tab Statistiken → Traffic Radar bündelt alle Ansichten, filterbar nach Zeitraum (heute, 24 h, 7 / 30 / 90 Tage, benutzerdefiniert) und nach Publikum (gesamter Traffic, Menschen, alle Bots oder ein bestimmter Bot-Typ).

  • Online jetzt: Echtzeit-Zähler, aufgeteilt in Menschen und Bots, im Heartbeat-Takt aktualisiert.
  • KPIs: Besuche, eindeutige Sitzungen, menschliche Besuche, Bot-Besuche und KI / LLM-Hits. Jeder KPI zeigt seine Veränderung (▲ / ▼ in Prozent) gegenüber dem vorherigen Zeitraum gleicher Länge.
  • Besuche im Zeitverlauf: Liniendiagramm Menschen gegen Bots, mit automatischer Granularität (stündlich oder täglich je nach Zeitraum).
  • Publikumsaufteilung: Donut nach Typ (Mensch, KI, Suche, SEO, Social, Monitoring, Sonstige).
  • Top-KI-Crawler: horizontale Balken der aktivsten KI-Crawler (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, Bytespider…).
  • Aktivitäts-Heatmap: Raster Stunde × Wochentag.
  • Top-Seiten, Referrer und Länder: Ranglisten als Balken.
  • Live-Aktivitätsfeed: letzte Besuche mit Typ, Identität, Seite, Gerät und Land.

Der Echtzeit-Zähler

Der Block „Online jetzt“ stützt sich auf die Tabelle df_traffic_online, die bei jedem Seitenaufruf und jedem Heartbeat aktualisiert wird. Ein Besucher verschwindet aus dem Zähler, sobald er nicht mehr innerhalb der durch das Online-Fenster definierten Dauer gesehen wurde.

Bleibt der Zähler bei null, obwohl Besucher anwesend sind, stellen Sie sicher, dass Sie Version 1.1.1 oder höher verwenden: Eine Zeitzonen-Abweichung zwischen PHP und MySQL konnte das Echtzeit-Fenster in früheren Versionen verfälschen. Der Fix richtet das Lesen an der Schreib-Uhr aus.

Radar neu erkannter Crawler

Das Panel „Neu erkannte Crawler“ hebt Bots hervor, deren allererster erfasster Besuch in den analysierten Zeitraum fällt. Es ist das ideale Werkzeug, um die Ankunft eines neuen KI-Crawlers in Ihrem Katalog sofort zu erkennen: Bot-Name, Typ, Datum der ersten Sichtung und Anzahl der Hits.

KI-Crawler-Steuerung (robots.txt)

Das Kontrollzentrum listet 25 bekannte KI-Crawler mit ihrem offiziellen robots.txt-Token. Für jeden wählen Sie per Kontrollkästchen „erlaubt“ oder „blockiert“; Trainings-Crawler sind standardmäßig als blockiert vorausgewählt, während Agenten, die auf eine Nutzeranfrage antworten, durchgelassen werden.

  • Crawler, die tatsächlich gesehen wurden, werden mit einem Abzeichen markiert.
  • Zwei Ein-Klick-Voreinstellungen: „Alles blockieren“ und „Auf Empfehlung zurücksetzen“.
  • Das Modul erzeugt live einen einfügefertigen robots.txt-Block mit einem Kopieren-Button.

In dieser Version ist die Anwendung bewusst manuell: Sie kopieren den erzeugten Block in Ihre robots.txt-Datei. Das Modul schreibt die Datei nie automatisch, wodurch Ihre bestehenden Direktiven nie überraschend überschrieben werden.

Widget im Backoffice-Startdashboard

Das Modul fügt eine „Traffic Radar“-Karte in der rechten Spalte des Backoffice-Startdashboards hinzu (Hook dashboardZoneTwo): einen Live-Online-Zähler (Menschen / Bots) und die Tageszähler (Besuche, Menschen, Bots, KI / LLM), mit einer Verknüpfung zum vollständigen Dashboard.

CSV-Export

Der CSV-Button in der Symbolleiste exportiert den gesamten Traffic, der den aktiven Filtern (Zeitraum und Publikum) entspricht. Die Datei ist UTF-8 mit BOM kodiert, damit sie sauber in Excel öffnet, und enthält eine Zeile pro Besuch: Datum, Typ, Bot-Name, Gerät, Seite, Referrer, Land usw.

Datenschutz und DSGVO

  • Es wird keine rohe IP-Adresse gespeichert: nur gesalzene SHA-1-Hashes.
  • Die optionale Anonymisierung maskiert das letzte Oktett (IPv4) oder die letzten Gruppen (IPv6) vor dem Hashing.
  • Die Aufbewahrung ist konfigurierbar, mit probabilistischer automatischer Bereinigung: kein Cron erforderlich.
  • Die Ausschlussliste für IPs erlaubt es, Ihren eigenen Traffic zu ignorieren.

Die Bereinigung alter Daten läuft probabilistisch mit dem Traffic. Wenn Sie eine deterministische Bereinigung bevorzugen, können Sie die Purge über einen Cron aufrufen, das ist jedoch nicht erforderlich.

Kompatibilität und technische Hinweise

  • PrestaShop 8.0 bis 9.x, Multishop und mehrsprachig.
  • PSR-4-Architektur unter dem Namespace DataFirefly/TrafficRadar (Backslash-Trenner) mit eingebundenem Autoloader, ohne Composer.
  • Legacy-Admin-Controller (ModuleAdminController) für die PS8 / PS9-Kompatibilität.
  • Backoffice-AJAX-Endpunkte über das 4. Argument von getAdminLink(); JSON-Antworten von einer dedizierten Methode ausgegeben.
  • Verwendete Hooks: actionFrontControllerSetMedia, displayHeader, dashboardZoneTwo.
  • Zwei indizierte utf8mb4-Tabellen: df_traffic_visit (Besuchsprotokoll) und df_traffic_online (Präsenz, eindeutiger Schlüssel pro Sitzung).
  • Chart.js lokal eingebunden, kein CDN-Aufruf.

FAQ und Fehlerbehebung

„Online jetzt“ bleibt bei null. Stellen Sie sicher, dass Sie Version 1.1.1 oder höher verwenden (PHP/MySQL-Zeitzonen-Fix). Prüfen Sie auch, dass das Tracking aktiviert ist und Ihre eigene IP nicht in der Ausschlussliste steht.

„module-…“-Einträge erschienen im Feed. In 1.1.1 behoben: AJAX- und Modul-Unteranfragen werden nicht mehr als Seitenaufrufe gezählt.

Werden KI-Crawler wirklich erkannt? Ja. Die serverseitige Erkennung erfasst sie auch ohne JavaScript. Die Signaturen decken OpenAI, Anthropic, Google-Extended, Perplexity, ByteDance, Meta, Mistral, Cohere, Amazon, Common Crawl und weitere ab.

Verlangsamt das Modul den Shop? Nein. Die User-Agent-Klassifizierung ist ein einfacher Zeichenkettenvergleich im Speicher, und das Tracking beschränkt sich auf ein indiziertes Insert und ein Upsert pro Seitenaufruf.

Verfälscht ein Vollseiten-Cache die Zahlen? Aus einem Vollseiten-Cache ausgelieferte Seiten durchlaufen PHP nicht und werden daher serverseitig nicht erneut gezählt. Der JavaScript-Heartbeat hält menschliche Besucher dennoch als online gezählt.

Kompatibel mit PrestaShop 1.7? Nein, nur PrestaShop 8.0 bis 9.x.

War diese Seite hilfreich?

Immer noch nicht weiter? Support kontaktieren