MAGENTO 2 · PARTNER · PROVISIONEN · LINKS UND GUTSCHEINE

Kowal Affiliate

Verbinden Sie Partnerregistrierung, Bestellattribution und Abrechnung mit dem Affiliate-Panel. Verwalten Sie Links, Rabattcodes und Provisionsverlauf und nutzen Sie optionale KI für Partnersupport und Werbematerialien.

Partnerlink und -code · Provisionen und Guthaben · Auszahlungsworkflow

SO FUNKTIONIERT ES IN DER PRAXIS

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.

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, nach Implementierungsvalidierung ein Programm für mittlere und große Shops vorzubereiten.

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.

Das Modul eignet sich für Shops, die ein Vertriebspartnernetz ohne externe Affiliate-Plattformen aufbauen oder vollständige Kontrolle über Daten und Abrechnung behalten möchten.

Besonders geeignet ist es für Programme mit:

• Kunden, die den Shop Freunden empfehlen,
• Online-Content-Creatorn,
• Bloggern und Herausgebern,
• Fachleuten und Beratern,
• Implementierungspartnern,
• Softwarehäusern und Agenturen,
• Resellern und B2B-Vertriebspartnern,
• Markenbotschaftern und Communities.

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,
• wird der Status der Bewerbung auf Pending,
• kann der Administrator eine Benachrichtigung über die neue Bewerbung erhalten,
• kann der Kunde eine Bestätigung über den Eingang der Bewerbung erhalten.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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.

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 Kundenliste und Kundenbearbeitung erscheinen Affiliate-Daten wie:

• Programmteilnahme,
• Affiliate-Status,
• Affiliate-Guthaben,
• Empfehlungscode,
• Rabattprozentsatz des Affiliate-Gutscheins.

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.

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.

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.

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.

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.

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.

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.

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.

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.

Kowal_Affiliate ist ein umfangreiches Affiliate-Modul für Magento 2, mit dem Sie ein vollständiges Partnerprogramm im eigenen Shop anbieten und betreiben. Es verbindet klassische Affiliate-Links, Empfehlungscodes, Rabattgutscheine, Provisionen, Auszahlungen, grundlegende Betrugsprävention, Berichte und ein modernes Partnerpanel.

Aus Vertriebssicht bietet es eine vollständige Partnerebene für Magento 2, die Sie anbieten können als:

• eigenständiges Modul,
• Bestandteil einer Shopimplementierung,
• Teil eines Growth-/Performance-Pakets,
• Grundlage für ein erweitertes Partner- und Markenbotschafterprogramm.

Die Lösung erfüllt praktische Shopanforderungen an:

• ein Affiliate-Programm in Magento 2,
• Partner-Rabattcodes,
• Provisionsabrechnung,
• ein Partnerpanel,
• Verkaufs- und Produktivbetriebsbereitschaft.

Die Provision basiert auf dem Bestellsubtotal. Der Satz des Affiliate-Kontos hat Vorrang vor dem Programmstandard. Partner-Gutscheinrabatt und Provisionsprozentsatz sind getrennte Einstellungen.

Standardmäßig gelten 30 Tage Cookie-Dauer, 10 % Provision, 14 Tage Hold Period und eine Auszahlungsschwelle von 100. Legen Sie vor dem Start eigene Regeln, Währung und Rückgabebearbeitung fest.

Ein Ledger erfasst Guthabenänderungen. Neben Auszahlungen kann das Guthaben als fester Warenkorbrabatt verwendet werden, mit Betragslimits, Teilnutzungsregeln und Kombination mit Gutscheinen.

Standardmodus ist payout_only. Eine Auszahlungsanfrage reserviert die entsprechenden Provisionen; die Markierung paid bestätigt den Workflow-Schritt, führt aber selbst keine Bank- oder Zahlungsanbieterüberweisung aus.

Stores → Configuration → Affiliate Program umfasst Programm, Provisionen, Auszahlungen, Settlement, Portal, Benachrichtigungen, Betrugsprävention, KI und Berichte. Die Installation kann die CMS-Seite affiliate-program ergänzen, ohne eine vorhandene Seite dieser Kennung zu überschreiben.

KI ist standardmäßig deaktiviert. Assistent, HTML-Banner und wöchentliche Insights erfordern passende Konfiguration; Produktwissen nutzt einen bestehenden Vector Store, den das Modul nicht selbst synchronisiert.

Paket kowal/module-affiliate, Modul Kowal_Affiliate. Nachdem Sie den Zugriff auf das Kowal-Repository konfiguriert haben, installieren Sie das Paket, aktivieren das Modul, aktualisieren Magento und leeren den Cache. Berücksichtigen Sie in der Produktionsumgebung die Kompilierung und Bereitstellung statischer Inhalte gemäß dem Bereitstellungsprozess des Shops.

1. Partner aufnehmen
Die Bewerbung wird freigegeben und erhält einen Empfehlungscode.

2. Verkäufe zuordnen
Link oder Gutschein verbindet die Bestellung mit dem Affiliate.

3. Ergebnisse abrechnen
Provisionen durchlaufen Wartezeit und Auszahlungsbearbeitung.

Der Partner teilt seinen Link und Gutschein. Der Kunde erhält den konfigurierten Rabatt, und die Bestellung wird dem Partner zugeordnet.

Nach Prüfung und Hold Period kann das freigegebene Guthaben für eine Auszahlung qualifiziert sein. Den tatsächlichen Geldtransfer organisieren Sie im Abrechnungsprozess des Unternehmens.