# Faymax Conversion Radar fuer JTL Shop 5

Version: 1.1.2

Faymax Conversion Radar ist ein internes Analyse und Conversion Plugin fuer JTL Shop 5. Die Version 1.1.2 fuehrt die Bedienung auf einer zentralen Adminseite zusammen: Dashboard, Datenschutzmodus, Tracking Einstellungen, Klick Selektoren, Datenhaltung und Bereinigung liegen jetzt an einer Stelle.

## Zentrale Adminseite

Im Plugin Menue gibt es den Tab `Conversion Radar`.

Dort befinden sich:

- Uebersicht und Kennzahlen
- Einstellungen und Konfiguration
- Datenschutzmodus vor Zustimmung
- Klick Selektoren
- Shop Funnel
- Seiten Detailauswertung
- Daten und Bereinigung
- Speicherort und Diagnosewerte

Die fruehere Trennung zwischen Dashboard und separater Konfigurationsseite wurde entfernt. Die Werte werden updatefest unter `mediafiles/faymax_conversion_radar/config.json` gespeichert und vom Frontend Tracking sowie von serverseitigen Events gelesen.

## Grundprinzip

Das Plugin arbeitet in zwei getrennten Stufen.

### Vor Zustimmung

Vor Zustimmung wird je nach Einstellung entweder nichts gespeichert oder nur eine anonyme aggregierte Reichweitenstatistik.

Im Modus `Anonyme Reichweitenstatistik aggregiert` werden nur technische Basiswerte fuer die reine Seitenstatistik erfasst:

- Seitenaufruf
- URL bzw. Pfad
- Datum fuer die Tagesaggregation
- Geraetetyp: Desktop, Mobil oder Tablet
- Browserfamilie
- Referrer Domain ohne URL Parameter

Nicht gespeichert werden:

- keine IP Adresse im Klartext
- keine Cookie ID
- keine Session ID
- keine Besucher ID
- kein Fingerprint
- keine Klickpfade
- keine Verweildauer
- keine Produktdetails
- keine Warenkorb Daten
- keine Checkout Daten
- keine Bestelldaten
- keine Wiedererkennung von Besuchern

Die anonymen Daten werden nicht als detaillierter Besucherpfad gespeichert, sondern direkt als Reichweitenwerte zusammengefasst.

### Nach Zustimmung

Nach Zustimmung im Consent Manager startet das vollstaendige Conversion Tracking.

Dann werden je nach Einstellung und Shop Situation erfasst:

- Seitenaufrufe mit Besucher ID
- Verweildauer
- Besucher und Besuche
- wiederkehrende Besucher
- Herkunft und Referrer
- Geraete
- Klicks ueber CSS Selektoren
- Kontaktaktionen
- Produktaufrufe
- Warenkorb Aktionen
- Warenkorb Ansicht
- Checkout Start
- Bestellabschluss
- serverseitig bestaetigte JTL Shop Events

## Einstellungen auf der zentralen Seite

Folgende Werte koennen direkt im Tab `Conversion Radar` gepflegt werden:

- Tracking aktivieren
- Debug Kommentar
- Vollstaendiges Tracking erst nach Zustimmung
- Datenschutzmodus vor Zustimmung
- Rohdaten Aufbewahrung in Tagen
- Tracking Endpoint Pfad
- Besucherzaehlung: Session oder Cookie Besucher ID
- Laufzeit der Besucher Cookie ID
- Bot Filter
- Admin Pfade ignorieren
- Klick Selektoren

## Datenschutz Modi

### Nichts speichern

Vor Zustimmung werden keine Trackingdaten gespeichert.

### Anonyme Reichweitenstatistik aggregiert

Vor Zustimmung werden nur aggregierte Seitenaufrufe ohne Cookie, ohne Session ID und ohne Besucher ID gespeichert.

Empfohlener Modus fuer interne Reichweitenauswertung:

`Anonyme Reichweitenstatistik aggregiert`

Die rechtliche Bewertung muss dennoch durch den Shopbetreiber erfolgen, da Datenschutzerklaerung, Consent Text und konkrete Konfiguration zum jeweiligen Shop passen muessen.

## Serverseitige JTL Shop Events

Diese Version nutzt zusaetzlich echte JTL Shop Hooks fuer wichtige Shop Ereignisse:

- Produktaufruf ueber `HOOK_ARTIKEL_PAGE`
- echtes Hinzufuegen zum Warenkorb ueber `HOOK_WARENKORB_CLASS_FUEGEEIN`
- finaler Warenkorb im Checkout ueber `HOOK_BESTELLABSCHLUSS_INC_WARENKORBINDB`
- gespeicherter Bestellabschluss ueber `HOOK_BESTELLABSCHLUSS_INC_BESTELLUNGINDB_ENDE`

Die serverseitigen detaillierten Events werden im Consent Modus erst gespeichert, wenn eine Faymax Besucher Cookie ID vorhanden ist. Dadurch wird die Zustimmung nicht umgangen.

Die anonyme Reichweitenstatistik vor Zustimmung betrifft nur aggregierte Seitenaufrufe.

## Installation

1. ZIP im JTL Shop Backend hochladen.
2. Plugin installieren und aktivieren.
3. Shop Cache und Template Cache leeren.
4. Im Plugin Tab `Conversion Radar` die Einstellungen pruefen.
5. Datenschutzmodus vor Zustimmung festlegen.
6. Frontend Seiten ohne Zustimmung aufrufen und anonyme Aufrufe im Dashboard pruefen.
7. Danach Zustimmung erteilen und detaillierte Events im Dashboard pruefen.

Falls der Consent Manager Eintrag oder der Frontend Link nach einem Update nicht sofort sichtbar ist, Plugin einmal deaktivieren und wieder aktivieren.

## Update von Version 1.1.1

Nach dem Update auf 1.1.2 sollte geprueft werden:

- Plugin Version im Plugin Manager
- Tab `Conversion Radar`
- Einstellungen und Konfiguration auf derselben Seite
- Datenschutzmodus vor Zustimmung
- Klick Selektoren
- Dashboard Werte fuer anonyme Aufrufe
- Dashboard Werte fuer Aufrufe mit Zustimmung
- Consent Quote

Die alten JTL Standard Settings bleiben als Fallback lesbar. Neue Aenderungen werden aber ueber die zentrale Adminseite gespeichert.

## Tracking Endpoint

Der Tracking Endpoint laeuft ueber einen JTL Frontend Link:

`/faymax-conversion-radar-track`

Direkte PHP Aufrufe im Pluginordner werden bewusst nicht verwendet, da manche Server diese aus Sicherheitsgruenden blockieren.

## Consent Manager

Das Plugin registriert einen eigenen Eintrag im JTL Consent Manager:

- ID: `faymax_conversion_radar`
- Name: Faymax Conversion Radar
- Zweck: Besucheranalyse, Klicktracking und Shop Optimierung

Standardmaessig startet das detaillierte Frontend Tracking erst nach Zustimmung im Consent Manager.

Vor Zustimmung kann optional nur die anonyme aggregierte Reichweitenstatistik laufen. Diese setzt keine Cookies und erzeugt keine Besucherkennung.

## Standard Klick Selektoren

```text
a[href^='tel:']
a[href^='mailto:']
a[href*='wa.me']
a[href*='whatsapp']
a[href*='kontakt']
a[href$='.pdf']
a[href$='.zip']
button[type='submit']
input[type='submit']
button[name='inWarenkorb']
input[name='inWarenkorb']
#add-to-cart
.btn-primary
```

## Dashboard

Das Dashboard zeigt unter anderem:

- gesamte Seitenaufrufe
- anonyme Aufrufe vor Zustimmung
- Aufrufe mit Zustimmung
- Consent Quote
- Klicks
- Kontaktaktionen
- Besuche
- einmalige Besucher
- wiederkehrende Besucher
- Seiten pro Besuch
- durchschnittliche Verweildauer
- durchschnittliche Verweildauer pro Seite
- Produktaufrufe
- Warenkorb Klicks
- Warenkorb Ansichten
- Checkout Starts
- Bestellabschluesse
- Shop Funnel
- Seiten Detailauswertung
- Top Quellen
- Geraete
- Browser anonym

## Datenhaltung

Rohdaten und Aggregate werden updatefest gespeichert unter:

`mediafiles/faymax_conversion_radar`

Wichtige Unterbereiche:

- `raw`: detaillierte Events nach Zustimmung
- `aggregate`: anonyme aggregierte Seitenaufrufe vor Zustimmung
- `config.json`: zentrale Plugin Konfiguration

Im Tab `Conversion Radar` koennen Testevents, alte Rohdaten oder alle Rohdaten und Aggregate geloescht werden.

## Hinweis

Diese Version ist technisch fuer interne Auswertung und Shop Optimierung gedacht. Vor produktiver Nutzung sollten Consent Manager Text, Datenschutzerklaerung und Tracking Umfang rechtlich geprueft werden.
