Real Profit Dashboard — Komplette Anleitung

Real Profit Dashboard berechnet die reale Profitabilität Ihres WooCommerce-Shops, Bestellung für Bestellung. Dieser Leitfaden behandelt Installation, Kostenkonfiguration (Wareneinsatz, Zahlungsgebühren, Versand), Anbindung der drei Werbe-Integrationen (Meta, Google, TikTok), Dashboard-Nutzung und laufende Wartung.

Voraussetzungen

• WordPress 6.2 oder neuer
• WooCommerce 8.0 oder neuer (HPOS- und Cart-&-Checkout-Blocks-kompatibel)
• PHP 8.0 oder neuer
• Administrator-Zugang zum WordPress-Backend
• API-Zugangsdaten für Meta Ads, Google Ads und/oder TikTok Ads, wenn Sie den automatischen Import der Werbeausgaben aktivieren möchten (optional)

Installation

1. Gehen Sie zu Plugins → Installieren → Plugin hochladen.
2. Wählen Sie die Datei dfrealprofit.zip und klicken Sie auf Jetzt installieren.
3. Aktivieren Sie das Plugin.
4. Ein neues Hauptmenü Profit Dashboard erscheint in der Seitenleiste unterhalb von WooCommerce.

Erste Schritte

Einkaufskosten (Wareneinsatz) auf Ihren Produkten hinterlegen

Der Wareneinsatz (COGS, Cost of Goods Sold) ist die Basis der Margenberechnung. Ohne ihn wird der angezeigte Gewinn überschätzt.

• Einfaches Produkt: öffnen Sie die Produktseite, Reiter Allgemein, füllen Sie das Feld Einkaufskosten mit dem netto an den Lieferanten gezahlten Betrag.
• Variables Produkt: jede Variation hat ihr eigenes Feld Einkaufskosten. Es ist unerlässlich, es Variation für Variation zu befüllen, wenn die Kosten unterschiedlich sind (Größen, Farben, Materialien).
• Bulk: das Feld ist auch über die WooCommerce REST API beschreibbar (PUT /wp-json/wc/v3/products/{id}, Meta _dfrp_cogs), was einen Massenimport aus einem ERP ermöglicht.

Eine Spalte Wareneinsatz erscheint in der Produktliste, um schnell diejenigen zu identifizieren, die noch nicht befüllt wurden.

Zahlungsgebühren konfigurieren

Gehen Sie zu Profit Dashboard → Einstellungen → Zahlungsgebühren.

• Stripe, WooCommerce PayPal Payments, Mollie: keine Einstellung erforderlich. Das Plugin liest die tatsächlichen Gebühren direkt aus den Bestell-Metadaten (_stripe_fee, _ppcp_paypal_fees, _mollie_fee).
• Andere Zahlungsanbieter: tragen Sie das anwendbare Schema aus Prozent + Fixbetrag ein. Zum Beispiel für eine kostenlose Überweisung: 0 % / 0 €. Für einen Scheck mit Bankgebühren: 0 % / 0,15 €. Diese Standardwerte werden verwendet, wenn keine Real-Gebühr-Metadaten auf der Bestellung gefunden werden.

Versandkosten konfigurieren

Gehen Sie zu Profit Dashboard → Einstellungen → Standard-Versandkosten. Die Tabelle listet automatisch alle Versandmethoden Ihrer WooCommerce-Zonen auf.

Tragen Sie für jede Methode die durchschnittlichen tatsächlichen Kosten an den Spediteur ein (ohne die Marge, die Sie dem Kunden aufschlagen). Wenn Sie zum Beispiel 6,90 € für einen DHL-Versand berechnen, der Sie 4,50 € kostet, geben Sie 4,50 ein.

Werbe-Integrationen

Jede Integration ist unabhängig. Sie können eine, zwei oder alle drei aktivieren. Alle werden unter Profit Dashboard → Einstellungen konfiguriert.

Meta Ads (Facebook + Instagram)

1. Erstellen Sie eine App in Meta for Developers oder verwenden Sie eine bestehende.
2. Generieren Sie einen Long-Lived Access-Token mit dem Scope ads_read. Die offizielle Dokumentation steht unter Marketing API → Get Started.
3. Rufen Sie Ihre Ad-Account-ID aus Meta Business Manager → Einstellungen → Werbekonten ab (numerisches Format, ohne das Präfix act_).
4. Aktivieren Sie in den Plugin-Einstellungen Meta Ads aktivieren, fügen Sie den Access-Token und die Ad-Account-ID ein.
5. Speichern Sie und klicken Sie im Dashboard auf Ads jetzt synchronisieren, um die Verbindung zu validieren.

Google Ads

Google Ads verwendet OAuth 2. Sie benötigen fünf Zugangsdaten.

1. Developer-Token: beantragen Sie ihn aus Ihrem Google Ads Manager (MCC) Konto unter Tools & Einstellungen → Einrichtung → API-Center.
2. Customer-ID: die 10-stellige ID des Werbekontos, dessen Ausgaben Sie verfolgen möchten (ohne Bindestriche).
3. OAuth-Client-ID und Client-Secret: erstellen Sie ein Projekt in der Google Cloud Console, aktivieren Sie die Google Ads API, erstellen Sie einen OAuth-2-Client vom Typ Desktop-Anwendung.
4. Refresh-Token: erhalten Sie ihn einmal über den OAuth-Flow (siehe Google Ads API v18 Dokumentation). Er ändert sich nie.

TikTok Ads

1. Erstellen Sie eine App in TikTok Business Developers.
2. Autorisieren Sie sie auf Ihrem Werbekonto, um einen Access-Token zu erhalten.
3. Rufen Sie die Advertiser-ID aus dem TikTok Ads Manager ab (Konto-Menü, oben rechts).
4. Aktivieren Sie in den Plugin-Einstellungen TikTok Ads aktivieren, fügen Sie den Access-Token und die Advertiser-ID ein.

Multi-Touch-Attribution

Sobald das Plugin aktiv ist, werden auf jedem Besucher zwei Cookies gesetzt: dfrp_ft (First-Touch, erster bekannter Kanal) und dfrp_lt (Last-Touch, jüngster Kanal). Beide leben 90 Tage.

Bei jedem Besuch erfasst das Plugin die folgenden URL-Parameter:

• Standard-UTMs: utm_source, utm_medium, utm_campaign, utm_content, utm_term
• Klick-Identifier: fbclid (Facebook), gclid (Google), ttclid (TikTok)

Bei der Bestellabgabe werden beide Cookies in den Bestell-Metadaten fixiert (_dfrp_utm_ft, _dfrp_utm_lt). Der normalisierte Kanal wird dann aus dem Last-Touch abgeleitet (Fallback auf First-Touch) und in eine dieser neun Kategorien eingeordnet: Facebook, Instagram, Google, TikTok, Email, Organic, Direct, Referral, Other.

Zuordnung der Werbeausgaben

Zwei Modi stehen in den Einstellungen zur Verfügung:

• Pro Bestellung (Standard): die tägliche Gesamtausgabe eines Kanals wird durch die Anzahl der diesem Kanal an diesem Tag zugeordneten Bestellungen geteilt. Jede Bestellung erhält einen gleichen Anteil.
• Anteilig am Umsatz: die Ausgabe wird proportional zum Anteil jeder Bestellung am Tagesumsatz des Kanals verteilt. Eine 300-€-Bestellung erhält dreimal mehr Werbekosten als eine 100-€-Bestellung.

Dashboard-Nutzung

Das Haupt-Dashboard ist unter Profit Dashboard → Übersicht erreichbar.

Wichtigste KPIs

Sieben Kennzahlen werden oben auf der Seite für den gewählten Zeitraum angezeigt:

• Umsatz: Nettoumsatz (je nach Einstellung ohne Steuern, ohne Erstattungen)
• Wareneinsatz: Summe der Einkaufskosten der verkauften Positionen
• Zahlungsgebühren: Summe der Anbietergebühren
• Versand: Summe der tatsächlichen Versandkosten
• Werbung: Summe der zugeordneten Werbeausgaben
• Nettogewinn: Umsatz − Wareneinsatz − Zahlungsgebühren − Versand − Werbung − Sonstige Kosten
• Marge: Nettogewinn / Umsatz in Prozent

Diagramm und Kanäle

Unterhalb der KPIs zeigt ein Balkendiagramm den täglichen Gewinn über den Zeitraum (grüne Balken für positiven Gewinn, rote für Verluste).

Der Block Performance je Kanal aggregiert Bestellungen je normalisiertem Kanal mit: Bestellanzahl, Umsatz, Werbeausgaben, ROAS (Return On Ad Spend = Umsatz / Werbeausgaben), Nettogewinn und Marge.

Filter und Zeiträume

Sieben vordefinierte Zeiträume: Heute, 7 Tage, 30 Tage, 90 Tage, Laufender Monat, Laufendes Jahr, Benutzerdefiniert. Die Zeiträume sind relativ zum aktuellen Tag und aktualisieren sich bei jedem Seitenaufruf automatisch.

Metabox in der Bestellansicht

Jede Bestellung verfügt über eine Metabox Real Profit Dashboard in der rechten Seitenleiste ihres Bearbeitungsbildschirms. Sie zeigt den erkannten Akquisitionskanal und bietet drei manuelle Eingabefelder, die die berechneten Werte überschreiben:

• Zahlungsgebühren (€): um einen bestimmten Wert zu erzwingen (z. B. nach einer Teilrückerstattung von Gebühren)
• Tatsächliche Versandkosten (€): der tatsächlich an den Spediteur gezahlte Betrag für diese konkrete Bestellung
• Sonstige Kosten (€): freies Feld für alle spezifischen Kosten (Zoll, Spezialverpackung, Kundenretoure usw.)

Eine Zusammenfassung unter den Feldern zeigt in Echtzeit: Nettoumsatz, detaillierte Kosten, Gewinn und Marge. Jede Speicherung der Bestellung löst eine automatische Neuberechnung aus.

CRON und Synchronisation

Zwei automatische Aufgaben sind eingeplant:

• dfrp_cron_sync_ads (stündlich): ruft jede aktive Integration auf, um die Ausgaben der letzten 7 Tage kampagnengenau abzurufen und die Tabelle wp_dfrp_ad_spend zu aktualisieren.
• dfrp_cron_recalculate_orders (stündlich, verkettet): berechnet die Metriken der Bestellungen der letzten 14 Tage neu, um die neu importierten Werbeausgaben zu berücksichtigen.

Das vollständige Protokoll jeder Ausführung ist unter Profit Dashboard → Sync-Logs zugänglich: Status, Dauer, Anzahl der eingefügten und aktualisierten Datensätze, ggf. Fehlermeldung.

Manuelle Neuberechnung

Die Schaltfläche 60 Tage neu berechnen im Dashboard erzeugt die Metriken aller Bestellungen der letzten 60 Tage neu. Verwenden Sie sie nach:

• der initialen Installation des Plugins (um die Historie zu initialisieren)
• einer Massenänderung der Produkt-Wareneinsätze
• einer Änderung der Zahlungsgebühr- oder Versandkosten-Schemata
• einer Änderung des Zuordnungsmodus für Werbeausgaben

Der Vorgang ist idempotent: mehrmaliges Ausführen liefert das gleiche Ergebnis.

REST API

Drei Endpunkte werden unter /wp-json/dfrealprofit/v1/ bereitgestellt. Sie erfordern die Berechtigung manage_woocommerce und akzeptieren die Authentifizierung per WordPress-Cookie oder Application Password.

• GET /summary?from=YYYY-MM-DD&to=YYYY-MM-DD — aggregierte KPIs (Umsatz, Wareneinsatz, Gebühren, Werbung, Gewinn, Marge)
• GET /series?from=YYYY-MM-DD&to=YYYY-MM-DD — tägliche Zeitreihe (Umsatz, Kosten, Gewinn je Tag)
• GET /channels?from=YYYY-MM-DD&to=YYYY-MM-DD — Performance je Kanal (Bestellungen, Umsatz, Werbung, ROAS, Gewinn, Marge)

Diese Endpunkte erlauben es, ein externes Dashboard (Looker Studio, Metabase, Grafana, Tabellenkalkulation) an die Plugin-Metriken anzubinden.

Deinstallation

Eine reine Deaktivierung löscht keine Daten. Die vollständige Löschung aus Plugins löst uninstall.php aus, das:

• die drei Custom-Tabellen (ad_spend, order_metrics, sync_log) löscht
• die Plugin-Optionen entfernt
• die CRON-Aufgaben ausplant
• die Produkt-Wareneinsätze und die Bestell-Metadaten beibehält (wertvolle Geschäftsdaten)

Für eine vollständige Bereinigung einschließlich der Metadaten müssen zwei SQL-Zeilen in uninstall.php vor der Deinstallation auskommentiert werden.

Kurze FAQ

Ist das Plugin mit WooCommerce Subscriptions kompatibel?

Ja. Jede Verlängerung erzeugt eine Standardbestellung, die wie jede andere verarbeitet wird.

Was passiert, wenn ich den Preis eines Produkts ändere?

Nichts für bestehende Bestellungen: der historische Wareneinsatz und Preis bleiben zum Zeitpunkt des Verkaufs eingefroren. Nur neue Bestellungen verwenden den neuen Preis.

Wie behandle ich eine Rückerstattung?

Erstellen Sie eine Standardrückerstattung aus WooCommerce. Der Nettoumsatz wird automatisch neu berechnet (der erstattete Gesamtbetrag wird abgezogen). Bereits angefallene Kosten (Wareneinsatz, Versand, Zahlungsgebühren, Werbung) bleiben, was den realen Verlust zeigt.

Kann ich das Plugin ohne Ads-Integration nutzen?

Ja. Ohne Werbe-Integration sind die Werbekosten null und die Berechnung beschränkt sich auf Nettoumsatz − Wareneinsatz − Zahlungsgebühren − Versand − Sonstige Kosten. Das ist bereits deutlich besser als das, was WooCommerce standardmäßig anzeigt.

Werden Daten an einen externen Server gesendet?

Nein. Die einzigen externen Aufrufe sind diejenigen, die Sie selbst zu den APIs von Meta, Google und TikTok konfigurieren, um Ihre Ausgaben abzurufen. Keine Daten aus Ihrem Shop werden an DataFirefly oder Dritte gesendet.