DataFirefly Affiliate Program: Partnerprogramm für PrestaShop

Installation

Installieren Sie das Modul über Module > Modulverwaltung > Modul hochladen, indem Sie die ZIP-Datei senden, oder kopieren Sie den Ordner dfaffiliate in das Verzeichnis /modules/ Ihres Shops und klicken Sie auf Installieren.

Bei der Installation legt das Modul seine Tabellen an, speichert die Standardeinstellungen und fügt unter Verkaufen ein Menü Affiliation mit fünf Einträgen hinzu: Affiliates, Provisionen, Abrechnungen und Auszahlungen, Provisionsregeln und Einstellungen. Die Schaltfläche Konfigurieren in der Modulverwaltung öffnet die Einstellungsseite, die mit einer Programmübersicht beginnt.

Für das Update von 1.0.0 auf 1.1.0 laden Sie einfach die neue ZIP-Datei hoch: Das Update-Skript ergänzt die neuen Einstellungen und Hooks, ohne bestehende Affiliates, Provisionen oder Abrechnungen zu verändern.

Erste Einstellungen

Prüfen Sie mindestens diese Punkte, bevor Sie die ersten Affiliates einladen:

• Standard-Provisionswert: 10 % der Produkte netto nach der Installation, oder ein Festbetrag pro Bestellung.
• Cookie-Laufzeit: standardmäßig 30 Tage, der Zeitraum zwischen Klick und Bestellung.
• Provision freigeben bei und Provision ablehnen bei: die Bestellstatus, die die Zahlung bestätigen, und die, die stornieren (storniert, erstattet, Zahlungsfehler).
• Wartezeit: standardmäßig 30 Tage. Eine freigegebene Provision kommt erst nach dieser Frist in eine Abrechnung, um Retouren abzudecken.
• Mindestauszahlung: darunter wird der Saldo in den Folgemonat vorgetragen.
• Firmenname, IBAN und BIC: erforderlich für die SEPA-Überweisungsdatei.

Tracking und Zuordnung

Tracking-Links

Jeder Affiliate hat einen Code. Zwei Arten von Links tragen ihn:

• der Tracking-Parameter, an jede Adresse des Shops angehängt: ?aff=CODE. Der Parametername lässt sich in den Einstellungen ändern, zum Beispiel in ref;
• Kurzlinks, die der Affiliate in seinem Bereich aus der Adresse eines Produkts, einer Kategorie oder einer beliebigen Seite erstellt. Sie leiten auf die gewählte Seite weiter und zählen Klicks und Bestellungen pro Link.

Beim Klick speichert ein signiertes Cookie (dfaff_ref) den Affiliate. Die Signatur verhindert, dass ein Besucher es verändert. Suchmaschinen-Bots, automatisierte Browser und eigene Klicks des Affiliates werden nicht gezählt, und derselbe Besucher zählt nur einmal pro 30 Minuten. Es wird keine IP-Adresse im Klartext gespeichert.

Reihenfolge der Zuordnung einer Bestellung

1. Der persönliche Gutscheincode eines Affiliates in der Bestellung, auch ohne Klick.
2. Der Link oder das Cookie: Der Warenkorb wird schon beim Besuch dem Affiliate zugeordnet, was auch später von der Bank bestätigte Zahlungen abdeckt.
3. Ein bereits geworbener Kunde dieses Affiliates, wenn die Einstellung Provisionen für wiederkehrende Kunden über 0 Tagen liegt.

Das Attributionsmodell entscheidet, wenn ein Besucher die Links zweier Affiliates anklickt: letzter Klick (Standard), der zuletzt besuchte Affiliate gewinnt; erster Klick, der erste behält den Verkauf bis zum Ablauf des Cookies.

Schutzmechanismen

• Ein Affiliate erhält keine Provision auf eigene Bestellungen, erkannt über Kundenkonto und E-Mail-Adresse.
• Nur Neukunden: Nur die erste Bestellung eines Kunden bringt Provision.
• Mindestbestellwert: Produkte netto nach Rabatten, 0 für kein Minimum.

Provisionen

Berechnung

Basis ist der Produktbetrag netto. Mit Rabatte abziehen werden die Gutscheine der Bestellung von der Basis abgezogen; ein Gratisversand-Gutschein verändert sie nicht. Versandkosten sind nie enthalten. Der Betrag wird in die Standardwährung des Shops umgerechnet.

Angewendet wird in dieser Reihenfolge: die eigene Provision des Affiliates, falls vorhanden, sonst der Programmsatz. Bei Prozentsätzen ersetzen Produkt- und dann Kategorieregeln den Satz Position für Position. Bei einem Festbetrag entsteht eine Provision pro Bestellung, und nur eine, wenn PrestaShop einen Warenkorb für mehrere Versanddienstleister in mehrere Bestellungen aufteilt.

Regeln pro Kategorie und Produkt

Der Tab Provisionsregeln legt einen Prozentsatz für eine Kategorie oder ein Produkt fest, zum Beispiel 3 % auf Elektronik und 15 % auf Zubehör. Eine Produktregel hat Vorrang vor einer Kategorieregel. Bei Kategorien prüft das Modul zuerst die Standardkategorie des Produkts, dann die beste seiner weiteren Kategorien. Ein Satz von 0 schließt die Produkte von Provisionen aus. Regeln gelten nur für prozentuale Provisionen.

Lebenszyklus

• Bei der Bestellung wird die Provision als Ausstehend angelegt.
• Erreicht die Bestellung einen Freigabestatus, wird sie Freigegeben, und das Freigabedatum startet die Wartezeit.
• Wechselt die Bestellung in einen Stornostatus, wird sie Abgelehnt.
• Eine Teilgutschrift reduziert die Provision im Verhältnis zum erstatteten Produktbetrag.
• Steht die Provision bereits in einer Abrechnung oder ist bezahlt, ändert das Modul sie nicht mehr: Es legt eine negative Korrektur an, die ohne Wartezeit von der nächsten Abrechnung abgezogen wird. Ein zweiter Stornostatus derselben Bestellung erzeugt keinen weiteren Abzug.

Manuelle Provisionen

Im Tab Provisionen schreibt Manuelle Provision hinzufügen einem Affiliate einen Betrag gut oder belastet ihn (negativer Betrag für einen Abzug), mit einer im Affiliate-Bereich sichtbaren Notiz. Diese Zeilen folgen demselben Abrechnungszyklus wie Bestellprovisionen.

Affiliates

Bewerbungen

Die öffentliche Programmseite zeigt Ihre Konditionen (Satz, Cookie-Dauer, Mindestauszahlung), drei Schritte und FAQ, die aus Ihren Einstellungen erzeugt werden. Der Präsentationstext wird in den Einstellungen für jede Sprache bearbeitet. Wählen Sie eine CMS-Seite mit den Programmbedingungen, müssen Bewerber sie akzeptieren.

Bewerber müssen in einem Kundenkonto angemeldet sein. Sie geben an, wo sie veröffentlichen, beschreiben ihre Zielgruppe und optional ihre Firma. Standardmäßig wartet jede Bewerbung auf Ihre Freigabe und die Benachrichtigungs-E-Mail erhält eine Nachricht. Mit Bewerbungen automatisch freigeben ist das Konto sofort aktiv.

Affiliate-Datensatz

Der Datensatz beginnt mit einer Übersicht (Klicks, Bestellungen, ausstehende, fällige und bezahlte Provisionen) und dem Tracking-Link zum Kopieren, gefolgt von drei Blöcken:

• Identität und Kanal: Name, E-Mail, Website, Zielgruppe, Status und interne Notiz. Der Wechsel auf Freigegeben sendet die E-Mail „Ihr Affiliate-Konto ist aktiv“.
• Tracking und Provision: Affiliate-Code, eigene Provision, eigene Cookie-Dauer, persönlicher Gutscheincode. Existiert der Code noch nicht und Sie geben einen Rabatt in Prozent an, wird die Warenkorbregel automatisch angelegt, begrenzt auf eine Nutzung pro Kunde.
• Zahlungsdaten: SEPA-Überweisung oder PayPal, Kontoinhaber, IBAN, BIC, PayPal-E-Mail.

Sie können einen Affiliate ohne Kundenkonto anlegen: Er erhält Abrechnungen per E-Mail, hat aber keinen Online-Bereich. Nutzt ein Kundenkonto dieselbe E-Mail-Adresse, wird es automatisch verknüpft.

Ein Affiliate mit offenen Provisionen oder einer unbezahlten Abrechnung kann nicht gelöscht werden: Sperren Sie ihn oder begleichen Sie zuerst den Saldo.

Was der Affiliate sieht

• Mein Konto: eine Kachel „Affiliate-Bereich“, oder „Affiliate werden“ für Kunden, die es noch nicht sind.
• Übersicht: Link-Generator, Kennzahlenleiste (Klicks, Bestellungen, Konversion, ausstehend, freigegeben, bezahlt), Diagramm der letzten 30 Tage, Konditionen und neueste Links.
• Meine Links: alle Kurzlinks mit Klicks, Bestellungen, Kopieren und Löschen.
• Provisionen: Datum, maskierte Bestellreferenz, Quelle, Basis, Provision, Status, Filter nach Status und voraussichtlicher Auszahlungsmonat. Es werden keine Kundendaten angezeigt.
• Abrechnungen: eine Abrechnung pro Monat, einsehbar und als PDF druckbar.
• Zahlungsdaten: Wahl zwischen Überweisung und PayPal, IBAN über die Prüfziffer geprüft und maskiert angezeigt. Ein Punkt und ein Hinweis melden fehlende Angaben.
• Produktseite: Ein Kasten „Ihr Affiliate-Link“, nur für den angemeldeten Affiliate sichtbar, zeigt den Produktlink und den Provisionssatz dafür.

Abrechnungen und Auszahlungen

Abrechnungen erstellen

Eine Abrechnung fasst für einen Affiliate und einen Monat die freigegebenen Provisionen zusammen, die vor Monatsende entstanden sind und deren Wartezeit abgelaufen ist, dazu negative Korrekturen. Liegt die Summe unter der Mindestauszahlung, wird nichts erstellt und der Saldo vorgetragen.

Zwei Wege, Abrechnungen zu erstellen:

• Abrechnungen und Auszahlungen > Monatsabrechnungen erstellen: Monat wählen, Beträge pro Affiliate in der Vorschau prüfen, dann Abrechnungen erstellen und E-Mails senden.
• Die Cron-URL aus der Übersicht der Einstellungen. Rufen Sie sie einmal täglich auf: Zwischen dem 1. und 5. des Monats erstellt sie die Abrechnungen des Vormonats. Hängen Sie &period=JJJJ-MM an, um einen bestimmten Monat zu erzwingen. Sie ist durch ein Token geschützt.

Affiliates auszahlen

Wählen Sie in der Liste die zu zahlenden Abrechnungen aus und nutzen Sie die passende Sammelaktion:

• SEPA-Überweisungsdatei exportieren (XML): Datei pain.001.001.03 zum Import in Ihre Bank, für per Überweisung bezahlte Affiliates. Erfordert EUR als Standardwährung und die IBAN der Firma.
• PayPal-Payouts-Datei exportieren (CSV): für PayPal-Sammelzahlungen an per PayPal bezahlte Affiliates.
• Für die Buchhaltung exportieren (CSV): alle ausgewählten Abrechnungen, mit Semikolon getrennt.

Zahlungsexporte werden mit einer Meldung, die die betroffene Abrechnung nennt, verweigert, wenn eine ausgewählte Abrechnung bereits bezahlt ist oder eine IBAN fehlt oder ungültig ist: Eine unvollständige Datei ließe einen Affiliate unbezahlt, und eine bezahlte Abrechnung könnte doppelt bezahlt werden.

Nach der Überweisung markieren Sie die Abrechnungen als bezahlt, gesammelt oder in der Detailansicht mit Zahlungsreferenz und Datum. Die betroffenen Provisionen wechseln auf Bezahlt.

E-Mails

Das Modul versendet vier E-Mails, in 8 Sprachen übersetzt und in der Sprache des Empfängers verschickt, Beträge eingeschlossen:

• Neue Affiliate-Bewerbung, an die Benachrichtigungsadresse.
• Ihr Affiliate-Konto ist aktiv, mit dem Link zum Affiliate-Bereich.
• Neuer Verkauf, mit Provision, Basis und Satz, nie mit Kundendaten. Abschaltbar in den Einstellungen und von jedem Affiliate in seinen Zahlungsdaten.
• Abrechnung verfügbar, mit Betrag und Link zur Abrechnung.

Die Vorlagen liegen im Ordner mails/ des Moduls und lassen sich wie jede PrestaShop-E-Mail anpassen.

Backoffice

• Übersicht (Einstellungsseite): aktive Affiliates, offene Bewerbungen, Klicks, Bestellungen und Umsatz der letzten 30 Tage, ausstehende, fällige und bezahlte Provisionen, Top-Affiliates.
• Bestellseite: Ein Kasten zeigt Affiliate, Provision, Status und Quelle.
• CSV-Export der Affiliate- und Provisionslisten mit Rohbeträgen für die Tabellenkalkulation.

DSGVO und Kontolöschung

Das Modul meldet sich beim offiziellen DSGVO-Modul von PrestaShop an. Der Datenexport eines Kunden enthält sein Affiliate-Profil und seine Provisionen. Die Löschung anonymisiert den Affiliate (Name, E-Mail, IBAN, Website und Zielgruppe geleert, Links und Klicks gelöscht) und behält Provisionen und Abrechnungen für die Buchhaltung.

Löscht ein Mitarbeiter ein Kundenkonto, bleibt der verknüpfte Affiliate ohne Online-Konto erhalten, seine Zahlungsdaten bleiben bestehen.

Fehlerbehebung

Es werden keine Klicks gezählt

Testen Sie in einem privaten Browserfenster, ohne mit dem Konto des Affiliates angemeldet zu sein: Seine eigenen Klicks werden ignoriert. Automatisierte Browser werden als Bots gefiltert. Nutzt Ihr Shop einen Full-Page-Cache, führt eine aus dem Cache ausgelieferte Seite kein PHP aus und der Parameter ?aff= wird nicht erkannt: Verwenden Sie Kurzlinks, die immer über PrestaShop laufen, oder schließen Sie den Parameter vom Cache aus.

Eine Provision bleibt ausstehend

Prüfen Sie, ob der aktuelle Bestellstatus unter Provision freigeben bei angehakt ist. Hat ein Mitarbeiter ohne Ansichtsrecht auf das Modul (Erweiterte Einstellungen > Team > Berechtigungen) den Status geändert, hat PrestaShop das Modul nicht ausgeführt: Setzen Sie die Bestellung mit einem Administratorkonto erneut auf diesen Status.

Der Link-Generator lehnt eine Adresse ab

Der Generator akzeptiert nur Adressen Ihres Shops. Fügen Sie die vollständige Adresse aus dem Browser ein, auf der Domain des Shops.

Der SEPA-Export wird verweigert

Lesen Sie die Meldung: Sie nennt die bereits bezahlte Abrechnung oder den Affiliate ohne IBAN. Heben Sie die Auswahl auf oder ergänzen Sie die Daten. Prüfen Sie auch, ob Firmenname und Firmen-IBAN eingetragen sind.

Kompatibilität

• PrestaShop 8.0 bis 9.x, dieselbe ZIP-Datei für beide Versionen.
• Mehrsprachig und mit mehreren Währungen, Provisionen in der Standardwährung berechnet.
• Architektur ModuleAdminController, ohne Composer-Abhängigkeit.
• Modul und E-Mails übersetzt in Englisch, Französisch, Spanisch, Deutsch, Italienisch, Niederländisch, Polnisch und Portugiesisch.