# VisualClicks Analytics für Shopware 6.6 und 6.7

Cookielose Web-Analyse, Heatmaps, Session-Replays und vollständiges E-Commerce-Tracking für Shopware – eingerichtet mit nur einem API-Token.

## Was das Plugin erfasst

| Bereich | Wie | Daten |
|---|---|---|
| Seitenaufrufe, Klicks, Scrolltiefe, Heatmaps, Replays | Tracking-Tag im Browser (wird automatisch eingebunden) | wie auf jeder Website mit VisualClicks |
| Produkt angesehen | Browser, auf jeder Produktseite | Artikelnummer, Name, Hersteller, Kategoriepfad, Variante, Preis |
| Warenkorb | Server (Shopware) | hinzufügen, Menge ändern (1 → 3 = +2), entfernen, leeren |
| Kauf | Server, beim Abschluss der Bestellung | Bestellnummer, Wert brutto/netto, Steuer, Versand, Gutscheine, Zahlungs- und Versandart, Artikel |
| Erstattung / Stornierung | Server, bei Zahlungsstatus „Erstattet“ oder Bestellstatus „Storniert“ | voller Bestellwert, einmal je Bestellung |

Warenkorb und Bestellungen werden direkt von Shopware gemeldet – sie gehen also auch bei Werbeblockern nicht verloren und landen in derselben Sitzung wie der Browserbesuch:
- **ohne Einwilligung (cookielos):** über IP-Adresse und Browserkennung des Kunden (die IP wird von VisualClicks nicht gespeichert),
- **mit Einwilligung:** zusätzlich über die Sitzungs-ID (Cookie `vc_vid`).

Eine Bestellung, die sowohl im Browser als auch vom Server gemeldet wird, zählt nur einmal (Abgleich über die Bestellnummer).

## Installation

1. In Shopware: **Erweiterungen → Meine Erweiterungen → Erweiterung hochladen** und die ZIP-Datei auswählen, dann installieren und aktivieren.
2. In VisualClicks: **Einstellungen → Website → API-Keys** einen Schlüssel mit dem Recht **„Events senden“** anlegen (funktioniert in jedem Tarif).
3. In Shopware: **Erweiterungen → VisualClicks Analytics → Konfigurieren** den Schlüssel als **API-Token** eintragen und speichern. Für mehrere Verkaufskanäle mit eigenen VisualClicks-Websites den Token je Verkaufskanal setzen.
4. Cache leeren (Einstellungen → System → Caches & Indizes). Fertig – die Website-ID holt sich das Plugin selbst.

Prüfen per Konsole:

```bash
bin/console visualclicks:check
```

## Einwilligung (Cookie-Manager)

Das Plugin trägt sich im Shopware-Cookie-Manager in der Gruppe **„Statistiken“** als „VisualClicks“ ein. Ohne Zustimmung misst VisualClicks cookielos. Mit Zustimmung erkennt es wiederkehrende Besucher und darf Sitzungen aufzeichnen (Eingabefelder sind immer maskiert).

## Gut zu wissen

- **Versand nach der Antwort:** Die Events werden nach dem Ausliefern der Seite gesendet (PHP-FPM) – der Kunde wartet nicht darauf. Fällt VisualClicks aus, läuft der Shop normal weiter; Fehler stehen im Shopware-Log.
- **Teilerstattungen** haben in Shopware keinen Betrag und werden nicht gemeldet; volle Erstattungen und Stornierungen schon.
- **IPv6:** Erreicht ein Kunde den Shop per IPv6, VisualClicks aber per IPv4 (oder umgekehrt), können Warenkorb/Kauf ohne Einwilligung in einer eigenen Sitzung landen. Umsatz und Artikel werden trotzdem vollständig gezählt, nur die Herkunft (Kanal) fehlt dann.
- **Selbst gehostetes VisualClicks:** unter „Erweitert“ die Adresse ändern.
- **Server-Events abschalten:** unter „Erweitert“; dann erfasst nur der Browser.

## Voraussetzungen

Shopware 6.6 oder 6.7, ausgehende HTTPS-Verbindungen zu visualclicks.de.

---

# VisualClicks Analytics for Shopware 6.6 and 6.7 (English)

Cookieless web analytics, heatmaps, session replays and complete e-commerce tracking – set up with just an API token.

1. Upload the ZIP under **Extensions → My extensions → Upload extension**, install and activate it.
2. In VisualClicks create an API key with the right **"Send events"** (Settings → Website → API keys; any plan).
3. Enter it as **API token** in the plugin configuration (per sales channel if needed) and clear the cache.

Product views are tracked in the browser; cart changes (incl. quantity changes), orders and refunds/cancellations are sent by Shopware itself and linked to the shopper's browser session (cookieless via IP + user agent, with consent via the visit id). Check with `bin/console visualclicks:check`.