# WooCommerce-Plugin installieren

> Das DataFirefly Server-Side Plugin auf WooCommerce installieren und konfigurieren: Verbindungsschlüssel dfss\_, kompletter Funnel, Bestell-Deduplizierung.

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

---

Der komplette Funnel, von der Produktansicht bis zum Kauf, mit automatischer Deduplizierung und Wiederholungswarteschlange. HPOS-kompatibel.

## Voraussetzungen

- WordPress 5.8+, WooCommerce 5.0+, PHP 7.4+. HPOS-kompatibel.
- 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. WordPress-Admin: **Plugins > Add New > Upload Plugin**.
2. Laden Sie die Zip-Datei hoch, dann klicken Sie auf **Activate**.

## Konfiguration

1. Öffnen Sie **Settings > DataFirefly Server-Side**.
2. Fügen Sie den Verbindungsschlüssel `dfss_...` ein und klicken Sie auf **Connect**: Der Button aktiviert das vollständige Tracking und die Consent-Option und löst direkt ein Testereignis aus.

Das Plugin erkennt die folgenden Consent-Tools automatisch, ohne Einstellung: WP Consent API, Complianz, DataFirefly Cookie Consent, IAB TCF v2, Cookiebot, Didomi, Usercentrics, CookieYes, Iubenda, OneTrust, Cookiehub, Osano, Borlabs, Klaro, tarteaucitron. Die PrestaShop- und Shopware-Module verwenden dieselbe Erkennung: was hier erkannt wird, wird überall erkannt.

## Was das Plugin abdeckt

- Den gesamten Funnel: Navigation, Produktansicht, Warenkorb, Checkout, Kauf.
- Deduplizierung über die Bestellkennung: keine Doppelzählung zwischen Browser und Server.
- Automatische Wiederholungswarteschlange: Fehlgeschlagene Übertragungen werden erneut gesendet, Käufe zuerst (Details unten).
- Das Panel **DataFirefly Activity** im Admin zeigt die zuletzt gesendeten Ereignisse.

## Überprüfen

1. Das Testereignis muss im Monitoring Ihres Kundenbereichs als **Delivered** erscheinen.
2. Geben Sie eine Testbestellung auf und finden Sie sie im Panel DataFirefly Activity wieder.

## Wiederholungswarteschlange

Gilt ab Version 2.30.0.

- Eine fehlgeschlagene Übermittlung kommt in die Warteschlange und wird alle 5 Minuten per WP-Cron 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

- Nach jeder Konfigurationsänderung: **Leeren Sie den Cache** Ihrer Website. LiteSpeed Cache und Co. liefern sonst weiter das alte JavaScript aus.
- Wenn Sie eine Plugin-Version älter als 2.8.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
