Winning options and attribution slots
Connect receipt rules to rewards and optionally control their availability over time.
Winning options define what participants can unlock. Each option points to a Receipt Game Reward, carries its own quantity logic, and can optionally distribute stock through attribution slots.
What a winning option contains
In the current builder, each winning option includes:
Display NameDescriptionTotal QuantityUnused Quantity PolicyAssociated RewardAttribution Slots
Quantity strategies
| Strategy | How to configure it | Best for |
|---|---|---|
| Unlimited | Set Total Quantity to 0. | Low-risk digital or symbolic rewards. |
| Fixed stock without slot planning | Use a declared quantity only when you know how that stock should be managed. | Simple capped rewards. |
| Time-based stock release | Add Attribution Slots with start date, end date, and quantity. | Daily or hourly reward allocation. |
Unused quantity policy
The builder exposes two policies:
Block UnusedTransfer Unused
Use Transfer Unused when leftover stock from one slot should move into a later slot. Use Block Unused when each time period must keep its own hard cap.
Validation messages to watch
| Validation message | What it means |
|---|---|
Receipt game '{{touchpoint_name}}' has no winning options | No reward path exists yet. |
Receipt game '{{touchpoint_name}}' winning option '{{option_id}}' is missing a reward ID | The option is not linked to a receipt-game reward. |
Receipt game '{{touchpoint_name}}' winning option '{{option_id}}' is missing a display name | The option is not clearly identifiable in the UI. |
Receipt game '{{touchpoint_name}}' winning option '{{option_id}}' has quantity ({{declared_quantity}}) but no attribution slots | A capped stock was declared without time-based allocation. |
Receipt game '{{touchpoint_name}}' winning option '{{option_id}}' declared quantity ({{declared_quantity}}) doesn't match attribution slots total ({{slots_total}}) | The total stock and slot stock disagree. |
Receipt game '{{touchpoint_name}}' winning option '{{unreferenced_option_id}}' is not referenced by any challenge rule | The option exists, but no rule can ever unlock it. |
Example
A retail activation might use this pattern:
Display Name:Daily Gift CardTotal Quantity:30- three attribution slots of
10rewards each Associated Reward: oneReceipt Game Reward- one spend rule linked to this winning option