Live-Viewer & Verkaufszähler

Installation

1. Plugin im Shopware-Backend installieren und aktivieren: Erweiterungen → Meine Erweiterungen
2. Storefront-Cache leeren: Einstellungen → System → Caches & Indexe → Cache leeren
3. Theme neu kompilieren (falls Custom-Theme aktiv): Einstellungen → Theme oder per Konsole bin/console theme:compile

Konfiguration öffnen

Erweiterungen → Meine Erweiterungen → Stone & Water - Live-Viewer & Verkaufszähler → Konfiguration

Vier Karten stehen zur Verfügung: Anzeige-Positionen, Datenquelle Angesehen, Datenquelle Verkauft, Transparenz & Datenschutz.

1. Anzeige-Position wählen

In der Karte Anzeige-Positionen wählen Sie über das Dropdown, wo das Badge auf der Produktdetailseite erscheinen soll:

• Über der Buybox – ganz oben in der Kaufspalte, über dem Preis (Standard)
• Unter der Buybox – ganz unten in der Kaufspalte, unter Produktnummer und Beschreibung
• Direkt über dem Warenkorb-Button – unmittelbar vor der Quantity-/Add-to-Cart-Zeile, stärkster Conversion-Effekt
• Direkt unter dem Warenkorb-Button – als subtile Validierung direkt nach dem Klick-Bereich
• Nicht anzeigen – kein sichtbares Badge, aber Live-Viewer-Tracking läuft weiter im Hintergrund

2. Datenquelle „Angesehen" konfigurieren

In der Karte Datenquelle: Angesehen:

• Aktiv – Live-Viewer-Anzeige ein-/ausschalten
• Anzeige-Modus:
  • Bucketed (empfohlen): ehrliche Spannen wie „Mehrere Interessenten schauen sich das gerade an"
  • Strikt: exakte Zahl, z.B. „3 Personen schauen sich gerade an"
  • Aggregated: „X Personen in den letzten 24 Stunden" – gut bei niedrigem Live-Traffic
• Mindestschwelle – Anzeige erst ab dieser Anzahl (Standard: 3)
• Zeitfenster (Minuten) – wie lange eine Session als „aktiv" gilt (Standard: 5)
• Heartbeat-Intervall (Sekunden) – wie oft das JavaScript aktualisiert (Standard: 30)
• Custom-Text (optional) – eigene Formulierung mit Platzhalter %count% für die Zahl

3. Datenquelle „Verkauft" konfigurieren

In der Karte Datenquelle: Verkauft:

• Aktiv – Verkaufszähler ein-/ausschalten
• Anzeige-Modus:
  • Strikt: „12 mal verkauft in den letzten 7 Tagen"
  • Bucketed: ehrliche Spannen wie bei Viewer
• Mindestschwelle – Anzeige erst ab dieser Verkaufszahl (Standard: 3)
• Zeitfenster (Tage) – rückblickender Zeitraum für die Zählung (Standard: 7)
• Custom-Text (optional) – mit Platzhaltern %count% und %days%

4. Bucket-Labels anpassen

Bei aktivem Bucketed-Modus können Sie für beide Datenquellen die Labels der drei Spannen frei wählen:

• Niedrig (3-5 Treffer)
• Mittel (6-15 Treffer)
• Hoch (16 und mehr)

Die Grenzen selbst sind fix und nicht änderbar – das garantiert, dass das Bucketing immer ehrlich bleibt. Die Texte sind aber frei wählbar pro Sales-Channel und Sprache.

5. Transparenz-Link (optional)

In der Karte Transparenz & Datenschutz:

• Erklärtext-Link anzeigen – zeigt einen kleinen Link „Wie wir das messen" unter dem Badge
• Ziel-URL (optional) – Link zu einer eigenen Erklärungs-Seite; leer = Tooltip-Variante mit Default-Text

Empfohlene Konfigurationen

Conversion-Boost (Standard-E-Commerce)

• Position: Direkt über dem Warenkorb-Button
• Viewer: Bucketed, Mindestschwelle 3, Zeitfenster 5 Minuten
• Sales: Strikt, Mindestschwelle 3, Zeitfenster 7 Tage

Nischen-Shop mit wenig Live-Traffic

• Position: Über der Buybox
• Viewer: Aggregated (24h-Modus), Mindestschwelle 5
• Sales: Bucketed, Mindestschwelle 3, Zeitfenster 30 Tage

Hochpreis-Segment mit maximaler Diskretion

• Position: Unter der Buybox
• Viewer: Bucketed, Mindestschwelle 5
• Sales: Bucketed, Mindestschwelle 5

Testen vor dem Live-Schalten

1. Senken Sie die Mindestschwellen kurzzeitig auf 1
2. Öffnen Sie das gleiche Produkt in 2-3 verschiedenen Browsern oder Inkognito-Fenstern
3. Nach 5-10 Sekunden Seite neu laden – das Badge sollte mit der Anzahl der anderen Sessions erscheinen
4. Schwellen zurücksetzen auf den gewünschten Live-Wert

Häufige Fragen

Das Badge erscheint nicht – was tun?

1. Storefront-Cache leeren (Admin → Caches & Indexe → Cache leeren)
2. Theme neu kompilieren (Admin → Theme → Theme aktualisieren)
3. Mindestschwelle prüfen – bei 3 Browsern und Schwelle 3 sieht jeder nur 2 andere (eigene Session immer ausgeschlossen)
4. Browser-Hard-Refresh: Strg+Shift+R bzw. Cmd+Shift+R

Warum sieht der erste Besucher keine Zahl?

Die eigene Session wird beim Count immer ausgeschlossen, damit Ihre Kunden „andere" sehen, nicht sich selbst. Bei wenigen Besuchern bleibt das Badge daher ausgeblendet, bis die Mindestschwelle durch andere Besucher erreicht wird.

Werden Variant-Verkäufe getrennt gezählt?

Nein – Verkäufe aller Varianten eines Produkts werden auf das Hauptprodukt aggregiert. Wer eine blaue oder rote Variante kauft, zählt für den Verkaufszähler des Hauptartikels.

Wie ist die Performance bei großen Shops?

Pro Produktdetailseiten-Aufruf wird genau eine zusätzliche Datenbank-Abfrage ausgeführt (indexed). Bei sehr großen Shops können Sie die Mindestschwelle hochsetzen, um das Rendering auf wenige stark frequentierte Produkte zu beschränken.

Datenschutz

Das Plugin ist vollständig DSGVO-konform und speichert ausschließlich:

• SHA-256-Hash aus Session-ID + Sales-Channel-ID (nicht umkehrbar)
• Produkt-ID, Sales-Channel-ID
• Zeitstempel (last_seen, created_at)

Keine IP-Adressen, keine User-Agent-Strings, keine Cookies, keine Daten an Drittdienste. Heartbeats älter als 25 Stunden werden automatisch alle 5 Minuten gelöscht (Scheduled Task).