1. Was ist dieses Modul

Das Modul erweitert Magento 2 um ein vollständiges Affiliate-System, das direkt innerhalb des Shops funktioniert. Das bedeutet, dass der Shopbetreiber Partner, Provisionen, Abrechnungen und Werbematerialien über den eigenen Adminbereich verwaltet, während die Partner ihr eigenes Dashboard im Kundenkonto nutzen.

In der Praxis ermöglicht das Modul die gleichzeitige Umsetzung mehrerer Kooperationsmodelle:

• klassisches Affiliate-Programm auf Basis von Tracking-Links,
• Empfehlungsprogramm auf Basis individueller Partnercodes,
• hybrides Modell: Affiliate-Link plus Rabattcode,
• Partnerprogramm für Shopkunden, Agenturen, Implementierungspartner und Content Creator.

2. Zentraler geschäftlicher Nutzen

Der größte Wert des Moduls liegt in der Verbindung von Verkauf, Attribution, Abrechnung und Partnermanagement an einem Ort. Der Shop muss kein externes Affiliate-System betreiben, Bestellungen nicht manuell exportieren und Partner nicht in Tabellenkalkulationen abrechnen.

Das Modul bietet dem Shopbetreiber:

• einen neuen Vertriebskanal,
• Kontrolle über die Regeln der Zusammenarbeit,
• transparente Verwaltung von Provisionen und Auszahlungen,
• übersichtliche Berichte zur Effektivität der Affiliates,
• die Möglichkeit, ein Programm auch in mittelgroßen und großen Shops sicher zu starten.

Der Partner erhält:

• einen eigenen Empfehlungscode,
• einen eigenen Affiliate-Link,
• ein fertiges Panel zur Überwachung der Aktivitäten,
• Einblick in Provisionen und Payouts,
• die Möglichkeit, Werbematerialien und Banner zu nutzen.

3. Für wen ist das Modul gedacht

Das Modul eignet sich für Shops, die ein Netzwerk von Vertriebspartnern aufbauen möchten, ohne externe Affiliate-Plattformen zu nutzen, oder die die volle Kontrolle über Daten und Abrechnungsprozesse behalten möchten.

Besonders gut eignet es sich für Projekte, in denen das Affiliate-Programm von folgenden Gruppen getragen werden soll:

• Kunden, die den Shop Freunden empfehlen,
• Online-Creator,
• Blogger und Publisher,
• Spezialisten und Berater,
• Implementierungspartner,
• Softwarehäuser und Agenturen,
• Reseller und B2B-Vertriebspartner,
• Markenbotschafter und Communities.

4. Wichtigste Funktionen des Moduls

4.1. Affiliate-Registrierung

Das Modul stellt ein Anmeldeformular für das Affiliate-Programm bereit. Der Kunde kann sich selbstständig für die Teilnahme am Programm bewerben und dabei grundlegende Kontaktdaten, die Adresse seiner Website oder seines Kanals sowie eine kurze Information zur geplanten Promotion angeben.

Nach dem Absenden des Formulars:

• wird ein Affiliate-Konto erstellt,
• wird ein eindeutiger referral_code generiert,
• wird der Status der Bewerbung auf Pending gesetzt,
• kann der Administrator eine Benachrichtigung über die neue Bewerbung erhalten,
• kann der Kunde eine Bestätigung über den Eingang der Bewerbung erhalten.

4.2. Freigabe des Partners

Der Administrator kann einen Affiliate über das Magento-Panel freigeben. Nach der Annahme:

• ändert sich der Partnerstatus auf Active,
• kann der Partner das Programm vollständig nutzen,
• kann ein Affiliate-Coupon aktiviert werden,
• kann der Kunde eine Nachricht über die Freigabe seiner Teilnahme erhalten.

4.3. Affiliate-Link

Jeder Affiliate erhält einen eigenen Affiliate-Link auf Basis von referral_code. Der Link funktioniert über einen Tracking-Controller und speichert die Attribution des Besuchs. Nach dem Klick kann das System:

• die Affiliate-Zuordnung in einem Cookie speichern,
• einen Besuchseintrag erstellen,
• einen Attributionseintrag erstellen,
• eine spätere Bestellung mit einem konkreten Affiliate verknüpfen.

4.4. Affiliate-Code und Rabattcoupon

Das Modul unterstützt auch ein Modell, bei dem referral_code als Rabattcode im Warenkorb funktionieren kann.

Der Administrator kann im Affiliate-Konto das Feld festlegen:

• Affiliate Coupon Discount (%)

Wenn der Wert größer als null ist, führt das System Folgendes aus:

• synchronisiert die native Magento-Regel Cart Price Rule,
• setzt den Couponcode gleich referral_code,
• berechnet einen prozentualen Rabatt im Warenkorb,
• behandelt die Verwendung dieses Codes als Quelle der Bestellattribution.

Dadurch kann der Affiliate Folgendes bewerben:

• einen normalen Affiliate-Link,
• nur den Rabattcode,
• die Kombination beider Mechanismen gleichzeitig.

Dies ist eine der praktischsten Vertriebsfunktionen des Moduls, da viele Shopbetreiber erwarten, dass ein Partner nicht nur Traffic vermittelt, sondern dem Kunden auch einen konkreten Preisvorteil bietet.

4.5. Bestellattribution

Das Modul kann eine Bestellung einem Affiliate auf Grundlage folgender Faktoren zuordnen:

• Klick auf einen Affiliate-Link,
• aktive Attribution, die in der Session oder im Cookie gespeichert ist,
• Verwendung eines Affiliate-Codes im Warenkorb,
• angemeldeter Kunde, der mit einer aktiven Attribution verknüpft ist.

Auf Bestellebene werden folgende Daten gespeichert:

• affiliate_id,
• affiliate_attribution_id,
• affiliate_referral_code,
• is_affiliate_order,
• affiliate_commission_amount,
• affiliate_commission_status.

Dadurch lässt sich die Verkaufsquelle direkt auf quote und sales_order auswerten.

4.6. Provisionsberechnung

Die Provision wird automatisch für eine Affiliate-Bestellung erstellt. Im aktuellen Modell:

• wird die Provision prozentual vom Subtotal der Bestellung berechnet,
• stammt der Standardtarif aus der Modulkonfiguration,
• vermeidet das System doppelte Provisionen für dieselbe Bestellung und denselben Affiliate,
• wird das Ergebnis in der Provisionstabelle und in der Bestellung gespeichert.

Die unterstützten Provisionsstatus umfassen unter anderem:

• pending,
• approved,
• ready_for_payout,
• paid,
• rejected,
• cancelled,
• charged_back.

4.7. Hold Period und automatische Freigabe

Das Modul unterstützt einen Zeitraum zur Zurückhaltung von Provisionen. Das bedeutet, dass eine Provision nicht sofort auszahlungsbereit sein muss. Sie kann für eine bestimmte Zeit im ausstehenden Status bleiben und erst nach Ablauf des festgelegten Zeitraums automatisch per Cron freigegeben werden.

Diese Lösung ist besonders wichtig bei:

• Risiko von Rücksendungen,
• manueller Prüfung von Bestellungen,
• Vertriebsmodellen mit verzögerter Finalisierung,
• Notwendigkeit, das Programm vor Missbrauch zu schützen.

4.8. Auszahlungen für Affiliates

Der Partner kann einen Auszahlungsantrag stellen, wenn die Mindestschwelle erfüllt ist und ein ausreichendes freigegebenes Guthaben vorhanden ist.

Der Payout-Workflow umfasst:

• Einreichen eines Payout Request,
• Zuordnung von Provisionen zum Payout,
• Änderung des Provisionsstatus auf ready_for_payout,
• Markierung der Auszahlung als bezahlt,
• Änderung der Provisionsstatus auf paid.

Dadurch kann der Shopbetreiber Auszahlungen geordnet und auditierbar durchführen.

4.9. Fraud Prevention

Das Modul verfügt über eine grundlegende Anti-Fraud-Schicht, die hilft, die offensichtlichsten Missbrauchsfälle zu eliminieren.

Dazu gehören unter anderem:

• Blockieren von Self-Referral,
• Markieren von Provisionen als abgelehnt, wenn Missbrauch erkannt wird,
• Bearbeitung von Fraud-Fällen,
• Register der Ablehnungsgründe,
• separate Ansicht der Fraud Cases auf Administratorseite.

Zusätzlich unterstützt das Modul:

• Stornierungen von Bestellungen,
• Chargebacks,
• Refunds über creditmemo,
• Änderung von Provisionsstatus nach Rückerstattungen.

4.10. Benachrichtigungen

Das Modul verfügt über ein eigenes System zum Queueing und zur Verarbeitung von Benachrichtigungen. Es kann operative Ereignisse speichern und E-Mail-Nachrichten versenden.

Unterstützte Fälle umfassen unter anderem:

• neue Affiliate-Bewerbung,
• Bestätigung des Bewerbungseingangs,
• Freigabe eines Affiliates,
• Provisionsereignisse,
• Payouts,
• Fraud Alerts.

4.11. Affiliate-Panel

Der Partner nutzt ein umfangreiches Dashboard im Magento-Kundenkonto. Das Dashboard ist nicht nur eine Provisionsliste, sondern ein vollständiges operatives Panel.

Im Affiliate-Panel verfügbar sind:

• Status der Programmteilnahme,
• Empfehlungscode,
• vollständiger Affiliate-Link,
• Standard-Zielpfad,
• Provisionsübersicht,
• Provisionshistorie,
• Wechsel zu Payouts,
• Inhalte zu den Kooperationsregeln,
• fertige Promotion-Snippets,
• Banner-Vorschau,
• AI-Bannergenerator.

4.12. AI-Bannergenerator

Das Modul enthält eine AI-gestützte Funktion, mit der der Affiliate auf Grundlage eines Briefings ein fertiges Werbebanner erstellen kann.

Der Benutzer kann Folgendes angeben:

• textliches Briefing,
• visuelle Richtung,
• Farben,
• Stil,
• optionale Grafik-URL,
• optionaler Target Link.

Das System übergibt an die AI-Schicht:

• Benutzerbriefing,
• Referral Link,
• Target Path,
• technische Anforderungen an das Antwortformat.

Der generierte HTML-Code des Banners kann im Affiliate-Konto gespeichert und vom Partner als fertiges Werbematerial verwendet werden.

4.13. Reporting

Das Modul unterstützt Berichte und CSV-Exporte für die wichtigsten Bereiche des Programms:

• Provisionen,
• Payouts,
• Fraud Cases,
• AI-Insights.

Dies erleichtert sowohl die tägliche Verwaltung des Programms als auch die Analyse der Partnerleistung.

5. Adminbereich

Das Modul erweitert den Magento-Adminbereich um Konfiguration und Verwaltung des Affiliate-Programms.

Der Administrator hat Zugriff auf:

• globale Programmeinstellungen,
• Provisionseinstellungen,
• Payout-Einstellungen,
• Einstellungen des Affiliate-Portals,
• Benachrichtigungseinstellungen,
• Fraud-Einstellungen,
• AI-Einstellungen,
• Reporting-Einstellungen.

Zusätzlich stehen im Panel operative Bereiche zur Verfügung:

• Affiliate Commissions,
• Affiliate Payouts,
• Affiliate Fraud Cases,
• Affiliate Reports.

In der Kundenliste und in der Kundenbearbeitung sind Affiliate-Daten sichtbar, wie zum Beispiel:

• Teilnahme am Programm,
• Affiliate-Status,
• Affiliate-Guthaben,
• Empfehlungscode,
• Rabattprozentsatz des Affiliate-Coupons.

6. Wie Affiliate-Marketing in der Praxis funktioniert

6.1. Szenario mit Affiliate-Link

1. Der Partner erhält seinen Link.
2. Der Kunde klickt auf den Link und gelangt in den Shop.
3. Das System speichert Besuch und Attribution.
4. Der Kunde gibt eine Bestellung auf.
5. Die Bestellung wird dem Affiliate zugeordnet.
6. Eine Provision wird erstellt.
7. Nach Ablauf der Hold Period kann die Provision freigegeben werden.
8. Nach Erfüllung der Bedingungen kann der Partner einen Auszahlungsantrag stellen.

6.2. Szenario mit Affiliate-Code im Warenkorb

1. Der Partner veröffentlicht seinen Affiliate-Code.
2. Der Kunde gibt den Code im Warenkorb ein.
3. Magento berechnet den Rabatt aus der Warenkorbregel.
4. Das Modul erkennt den Code als Affiliate-Code.
5. Die Bestellung wird dem Affiliate zugeordnet.
6. Eine Provision wird gemäß den Programmregeln erstellt.

6.3. Hybrides Szenario

Der Kunde kann den Shop zunächst über einen Affiliate-Link besuchen und anschließend den Rabattcode des Affiliates verwenden. Dieses Modell ermöglicht die Kombination von klassischem Tracking mit Vorteilen für den Endkunden.

7. Sicherheitsbereiche

Das Modul wurde für den Produktiveinsatz vorbereitet und berücksichtigt daher:

• Audit-Einträge,
• Bearbeitung von Rückerstattungen und Stornierungen,
• Blockieren von Self-Referral,
• Benachrichtigungs-Queue,
• Mechanismen zur Begrenzung doppelter Provisionen,
• sichere Speicherung der AI-Konfiguration,
• Begrenzung der an die AI-Schicht gesendeten Daten,
• Möglichkeit zur Diagnose von Integrationsfehlern.

8. Integration mit AI

Die AI-Schicht im Modul ist optional und blockiert nicht den Betrieb des grundlegenden Affiliate-Programms. Sie kann verwendet werden für:

• Affiliate-Assistent,
• Generierung von Insights,
• Generierung von Bannern,
• Retrieval von Produktwissen über vector_store_id.

Das Modul muss keine eigene Produktdatenbank für AI verwalten, wenn der Shop bereits ein externes Modul zur Verwaltung von Produktwissen und Vector Store nutzt.

9. Vertriebseinsatz

Das Modul kann als Lösung für mehrere Projekttypen verkauft werden:

• B2C-Shops mit Empfehlungsprogramm,
• Premium-Shops, die ein Netzwerk von Markenbotschaftern aufbauen möchten,
• B2B-Unternehmen mit einem Programm für Handelspartner,
• digitale Shops und Software-Shops,
• Agenturimplementierungen, bei denen der Kunde ein vollständiges Partnerprogramm ohne externes SaaS benötigt.

Besonders starke Verkaufsargumente sind:

• volle Kontrolle über die Daten,
• kein Abonnement einer externen Affiliate-Plattform,
• Integration mit Magento 2 ohne Zwischenanbieter,
• Unterstützung von Affiliate-Links und Affiliate-Coupons,
• fertiges Partnerpanel,
• Möglichkeit der weiteren Erweiterung um AI.

10. Wichtigste Vorteile des Moduls

Die wichtigsten Vorteile dieser Lösung sind:

• funktioniert direkt in Magento 2,
• unterstützt sowohl Links als auch Affiliate-Codes,
• verwaltet Rabattcoupons, die mit einem Affiliate verknüpft sind,
• ermöglicht die Verwaltung von Partnern auf Ebene des Magento-Kunden,
• verfügt über einen realen Workflow für Provisionen und Payouts,
• enthält grundlegende Sicherheit und Audit-Funktionen,
• bietet ein modernes Affiliate-Dashboard,
• ist bereit für die Weiterentwicklung um zusätzliche Enterprise-Funktionen.

11. Systemanforderungen

Das Modul ist vorgesehen für:

• Magento Open Source / Adobe Commerce 2.4.7+
• PHP 8.2 / 8.3

Es erfordert kompatible Magento-Module in Verbindung mit:

• Customer,
• Quote,
• Sales,
• SalesRule,
• Cms,
• Email,
• Backend,
• Store.

12. Implementierungsumfang

Das Modul kann schrittweise implementiert werden:

• Start mit Affiliate-Links und Provisionen,
• Erweiterung um Payouts,
• Erweiterung um Affiliate-Coupons,
• Erweiterung um AI und Content für Affiliates,
• weitere Erweiterung um fortgeschrittenere Provisionsregeln und Fraud Scoring.

Das bedeutet, dass es sich sowohl für MVP-Implementierungen als auch für die langfristige Entwicklung eines Partnerprogramms eignet.

13. Zusammenfassung

Kowal_Affiliate ist ein ausgereiftes Affiliate-Modul für Magento 2, mit dem ein vollständiges Partnerprogramm innerhalb des eigenen Shops verkauft und gestartet werden kann. Es verbindet klassische Affiliate-Links, Empfehlungscodes, Rabattcoupons, Provisionen, Payouts, grundlegende Fraud Prevention, Reporting und ein modernes Partnerpanel.

Aus Vertriebsperspektive ist es nicht nur ein Zusatz für Empfehlungslinks, sondern eine vollständige Partnerschicht für Magento 2, die angeboten werden kann als:

• Standalone-Modul,
• Element einer Shop-Implementierung,
• Teil eines Growth- / Performance-Pakets,
• Basis für ein fortgeschritteneres Partner- und Markenbotschafterprogramm.

In der Praxis ist es eine Lösung, die reale Anforderungen von Shops erfüllt, die nach Folgendem fragen:

• Affiliate-Programm in Magento 2,
• Rabattcodes für Partner,
• Provisionsabrechnung,
• Partnerpanel,
• Bereitschaft für Verkauf und Produktivbetrieb.