WooCommerce-Integration — Statnive Dokumentation

Überblick

Statnive Revenue Report für WooCommerce — fünf KPI-Kacheln (Umsatz netto, Bestellungen, AOV, Erstattungssumme, Steuer + Versand), Tabelle „Umsatz nach Channel", Liste der Top-Produkte und Cart-to-Purchase-Funnel mit Conversion pro Schritt

Seit v1.0.0 liefert das kostenlose Statnive-WordPress-Plugin einen eigenen Revenue Report aus, der Ihre WooCommerce-Bestelldaten in ein CRO-orientiertes Dashboard innerhalb von /wp-admin verwandelt. Keine Einrichtung, keine kostenpflichtige Stufe, keine Übertragung an Dritte — alle Daten bleiben in Ihrer WordPress-Datenbank.

Die Integration setzt auf WooCommerce 8.5+ Order Attribution, ist HPOS- und Block-Checkout-kompatibel und arbeitet READ-ONLY gegenüber WooCommerce — Statnive verwendet ausschließlich $order->get_*()-Getter und schreibt nie in eine WooCommerce-Tabelle oder ein Post-Meta.

Voraussetzungen

WordPress 6.2+ (getestet bis 7.0)
PHP 8.1+ (in v0.4.13 von 8.0 angehoben)
WooCommerce 8.5+ (Order Attribution erforderlich für die Channel-Attribution)
Action Scheduler (seit 5.4 in WooCommerce enthalten)

Fünf KPIs im Revenue Report

KPI	Quelle	Hinweise
Bestellungen	`COUNT(orders)` in `processing` + `completed`	Erstattete Bestellungen werden separat unter Erstattungssumme erfasst
Umsatz (netto)	`net_total − refund_total`	Ohne Steuer und Versand; ein Hilfswert `Gross: $X` erscheint darunter
Durchschnittlicher Bestellwert	`net_revenue / orders`	Präzise Dezimalanzeige gemäß der Währungseinstellungen Ihres WooCommerce-Shops
Erstattungssumme + Quote	`refund_total`, `refund_rate = refunds / gross`	Angezeigt als kombiniertes „Erstattungssumme · Quote: X %“
Steuer + Versand	`tax_total + shipping_total`	Kombinierter Wert, explizit gekennzeichnet als „Nicht im Umsatz enthalten”

Sieben Aufschlüsselungen

Der Revenue Report rendert sieben Dimensionen auf der Seite; alle elf Endpoints (wc-status, backfill, summary, timeseries, by-channel, by-utm, by-landing, products, funnel, refunds, coupons) sind außerdem über die REST API verfügbar.

Umsatz nach Channel

Sortierbare Tabelle mit Channel · Bestellungen · Umsatz · AOV über die 8 Channels, in die Statnive Traffic gruppiert:

Direct
KI-Assistenten — 14 Hosts: ChatGPT (chatgpt.com, chat.openai.com), Claude (claude.ai), Gemini (gemini.google.com, bard.google.com, notebooklm.google.com), Copilot (copilot.microsoft.com), Perplexity (perplexity.ai), Meta AI (meta.ai), Le Chat / Mistral (chat.mistral.ai), DeepSeek (deepseek.com, chat.deepseek.com), You (you.com), iAsk (iask.ai), Jasper (jasper.ai), Writesonic (writesonic.com). Die KI-Erkennung läuft vor dem Suchmaschinen-Klassifikator, sodass KI-Verweise nie fälschlich der Organischen Suche zugeordnet werden.
Organische Suche
Social Media
E-Mail
Verweis
Bezahlte Suche (aus UTM-medium = cpc, ppc, paidsearch, paid_search)
Bezahlte Social-Anzeigen (aus UTM-medium = cpm, paid_social)

Top-Produkte

Standardmäßig die Top 10 Produkte (sortierbar nach Einheiten oder Umsatz, maximal 100). Variationen werden unter ihrem übergeordneten Produkt gruppiert. Erstattungen werden auf die Position angewendet.

Cart-to-Purchase-Funnel

Vier Stufen, serverseitig aus WooCommerce — kein zusätzliches JavaScript zu installieren:

Produkt angesehen — Event: wc_product_view
In den Warenkorb gelegt — Event: wc_add_to_cart
Checkout gestartet — Event: wc_checkout_start
Kauf abgeschlossen — Event: wc_purchase

Conversion-Rate pro Schritt (aktuell/vorher) und die Gesamt-Conversion-Rate (Käufe/breitester Eingang) werden neben den Session-Zahlen angezeigt.

v1.1.0-Update. Der Nenner für „Gesamt %” wurde von der ersten Stufe auf die breiteste Stufe umgestellt, und die UI pro Schritt zeigt die Conversion-Rate, nicht die Drop-Rate. Das entspricht der Konvention, die WooCommerce Analytics in WC 9.x übernommen hat.

Umsatz nach UTM source / medium / campaign

Paginierte Tabelle mit den Werten von utm_source, utm_medium und utm_campaign, die auf attribuierten Bestellungen gesehen wurden, mit Bestellungen, Umsatz und AOV pro Zeile.

Umsatz nach Landing-Seite

Paginierte Tabelle der Einstiegs-Landingpages mit Bestellungen und Umsatz pro Seite — beantwortet die Frage „welche Einstiegsfläche bringt tatsächlich Käufer?”

Erstattungen

Trend der Erstattungsquote über den Zeitraum sowie eine Liste der meistgenutzten Erstattungsprodukte; Erstattungen werden auf Positionsebene verbucht.

Gutscheine

Paginierte Tabelle der Gutschein-Einlösungen: Code, Anzahl, Gesamtrabattbetrag und Nettoumsatz nach Rabatt.

v1.1.0 Datenbereich-Zuordnung

Bestellungen werden nach COALESCE(date_paid_gmt, date_created_gmt) zugeordnet, damit Abo-Verlängerungen und Bestellungen mit verzögerter Zahlung (BACS, Scheck, Nachnahme, verspätet abgeschlossene Webhooks) dem Tag zugeordnet werden, an dem die Zahlung gebucht wurde — nicht dem Tag der Bestellaufgabe. v1.0.0 nutzte zuvor nur date_created_gmt, wodurch Verlängerungs-Zahlungen fälschlich in die Vergangenheit gerieten.

Zero-Touch-Backfill

Wenn Sie nach der Aktivierung von v1.0.0 auf einer WooCommerce-Site den Revenue Report zum ersten Mal öffnen, reiht Statnive über den Action Scheduler Hintergrund-Jobs ein, um historische Bestellungen zu importieren. Der Status erscheint während der Ausführung oben im Revenue Report.

Chunk-Größe: 500 Bestellungen pro Action-Scheduler-Hook (statnive/wc/backfill/chunk)
Berücksichtigte Status: processing und completed. Erstattete Positionen mindern den Positionsumsatz auf der zugehörigen Bestellung, statt als eigener Status gezählt zu werden.
Sichtbarkeit: WooCommerce → Status → Geplante Aktionen, Filter nach statnive/wc/backfill/chunk

CLI-Alternative

Für Sites, auf denen Sie den Backfill lieber über die Kommandozeile anstoßen oder überwachen:

wp statnive woocommerce-backfill

Der Befehl ist idempotent — ein erneuter Aufruf während eines laufenden Backfills liefert einen 409.

Datenbank-Tabellen

v1.0.0 legt über dbDelta fünf neue Tabellen an. Ihre bestehenden Statnive-Tabellen und -Daten bleiben beim Upgrade von 0.4.x erhalten.

Tabelle	Zweck
`wp_statnive_orders`	Bestell-Metadaten, Attributions-Snapshot, Channel
`wp_statnive_order_attribution`	Channel, UTM-Parameter, Referrer-Host, Funnel-Schritte
`wp_statnive_order_items`	Positionen, Produkte, SKU, Erstattungs-Tracking
`wp_statnive_order_refunds`	Erstattungsereignisse mit Betrag und Grund
`wp_statnive_order_coupons`	Gutschein-Nutzung pro Bestellung, Rabattbeträge

Das Tabellen-Präfix folgt Ihrem WordPress-$wpdb->prefix.

Datenschutz und Sicherheit

READ-ONLY gegenüber WooCommerce. Nur $order->get_*()-Getter; Statnive schreibt nie in eine WooCommerce-Tabelle oder ein Post-Meta. Empirisch verifiziert mit CHECKSUM TABLE vor/nach auf einer Site mit 1.933 Bestellungen.
Ohne Cookies. Keinerlei Browser-Speicher zur Besucher-Identifikation.
Täglich rotierende Salts (CSPRNG-generiert, 48-Stunden-Überlappungsfenster) — derselbe Besucher erzeugt jeden Tag einen anderen Hash, sodass eine tagesübergreifende Wiederidentifizierung unmöglich ist.
Keine Speicherung roher IPs. Die IP wird gehasht, für das GeoIP-Lookup verwendet und anschließend sofort verworfen. IPv4: letztes Oktett auf null gesetzt. IPv6: letzte 80 Bit auf null gesetzt.
GPC + DNT werden serverseitig respektiert.
WordPress Privacy API — Exporter und Eraser werden bei der Aktivierung registriert.
Opt-in-Deinstallation (standardmäßig AUS). Eine Neuinstallation bewahrt Analyse- und Umsatz-Historie.

Oberste Admin-Seiten

Nach der Aktivierung von v1.1.0 hat die Statnive-Admin-Navigation diese gescopten Seiten:

Übersicht (/wp-admin/admin.php?page=statnive) — Besucher, Sessions, Seitenaufrufe, durchschnittliche Verweildauer sowie Top-Quellen und Top-Seiten
Revenue Report (/wp-admin/admin.php?page=statnive-revenue) — die fünf KPIs + sieben oben beschriebene Aufschlüsselungen
Ask me! (/wp-admin/admin.php?page=statnive-ask) — 116 betreiberformulierte Fragen in 10 Kategorien, 63 antworten heute (v1.1.0+)
Einstellungen (/wp-admin/admin.php?page=statnive-settings) — Datenschutz, Aufbewahrung, Ausschlüsse, GeoIP

Eine WooCommerce-spezifische Konfiguration ist nicht erforderlich. Die Integration ist immer aktiv, sobald WooCommerce installiert ist.

Upgrade von 0.4.x

Drop-in-Upgrade. Fünf neue Tabellen werden über dbDelta ergänzt; die bestehenden 21 Tabellen und ihre Daten bleiben unberührt. Auf einer WooCommerce-Site füllt sich der Revenue Report wenige Minuten nach der Aktivierung über den Zero-Touch-Backfill. Keine Code-Änderung erforderlich.

Den vollständigen Release-Hinweis finden Sie im Changelog zu v1.0.0.