10 — Kampagnen verwalten
Aktualisiert am 1. Juni 2026
10 — Kampagnen verwalten
Eine Kampagne ist der Container für ein Affiliate-Programm: sie legt fest, wie Klicks und Conversions zugeordnet werden, welche Provisionsregeln gelten und wie viele MLM-Ebenen ausgeschüttet werden.
Wozu Kampagnen?
Sie können beliebig viele Kampagnen pro Tenant anlegen — z. B.:
- Eine Hauptkampagne für Ihr Standard-Produkt.
- Eine Sonderkampagne für ein zeitlich begrenztes Promo-Programm mit höheren Provisionen.
- Eine Lead-Kampagne, die nur 0-EUR-Conversions (Email-Anmeldungen) trackt.
Pro Webhook-Sale wird automatisch die passende Kampagne zugewiesen (über den campaignSlug aus dem Webhook-Body oder als Fallback die erste aktive Kampagne).
Anlegen & Bearbeiten
Admin-Portal → „Kampagnen" → „Neu anlegen".
Pflichtfelder
| Feld | Bedeutung |
|---|---|
| Name | Display-Name (z. B. „Sommer-Promo 2026") |
| Slug | URL-freundlicher Identifier (z. B. sommer-promo-2026), eindeutig pro Tenant |
| Status | active oder paused |
Wichtige Optionen
| Feld | Default | Bedeutung |
|---|---|---|
| Attribution-Modell | last_click |
Wer bekommt die Provision? Siehe 51 — Attribution |
| Cookie-Lifetime | 30 Tage | Wie lange ist ein Klick als Conversion-Kandidat gültig |
| Commission Levels | 1 (kein MLM) | Maximale MLM-Tiefe — bis zu 10 |
allow_partner_change |
true |
Darf ein einmal zugewiesener Customer den Partner wechseln |
lead_bonus_amount |
0,00 € | Bonus für Lead-only Conversions (siehe 103) |
Attribution-Modelle
| Modell | Bedeutung |
|---|---|
last_click |
Der letzte Partner-Klick vor der Conversion bekommt die Provision. Standard. |
first_click |
Der erste Klick wird belohnt. Branding-fokussiert. |
In beiden Fällen gilt zusätzlich der Customer-Lock: wenn ein Customer bereits einmal zugeordnet ist und entweder lifetime-Zuweisung oder die Kampagne allow_partner_change=false hat, gewinnt die bestehende Zuordnung.
Details: 51 — Attribution-Modelle.
Provisionsstufen (Tiers)
Pro Kampagne und Level definieren Sie genau einen CommissionTier. Damit legen Sie fest, wie viel Provision in Prozent oder als Fixbetrag pro Sale gezahlt wird.
Beispiel für eine 3-Level-MLM-Kampagne:
| Level | Tier-Typ | Wert |
|---|---|---|
| 1 (Direkt-Partner) | percentage |
20 % |
| 2 (Sponsor) | percentage |
5 % |
| 3 (Sponsor-Sponsor) | percentage |
2 % |
Bei einem Netto-Verkauf von 100 € fließen damit insgesamt 27 € an drei verschiedene Partner.
Details + Hybrid-Tarife + Volumen-Staffel: 11 — Provisionsmodelle.
CommissionGroups (Erweiterung)
Sie können Partnern verschiedene Tarife zuweisen, ohne mehrere Kampagnen anlegen zu müssen — über CommissionGroups:
- Eine Kampagne enthält N Gruppen.
- Eine Gruppe hat ihre eigene Tier-Liste (Level 1, 2, …).
- Jeder Partner gehört zu einer Gruppe.
Beispiel:
- Kampagne „Hauptprogramm".
- Gruppe „Premium" (Premium-Partner): L1 30 %, L2 10 %.
- Gruppe „Standard": L1 20 %, L2 5 %.
- Gruppe „Affiliate" (extern): L1 15 %, L2 3 %.
Jede Gruppe hat zusätzlich eine eigene Cookie-Lifetime und Priorität.
Details: 11 — Provisionsmodelle.
Kampagnen-Statistiken
Auf der Detail-Ansicht jeder Kampagne sehen Sie:
- Klicks und Conversion-Rate.
- Umsatz und Provisionssumme.
- Top-Partner für diese Kampagne.
Aggregiert über alle Kampagnen: 101 — Erweiterte Statistiken.
Was eine Kampagne nicht tut
- Sie ist nicht an einen bestimmten Payment-Provider gebunden. Mehrere Provider können in derselben Kampagne Sales melden.
- Sie ist nicht sichtbar für Partner unter dem Namen — Partner sehen ihre Tracking-Links und Werbemittel, die intern an Kampagnen hängen.
Verwandte Kapitel
Technische Tiefen-Doku: ../005-campaign-management.md, ../076-pap-import-commission-groups.md (CommissionGroups)