Kampagnen
Die Kampagne ist der Motor des Reward-Systems: Sie legt per Regeln fest, welches Verhalten wie viele Punkte bringt — in einem Zeitraum, für eine Zielgruppe, optional mit Rangliste. Hier steuern Sie Motivation gezielt.
Warum & was
Ohne Kampagne gibt es keine automatische Punktevergabe. Die Kampagne verbindet Ereignis (z. B. „Kurs abgeschlossen") mit Belohnung (Punkte einer Währung) — und rahmt das Ganze zeitlich und thematisch ein.
Die Felder einer Kampagne
| Feld | Bedeutung |
|---|---|
| Name / Beschreibung | Worum es geht. |
| Start-/Endzeit | Gültigkeitszeitraum. |
Regeln (rules) | Welches Ereignis wie viele Punkte gibt — das Herz der Kampagne. |
Gruppe (group) | Für wen die Kampagne gilt (Zielgruppe). |
| Leagues | Ranglisten/Ligen — für Wettbewerb (optional). |
| rewardsExpireInDays | Nach wie vielen Tagen Punkte verfallen (optional). |
| Status / sichtbar | Aktiv/inaktiv und ob für Nutzer sichtbar. |
| manualTransactions | Von Hand gebuchte Transaktionen (Eingriffe). |
Transfer-Kampagne: eine Sonderform (API: createTransferCampaign) zum Übertragen/Umbuchen von Punkten.
So legen Sie eine Kampagne an
- Öffnen⚙ → Reward System → Campaigns → neu.
- RahmenName, Beschreibung, Start-/Endzeit und Zielgruppe (Gruppe) setzen.
- Regeln definierenEreignis → Punkte (z. B. „Kurs abgeschlossen = 10 LP").
- OptionenBei Bedarf Leagues (Rangliste) und Ablauf (rewardsExpireInDays) aktivieren.
- Aktivieren & testenMit Testkonto prüfen, ob Punkte korrekt fließen.
Manuell eingreifen
Über manuelle Transaktionen buchen Sie Punkte gezielt (Korrektur, Sonderaktion). Grund dokumentieren. Verwandt: Punkte direkt gutschreiben (addFundsToAccount).
Überwachen & Reporting
Öffnen Sie die Kampagne für Verlauf und Teilnahme; je Nutzer liefert die API userCampaigns Stand und Historie. Leagues zeigen die Rangliste. Für Gesamtauswertungen die Auswertungen bzw. API.
Worauf achten
- Regeln auf Ergebnisse (abgeschlossen/bestanden), nicht auf bloße Klicks.
- Zeitraum & Zielgruppe bewusst wählen — sonst laufen Kampagnen ins Leere.
- Ranglisten mit Fingerspitzengefühl — Wettbewerb motiviert nicht jede/n; Datenschutz beachten.
- Ablauf kommunizieren, wenn Punkte verfallen.
Troubleshooting
Es werden keine Punkte vergeben.
Läuft die Kampagne (Zeitraum/Status aktiv)? Ist der Nutzer in der Zielgruppe? Passt die Regel zum Ereignis?
Die Rangliste stimmt nicht.
Prüfen Sie League-Konfiguration und ob alle relevanten Transaktionen erfasst wurden.
Verwandtes
- Reward-System (Übersicht) · Währungen · Shop
- Audiences als Zielgruppen
Weiter: Shop & Einlösen.
Campaigns
The campaign is the engine of the reward system: it defines via rules which behaviour earns how many points — within a period, for an audience, optionally with a leaderboard. This is where you steer motivation deliberately.
Why & what
Without a campaign there is no automatic granting of points. The campaign links an event (e.g. “course completed”) with a reward (points of a currency) — and frames the whole thing in time and topic.
The fields of a campaign
| Field | Meaning |
|---|---|
| Name / description | What it is about. |
| Start/end time | Validity period. |
Rules (rules) | Which event earns how many points — the heart of the campaign. |
Group (group) | Who the campaign applies to (audience). |
| Leagues | Leaderboards/leagues — for competition (optional). |
| rewardsExpireInDays | After how many days points expire (optional). |
| Status / visible | Active/inactive and whether visible to users. |
| manualTransactions | Manually booked transactions (interventions). |
Transfer campaign: a special form (API: createTransferCampaign) for transferring/rebooking points.
How to create a campaign
- Open⚙ → Reward System → Campaigns → new.
- FrameSet name, description, start/end time and audience (group).
- Define rulesEvent → points (e.g. “course completed = 10 LP”).
- OptionsEnable leagues (leaderboard) and expiry (rewardsExpireInDays) if needed.
- Activate & testUse a test account to check that points flow correctly.
Intervening manually
Via manual transactions you book points deliberately (correction, special action). Document the reason. Related: credit points directly (addFundsToAccount).
Monitoring & reporting
Open the campaign for history and participation; per user the API userCampaigns provides status and history. Leagues show the leaderboard. For overall analytics use the analytics or the API.
What to watch
- Rules on results (completed/passed), not on mere clicks.
- Choose period & audience deliberately — otherwise campaigns fall flat.
- Leaderboards with sensitivity — competition does not motivate everyone; mind data protection.
- Communicate expiry when points expire.
Troubleshooting
No points are being granted.
Is the campaign running (period/status active)? Is the user in the audience? Does the rule match the event?
The leaderboard is wrong.
Check the league configuration and whether all relevant transactions were captured.
Related
- Reward system (overview) · Currencies · Shop
- Audiences as target groups
Next: Shop & redeeming.