Währungen (Currencies)
Eine Währung ist die „Punkte-Einheit" des Reward-Systems — die Grundlage, auf der Kampagnen belohnen und der Shop bepreist wird. CAMPUS modelliert Währungen bewusst wie echtes Geld: mit Einheiten, Symbol und optionaler Kaufkraft.
Warum & was
Ohne Währung keine sammelbaren Punkte. Sie legen fest, womit gerechnet wird — z. B. „Lernpunkte" (LP) oder „Coins". Es kann mehrere Währungen geben, jede mit eigenem Zweck.
Die Felder einer Währung
| Feld | Bedeutung |
|---|---|
| Code | Kurzkennung (z. B. LP) — eindeutig, technisch. |
| Langname / Kurzname | Anzeigenamen (z. B. „Lernpunkte" / „LP"). |
| Haupteinheit (Name/Kürzel/Symbol) | Wie 1 Einheit heißt und aussieht (z. B. Symbol ★). |
| Untereinheit-Teilung | Feinerer Bruchteil, ähnlich „Cent" (optional). |
Kaufkraft (hasPurchasingPower) | Ob man mit dieser Währung im Shop einlösen kann. |
| Beschreibung | Wofür die Währung gedacht ist. |
So legen Sie eine Währung an
- Öffnen⚙ → Reward System → Currencies.
- NeuWährung anlegen: Code, Lang-/Kurzname vergeben.
- Einheit definierenName, Kürzel und Symbol der Haupteinheit; bei Bedarf Untereinheit.
- Kaufkraft entscheidenAktivieren, wenn im Shop damit eingelöst werden soll.
- SpeichernDie Währung steht Kampagnen und Shop nun zur Verfügung.
Manuell gutschreiben (Eingriff)
Für Korrekturen oder Sonderfälle können Sie einer Person Punkte von Hand geben:
- Punkte gutschreiben: API
addFundsToAccountbzw.grantCurrency. - Immer mit Grund dokumentieren — wegen Fairness und Nachvollziehbarkeit.
Überwachen
Jede Währung hat ein Hauptkonto (mainAccount) als Gesamtsicht; Kontostände je Nutzer ergeben sich aus den Kampagnen-Transaktionen. Für Reports die API nutzen.
Worauf achten
- Wenige Währungen — je mehr, desto verwirrender.
- Kaufkraft nur, wenn es auch einen Shop gibt.
- Symbol/Name konsistent über alle Oberflächen halten.
Troubleshooting
Im Shop lässt sich nicht mit der Währung zahlen.
Prüfen Sie hasPurchasingPower — ohne Kaufkraft ist die Währung reine „Anerkennung", kein Zahlungsmittel.
Punkte fehlen einem Nutzer.
Meist eine Kampagnen-Regel; als Sofortlösung manuell gutschreiben (siehe oben).
Verwandtes
Weiter: Badges.
Currencies
A currency is the “points unit” of the reward system — the basis on which campaigns reward and the shop is priced. CAMPUS deliberately models currencies like real money: with units, a symbol and optional purchasing power.
Why & what
No currency, no collectable points. You define what is being counted — e.g. “learning points” (LP) or “coins”. There can be several currencies, each with its own purpose.
The fields of a currency
| Field | Meaning |
|---|---|
| Code | Short identifier (e.g. LP) — unique, technical. |
| Long name / short name | Display names (e.g. “Learning points” / “LP”). |
| Main unit (name/abbreviation/symbol) | What 1 unit is called and looks like (e.g. symbol ★). |
| Sub-unit division | A finer fraction, similar to “cents” (optional). |
Purchasing power (hasPurchasingPower) | Whether this currency can be redeemed in the shop. |
| Description | What the currency is intended for. |
How to create a currency
- Open⚙ → Reward System → Currencies.
- NewCreate a currency: assign a code, long/short name.
- Define the unitName, abbreviation and symbol of the main unit; a sub-unit if needed.
- Decide on purchasing powerEnable it if it should be redeemable in the shop.
- SaveThe currency is now available to campaigns and the shop.
Crediting manually (intervention)
For corrections or special cases you can give a person points by hand:
- Credit points: API
addFundsToAccountorgrantCurrency. - Always document a reason — for fairness and traceability.
Monitoring
Each currency has a main account (mainAccount) as an overall view; per-user balances result from the campaign transactions. Use the API for reports.
What to watch
- Few currencies — the more there are, the more confusing.
- Purchasing power only if there is also a shop.
- Keep symbol/name consistent across all surfaces.
Troubleshooting
The currency cannot be used to pay in the shop.
Check hasPurchasingPower — without purchasing power the currency is pure “recognition”, not a means of payment.
Points are missing for a user.
Usually a campaign rule; as an immediate fix, credit manually (see above).
Related
Next: Badges.