Affiliate program

Das Modul des Affiliate-Programms ermöglicht es Ihnen, ein Empfehlungsprogramm im Shop zu betreiben. Affiliates teilen Empfehlungslinks, und das Plugin verfolgt Conversions und berechnet Provisionen.

Funktionsweise

1. Ein Kunde registriert sich im Bereich “Mein Konto” als Affiliate
2. Der Administrator aktiviert das Affiliate-Konto
3. Der Affiliate erhält ein eindeutiges Token und einen Empfehlungslink
4. Der Affiliate teilt den Link (z. B. in sozialen Medien, auf einem Blog)
5. Ein Besucher klickt auf den Link - das Token wird in einem Cookie gespeichert
6. Der Besucher gibt eine Bestellung auf - das Plugin verknüpft die Bestellung mit dem Affiliate
7. Nach Bezahlung der Bestellung berechnet das Plugin die Provision

Konfiguration

Gehen Sie zu WooCommerce > Einstellungen > Polski > PRO-Module > Affiliate-Programm.

Das Modul wird über folgende Option gesteuert:

polski_affiliates

Allgemeine Einstellungen

Einstellung	Beschreibung
Affiliate-Programm aktivieren	Aktiviert das Modul
Provisionssatz (%)	Prozentuale Provision auf den Bestellwert (Standard 10 %)
Provisionsbasis	Nettobetrag / Bruttobetrag / Nettobetrag ohne Versand
Cookie-Dauer (Tage)	Wie viele Tage das Token-Cookie gültig ist (Standard 30)
Automatische Aktivierung	Neue Affiliates automatisch aktivieren (Standard: deaktiviert)
Mindestauszahlung	Mindestprovisionsbetrag für die Auszahlung
URL-Parameter	Name des Parameters im Empfehlungslink (Standard poleca)

Provisionssätze pro Produkt

Zusätzlich zum globalen Provisionssatz kann der Administrator einen individuellen Satz für ein bestimmtes Produkt festlegen. Im Produkteditor unter dem Abschnitt “Affiliate-Programm”:

• Provisionssatz (%) - überschreibt den globalen Satz
• Vom Programm ausschließen - das Produkt generiert keine Provisionen

Provisionssätze pro Kategorie werden ebenfalls unterstützt - eine Einstellung auf einer Kategorie gilt für alle Produkte in dieser Kategorie, sofern ein Produkt keinen eigenen Satz hat.

Empfehlungslinks

Linkformat

Der Empfehlungslink enthält einen URL-Parameter mit dem Affiliate-Token:

https://example.com/?poleca=abc123def456

Der Parameter poleca ist konfigurierbar. Das Token ist eine eindeutige Affiliate-Kennung, die bei der Registrierung generiert wird.

Cookie-Tracking

Nach dem Klick auf einen Empfehlungslink setzt das Plugin ein Cookie:

Parameter	Wert
Cookie-Name	polski_affiliate_token
Wert	Affiliate-Token
Lebensdauer	Konfigurierbar (Standard 30 Tage)
Pfad	/
SameSite	Lax

Das Cookie wird serverseitig (PHP) mit dem Flag HttpOnly gesetzt. Bei nachfolgenden Besuchen prüft das Plugin das Cookie und verknüpft jede Bestellung mit dem Affiliate.

Bestellungszuordnung

Das Plugin verwendet ein “Last Click”-Attributionsmodell - hat ein Kunde auf Links mehrerer Affiliates geklickt, geht die Provision an den letzten. Das Cookie wird bei jedem neuen Linkklick überschrieben.

Affiliate-Registrierung und -Aktivierung

Registrierung

Ein Kunde kann sich im Bereich “Mein Konto” unter /moje-konto/polski-affiliates/ als Affiliate registrieren. Das Registrierungsformular enthält:

• Vor- und Nachname (automatisch aus dem Konto übernommen)
• Zahlungsmethode für die Provision (Banküberweisung / Rabattcode)
• Bankkontonummer (für Banküberweisung)
• Zustimmung zu den Bedingungen des Affiliate-Programms

Aktivierung

Standardmäßig erfordern neue Affiliate-Konten eine manuelle Aktivierung durch den Administrator. Der Administrator erhält eine E-Mail-Benachrichtigung über eine neue Registrierung und kann:

• das Konto im Bereich WooCommerce > Affiliates aktivieren
• die Registrierung mit einer Begründung ablehnen

Optional lässt sich die automatische Aktivierung einschalten - neue Konten werden unmittelbar nach der Registrierung aktiv.

Affiliate-Status

Status	Beschreibung
Pending	Wartet auf Aktivierung
Active	Aktiv - kann Links generieren und Provisionen verdienen
Suspended	Vom Administrator gesperrt
Rejected	Abgelehnt - Registrierung verweigert

Provisions-Tracking

Provisionsberechnung

Provisionen werden automatisch berechnet, nachdem eine bezahlte Bestellung mit einem Affiliate verknüpft wurde. Für folgende Fälle werden keine Provisionen berechnet:

• stornierte oder erstattete Bestellungen
• Bestellungen, die vom Affiliate selbst aufgegeben wurden (Self-Referral)
• vom Programm ausgeschlossene Produkte

Provisionsstatus

Status	Beschreibung
Pending	Berechnet, wartet auf Genehmigung
Approved	Genehmigt, bereit zur Auszahlung
Paid	Ausgezahlt
Rejected	Abgelehnt (z. B. Bestellung erstattet)

Automatische Genehmigung

Provisionen wechseln nach einem konfigurierbaren Zeitraum (Standard 14 Tage) vom Status “Pending” zu “Approved”. Die Verzögerung schützt vor Provisionen aus Bestellungen, die möglicherweise erstattet werden.

Wird eine Bestellung während der Wartezeit storniert oder erstattet, wird die Provision automatisch abgelehnt.

Bereich “Mein Konto”

Das Modul fügt dem Bereich “Mein Konto” einen Endpunkt /polski-affiliates hinzu. Der Endpunkt ist unter folgender Adresse verfügbar:

/moje-konto/polski-affiliates/

Affiliate-Dashboard

Nach der Kontoaktivierung sieht der Affiliate ein Dashboard mit:

• Statistiken - Gesamtklicks, Bestellungen, Provisionen
• Empfehlungslink - vollständiger Link mit Kopier-Schaltfläche
• Provisionen - Liste der Provisionen mit Daten, Beträgen und Status
• Auszahlungen - Auszahlungsverlauf
• Monatsstatistiken - Diagramm der Klicks und Conversions

Linkgenerierung

Der Affiliate kann einen Empfehlungslink erstellen zu:

• der Startseite des Shops
• einem bestimmten Produkt
• einer Produktkategorie
• einer beliebigen Seite innerhalb der Shop-Domain

Jeder Link enthält den Parameter poleca mit dem Affiliate-Token.

Administrationsbereich

Affiliate-Liste

Gehen Sie zu WooCommerce > Affiliates. Die Tabelle enthält:

• Vor- und Nachname
• E-Mail
• Status
• Registrierungsdatum
• Anzahl der Empfehlungen
• Gesamtprovision
• Auszahlungssaldo

Provisionsverwaltung

Gehen Sie zu WooCommerce > Affiliates > Provisionen. Der Administrator kann:

• die Provisionsliste mit Filtern durchsuchen (Affiliate, Status, Datum)
• Provisionen genehmigen oder ablehnen
• Provisionen als ausgezahlt markieren
• Provisionen als CSV exportieren

Bericht

Gehen Sie zu WooCommerce > Affiliates > Bericht. Der Bericht enthält:

• Gesamtwert der empfohlenen Bestellungen
• Gesamtprovisionsbetrag
• Conversion-Rate (Klicks -> Bestellungen)
• Top 10 Affiliates
• Monatlicher Trend

Hooks

polski_pro/affiliate/commission_created

Aktion, die nach der Berechnung einer Provision ausgelöst wird.

/**
 * @param int   $commission_id ID prowizji
 * @param int   $affiliate_id  ID afilianta
 * @param int   $order_id      ID zamówienia
 * @param float $amount        Kwota prowizji
 */
do_action('polski_pro/affiliate/commission_created', int $commission_id, int $affiliate_id, int $order_id, float $amount);

Beispiel:

add_action('polski_pro/affiliate/commission_created', function (int $commission_id, int $affiliate_id, int $order_id, float $amount): void {
    // Powiadomienie afilianta o nowej prowizji
    $affiliate = get_userdata($affiliate_id);
    wp_mail(
        $affiliate->user_email,
        'Nowa prowizja w programie afiliacyjnym',
        sprintf(
            'Otrzymałeś prowizję %.2f zł za zamówienie #%d.',
            $amount,
            $order_id
        )
    );
}, 10, 4);

polski_pro/affiliate/registered

Aktion, die nach der Registrierung eines neuen Affiliates ausgelöst wird.

/**
 * @param int $user_id ID użytkownika
 * @param string $token Wygenerowany token afilianta
 */
do_action('polski_pro/affiliate/registered', int $user_id, string $token);

Beispiel:

add_action('polski_pro/affiliate/registered', function (int $user_id, string $token): void {
    // Przypisanie roli WordPress
    $user = get_userdata($user_id);
    $user->add_role('affiliate');
}, 10, 2);

polski_pro/affiliate/validate_referral

Filtert die Empfehlungsvalidierung vor der Provisionsberechnung.

/**
 * @param bool $is_valid     Czy polecenie jest prawidłowe
 * @param int  $affiliate_id ID afilianta
 * @param int  $order_id     ID zamówienia
 */
apply_filters('polski_pro/affiliate/validate_referral', bool $is_valid, int $affiliate_id, int $order_id): bool;

Beispiel:

add_filter('polski_pro/affiliate/validate_referral', function (bool $is_valid, int $affiliate_id, int $order_id): bool {
    $order = wc_get_order($order_id);

    // Blokowanie self-referral po adresie e-mail
    $affiliate_email = get_userdata($affiliate_id)->user_email;
    if ($order->get_billing_email() === $affiliate_email) {
        return false;
    }

    return $is_valid;
}, 10, 3);

Häufige Probleme

Die Provision wird nicht berechnet

1. Prüfen Sie, ob der Affiliate den Status “Active” hat
2. Überprüfen Sie, ob das Cookie polski_affiliate_token gesetzt ist (Entwicklertools des Browsers)
3. Prüfen Sie, ob die Bestellung nicht vom Affiliate selbst aufgegeben wurde
4. Überprüfen Sie, ob die Produkte in der Bestellung nicht vom Programm ausgeschlossen sind

Das Cookie wird nach dem Klick auf den Link nicht gesetzt

1. Prüfen Sie, ob der URL-Parameter korrekt ist (Standard poleca)
2. Überprüfen Sie, ob das Affiliate-Token existiert und aktiv ist
3. Prüfen Sie, ob Caching-Plugins die Seite mit URL-Parametern cachen - fügen Sie den Parameter poleca zur Ausschlussliste des Caches hinzu

Der Affiliate sieht den Bereich in “Mein Konto” nicht

1. Prüfen Sie, ob das Affiliate-Modul aktiviert ist
2. Gehen Sie zu Einstellungen > Permalinks und klicken Sie auf “Speichern” (aktualisiert die Rewrite-Regeln)
3. Überprüfen Sie, ob der Endpunkt polski-affiliates registriert ist

Verwandte Ressourcen

• PRO-Überblick
• Ein Problem melden

Diese Seite dient nur zu Informationszwecken und stellt keine Rechtsberatung dar. Konsultieren Sie vor der Umsetzung einen Anwalt. Polski for WooCommerce ist Open-Source-Software (GPLv2), die ohne Gewährleistung bereitgestellt wird.