Create an Instant Win
Instant Win evaluates conditions in real time and awards a surprise prize by chance the moment a qualifying event is received — no post-processing, no batch jobs, and no play step for the customer.
Go to Gamified Campaigns → Instant Win → New Instant Win in the Owner App.
:::note Requirements
Instant Win works only with the new promo engine; Companies on the legacy engine must be migrated first. The Instant Win section is enabled per Company — if you do not see it under Gamified Campaigns, contact your Customer Success Manager.
:::
How It Works
- You define the campaign with its events, victory conditions, prizes, and a probability for each prize.
- When a customer's event matches the victory conditions, the engine runs a single weighted random draw among all the prizes, No Prize included.
- The result is decided by the probabilities you configured: they always add up to 100%, so every draw selects exactly one prize or No Prize.
- If the customer wins, the prize is delivered automatically — no batch processing, no manual step. If No Prize is drawn, nothing is delivered and no notification is sent.
- Limits (per-customer and campaign total) and per-prize stock prevent over-distribution.
Instant Win list
Gamified Campaigns → Instant Win lists all the Instant Win campaigns of the Company.
| Element | Description |
|---|---|
| Columns | ID, Name, Personalization (Loyalty / Targeted), Availability (date range), Status |
| Filters | ID, Name, Available from, Available to, Status |
| Row actions | Edit, Delete |
| Table actions | Create a new Instant Win; export the list as CSV |
Configuration
1. Description
| Field | Description |
|---|---|
| Name | Internal campaign name (required) |
| Description | Optional description |
| Category | Campaign category used to organize and report on campaigns (required) |
| Currency | Currency in which monetary victory conditions (e.g., Total) are evaluated |
| Status | Active or Inactive |
| Availability from | Start date of the campaign window (required) |
| Availability to | End date of the campaign window (required) |
| Recurrence | How often the Instant Win can be triggered. Options: None, Daily, Weekly, Monthly. When set to Weekly, an Available days selector appears to restrict the campaign to specific days of the week. |
2. Events
Select which type of event activates the Instant Win evaluation. The evaluation runs automatically when the event is received; the customer app does not need to call any "play" endpoint.
| Option | Description |
|---|---|
| Cart | Triggered on every cart or purchase event |
| Trigger | Activated by a configured platform trigger (e.g., birthday, first purchase, registration anniversary) |
| Custom Events | Triggered by a custom external event configured in the platform (e.g., completing a race, app login) |
3. Select Customers
Choose the audience eligible for an Instant Win draw:
| Option | Behavior |
|---|---|
| Loyalty members | Available to all enrolled loyalty club members |
| Targeted | Restricted to a specific customer audience delivered via a Targeted Delivery. The Instant Win is not active for a customer until a Targeted Delivery has been sent with this Instant Win assigned, which generates a Voucher for each impacted customer. |
Coupon required for campaign use — when enabled, the Instant Win is evaluated only for customers who hold its Voucher. It is enabled automatically for Targeted Instant Wins and cannot be changed once the campaign is created.
4. Victory Conditions
Configure conditions the event must satisfy for the draw to run. This is the same conditions block used by discount and points campaigns: conditions are organized in groups combined with AND / OR, and amount conditions accept decimals (e.g., Total ≥ 1.5).
Cart-level: Total, Original total, Total minus additional cost, Country, Store, Store Category, Payment method
Line-level: Item Product, Item Product Category, Product ID, Item Attributes
Customer-level: Tier, Registration Countries, Client Attributes, Calculated Attributes, Customer ID
5. Prizes
Define the prizes the customer can win. Click Add promotion and choose a card in the prize selector:
| Prize card | What the customer receives |
|---|---|
| Points & Wallet | Points credited to the customer's wallet |
| Reward | A Reward from the catalog |
| Game | A game participation for an active Targeted Scratch & Win or Spin the Wheel game; the customer then plays the game |
| No Prize | Nothing — the explicit chance of not winning |
The Discount card is shown disabled ("coming soon"): Discount and Coupon prizes are not available in this release and are planned for a future phase.
Each prize is one row in the prizes table:
| Field | Description |
|---|---|
| Promotion | The specific prize to award. Select from previously created points campaigns, rewards, or games. Not applicable for No Prize. |
| Short name | Display label shown to the customer for this prize |
| Probability | Percentage chance (0–100) that a qualifying draw selects this prize. Decimal values are allowed, up to two decimal places (e.g., 0.5%, 33.33%). The probabilities of all prizes, No Prize included, must add up to exactly 100% — a campaign that does not add up to 100% cannot be saved. |
| Max limit | Maximum number of times this prize can be awarded across all draws (stock). Not applicable for No Prize. |
| End of stock management | Behavior when this prize's stock is exhausted: Remove prize, leave probabilities unchanged — the exhausted prize is no longer awarded, other prizes keep their probabilities, and the freed probability becomes No Prize. Not applicable for No Prize. |
No Prize
No Prize completes the probabilities up to 100% when not every qualifying customer should win. For example, to give a 0.5% chance of winning a game participation, configure Game participation 0.5% + No Prize 99.5%. To always award a prize when the conditions are met, give that prize 100% and do not add No Prize.
No Prize has no stock or Max limit. When it is drawn, nothing is delivered and no notification is sent; the response still includes the instant_win effect so the app can show the result. See Probability Management.
6. Limits
| Setting | Description |
|---|---|
| Chances to participate | Maximum number of times the Instant Win can be triggered in total across all customers (global limit). |
| Chances to accrue per client | Maximum number of times a single customer can participate in this Instant Win. |
Both fields support the following period options: per day (natural), per month (relative or natural), per year (relative or natural), total number of times, or always. Every participation counts toward the limits, including those that end in No Prize.
Editing and deleting an Instant Win
| Situation | What you can do |
|---|---|
| No participations yet | Edit any field, or delete the Instant Win from the list. |
| Has participations | The Instant Win cannot be deleted. Prizes that have already been awarded or drawn cannot be edited or removed, but you can add new prizes. |
To stop an Instant Win that already has participations, set its Status to Inactive or end its availability.