Kapitel 3 · Für Admins · Reward

Shop & Einlösen

Der Shop schließt den Kreis: Was Nutzer sich mit Punkten verdient haben, lösen sie hier gegen Belohnungen ein. Ein Shop-Item verpackt eine Belohnung mit einem Preis in einer oder mehreren Währungen.

Warum & was

Punkte allein motivieren nur, wenn man etwas damit „tun" kann. Der Shop gibt ihnen Sinn: Nutzer verdienen und lösen ein. Ein Shop-Item ist die käufliche Verpackung um eine konkrete Belohnung.

Die Felder eines Shop-Items

FeldBedeutung
Belohnung (purchasableType / purchasableId)Was eingelöst wird — z. B. ein Zugang, ein Item, ein Vorteil.
Preise (shopItemPrices)Kosten in einer/mehreren Währungen (mit Kaufkraft).
OperationWas beim Kauf passiert.
AktivOb das Item aktuell einlösbar ist.
manualGiveawaysVon Hand vergebene Exemplare (Eingriffe).

So legen Sie ein Shop-Item an

So geht's konkret
  1. VoraussetzungEine Währung mit Kaufkraft muss existieren.
  2. ÖffnenReward SystemShopItem → neu.
  3. Belohnung wählenWas wird eingelöst (die „purchasable")?
  4. Preis setzenKosten je Währung festlegen.
  5. AktivierenItem sichtbar/einlösbar machen.

Manuell vergeben (Eingriff)

  • Direkt zuweisen: API grantShopItem / assignShopItems — z. B. als Sonderbelohnung ohne Punkteabzug.
  • Deaktivieren/entfernen: nicht mehr Angebotenes ausblenden (deleteShopItem).

Überwachen

Einlösungen (purchase) und manuelle Vergaben zeigen, was gefragt ist. Nutzen Sie das, um das Angebot zu steuern.

Worauf achten

  • Preis-Balance: zu teuer frustriert, zu billig entwertet die Währung.
  • Verfügbarkeit: nur einlösbar lassen, was Sie auch einlösen können/wollen.
  • Fairness: manuelle Vergaben transparent halten.

Troubleshooting

Ein Nutzer kann nicht einlösen.

Reicht der Punktestand? Hat die Währung Kaufkraft? Ist das Item aktiv?

Ein Item soll weg.

Deaktivieren (statt löschen), damit vergangene Einlösungen nachvollziehbar bleiben.

Verwandtes

👉

Zurück zur Reward-Übersicht oder weiter im Kapitel: News & Newsletter.

Chapter 3 · For admins · Reward

Shop & redeeming

The shop closes the loop: what users have earned with points they redeem here for rewards. A shop item wraps a reward with a price in one or several currencies.

Why & what

Points alone only motivate if you can “do” something with them. The shop gives them meaning: users earn and redeem. A shop item is the purchasable wrapper around a concrete reward.

The fields of a shop item

FieldMeaning
Reward (purchasableType / purchasableId)What is redeemed — e.g. an access, an item, a benefit.
Prices (shopItemPrices)Cost in one/several currencies (with purchasing power).
OperationWhat happens on purchase.
ActiveWhether the item is currently redeemable.
manualGiveawaysManually granted copies (interventions).

How to create a shop item

Step by step
  1. PrerequisiteA currency with purchasing power must exist.
  2. OpenReward SystemShopItem → new.
  3. Choose the rewardWhat is redeemed (the “purchasable”)?
  4. Set the priceDefine the cost per currency.
  5. ActivateMake the item visible/redeemable.

Granting manually (intervention)

  • Assign directly: API grantShopItem / assignShopItems — e.g. as a special reward without deducting points.
  • Deactivate/remove: hide what is no longer offered (deleteShopItem).

Monitoring

Redemptions (purchase) and manual grants show what is in demand. Use this to steer the offering.

What to watch

  • Price balance: too expensive frustrates, too cheap devalues the currency.
  • Availability: only leave redeemable what you can/want to redeem.
  • Fairness: keep manual grants transparent.

Troubleshooting

A user cannot redeem.

Is the point balance enough? Does the currency have purchasing power? Is the item active?

An item should be removed.

Deactivate (instead of delete) so that past redemptions remain traceable.

Related

👉

Back to the reward overview or continue in the chapter: News & newsletter.