# Shopware-Plugin installieren

> Das DataFirefly Server-Side Plugin auf Shopware 6.5, 6.6 und 6.7 installieren und konfigurieren: Extension-Upload, Verbindungsschlüssel, Consent-Cookie, CLI-Test.

- Originalseite: https://server-side.datafirefly.com/de/docs/shopware.html
- Sprache: de
- Aktualisiert am: 2026-09-05
- Herausgeber: DataFirefly (Datafirefly Limited), https://server-side.datafirefly.com/de/

---

Kompatibel mit Shopware 6.5, 6.6 und 6.7. Installation über den Admin oder die Kommandozeile. Eine fehlgeschlagene Übermittlung wird in eine Warteschlange gelegt und alle fünf Minuten vom Shopware-Scheduler erneut gesendet: ein kurzer Ausfall kostet nichts.

## Voraussetzungen

- Shopware 6.5, 6.6 oder 6.7.
- Die Zip-Datei des Plugins, herunterzuladen auf der Seite [**Modules**](https://admin.datafirefly.com/app/connectors) Ihres Kundenbereichs.
- Der [Verbindungsschlüssel Ihrer Website](https://server-side.datafirefly.com/de/docs/connect-your-site.html).

## Installation

1. Shopware-Admin: **Extensions > My extensions > Upload extension**, dann installieren und aktivieren Sie das Plugin.
2. Oder per CLI: `bin/console plugin:install --activate DatafireflyServerSide`

## Konfiguration

1. Öffnen Sie die Plugin-Konfiguration und fügen Sie den Verbindungsschlüssel `dfss_...` ein.
2. Aktivieren Sie **Enable tracking**.

Das Modul erkennt die gängigen Consent-Tools selbst (DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron), im Browser wie auf dem Server, dieselbe Liste wie bei den WooCommerce- und PrestaShop-Modulen. Lassen Sie **Consent cookie name** leer für diese automatische Erkennung; füllen Sie es nur aus, um ein bestimmtes Cookie zu erzwingen (zum Beispiel `CookieConsent` und `marketing:true`), das dann Vorrang hat.

## Überprüfen

1. Führen Sie `bin/console datafirefly:serverside:test` aus.
2. Das Testereignis muss im Monitoring Ihres Kundenbereichs als **Delivered** erscheinen.

## Wiederholungswarteschlange

Gilt ab Version 1.23.0.

- Eine fehlgeschlagene Übermittlung kommt in die Warteschlange und wird alle 5 Minuten von einer geplanten Aufgabe (Scheduled Task) von Shopware erneut gesendet.
- Käufe und Erstattungen gehen vor, danach die neuesten Ereignisse.
- Ein Ereignis verlässt die Warteschlange erst, wenn es älter als 7 Tage ist **und** seit mehr als 7 Tagen wartet. Es wird dann als abgelaufen gezählt: Nichts verschwindet stillschweigend.
- Antwortet DataFirefly nicht (Netzwerkfehler, HTTP 429 oder 5xx), sendet der Shop 60 Sekunden lang nicht mehr direkt und legt die Ereignisse sofort in die Warteschlange. Ein Ausfall bei uns bremst Ihren Shop und den Checkout also nie aus. Die Wiederholung versucht es weiter, und sobald sie gelingt, wird wieder direkt gesendet.
- Die Seite Ihrer Website im Kundenbereich zeigt den Zustand dieser Warteschlange. Die Zustände erklärt die Seite [Fehlerbehebung](https://server-side.datafirefly.com/de/docs/troubleshooting.html).

## Wenn etwas nicht funktioniert

- Logs in `var/log/`, Präfix `[DataFirefly SS]`.
- Wenn Sie eine Plugin-Version älter als 1.9.0 verwenden, aktualisieren Sie: Aktuelle Versionen beheben eine mögliche Doppelzählung der Käufe in GA4.
- Die weiteren häufigen Ursachen finden Sie im [Leitfaden zur Fehlerbehebung](https://server-side.datafirefly.com/de/docs/troubleshooting.html).

Aktualisiert: 1. September 2026
