Prize Configuration

Lucky-draw games (Spin the Wheel, Gachapon, Grid Box, Scratch Card, Card Pull, and Claw Machine) use a prize configuration system. This guide explains how to set up, manage, and monitor prizes.

Prize Types

Each prize slot must be one of five types:

Type	What the player gets	Fulfillment
Voucher Set	A unique code pulled from a managed set	Automatic (tracked)
Voucher	A fixed code string (e.g., “SAVE20”)	Shown directly to player
Item	A named physical/digital prize	Manual (you fulfill)
External Link	A URL where the player redeems separately	Player follows link
No Prize	”Try again” — no reward given	N/A

Prize configuration

When to use each type

Voucher Set — Best for campaigns with many unique codes (one per winner). Codes are auto-assigned from your inventory and tracked.
Voucher — Use for a single shared code that all winners see (e.g., a universal discount code).
Item — Physical merchandise, free products, or service upgrades that require manual fulfillment.
External Link — Drive traffic to a landing page, partner offer, or redemption portal.
No Prize — Essential for balancing probabilities. Without “try again” slots, every play results in a win.

Setting Up Prizes

In the Game Editor

When creating or editing a lucky-draw game:

Open the Prizes section
Click Add Prize Slot
Configure each slot (see fields below)
Reorder slots using the Move Up / Move Down buttons

Example: How to set up an item prize in the game:

Prize Slot Fields

Field	Description	Required
Name	Display name shown to the player (max 50 chars)	Yes
Description	Additional details (max 200 chars)	No
Type	One of the 5 prize types above	Yes
Win Chance (%)	Probability of winning this slot (1–100%)	Yes
Quantity	Total available (leave empty for unlimited)	No
Min Score	Minimum score required to be eligible	No
Voucher Set	Which set to pull codes from (voucher set type only)	Conditional
External URL	Redemption link (external link type only)	Conditional
Image	Custom prize image (max 10 MB, resized to 256×256)	No

Display Order

The order you arrange prizes in the editor directly controls how they appear in the game (e.g., wheel segments, grid cells). Use the Move Up/Down buttons to arrange them. Display order does not affect win probability — only the chance percentage matters for odds.

Probability Rules

All prize chances across a game must total 100% or less.

Validation Rules

Each slot must have a chance greater than 0%
The sum of all slots cannot exceed 100%
DailyPlay validates both in the editor and server-side before saving

Example: Spin the Wheel (8 slots)

Slot	Prize	Type	Chance	Quantity
1	$50 Gift Card	Voucher Set	5%	10
2	20% Off	Voucher Set	10%	50
3	10% Off	Voucher	15%	Unlimited
4	Try Again	No Prize	20%	Unlimited
5	Free Shipping	Voucher	10%	Unlimited
6	Try Again	No Prize	15%	Unlimited
7	Visit Our Blog	External Link	15%	Unlimited
8	Try Again	No Prize	10%	Unlimited
—	Total		100%

Example: Gachapon (6 capsules)

Capsule	Prize	Type	Chance	Quantity
Gold	$50 Voucher	Voucher Set	2%	10
Silver	$20 Voucher	Voucher Set	8%	50
Bronze	$10 Voucher	Voucher Set	20%	100
Blue	10% Off	Voucher	30%	Unlimited
Green	5% Off	Voucher	25%	Unlimited
Gray	Try Again	No Prize	15%	Unlimited

Minimum Score Requirements

For games that combine skill with luck, you can set a minimum score per prize slot. Players must achieve at least that score before the prize becomes eligible in the draw.

How it works:

Player finishes the game with a score
Server filters prizes — only those where min_score ≤ player's score are included
Weighted random draw occurs among eligible prizes only

Example:

Prize	Chance	Min Score
Grand Prize	5%	1000
Runner Up	15%	500
Consolation	30%	0
Try Again	50%	0

A player scoring 750 is eligible for Runner Up, Consolation, and Try Again — but not Grand Prize.

Minimum score configuration

Quantity and Inventory

Limited Quantity

Set a total quantity for high-value prizes:

The remaining_quantity decrements each time the prize is won
When it reaches 0, the prize is excluded from future draws
Remaining prizes’ probabilities auto-adjust proportionally

Unlimited Prizes

Leave quantity empty for prizes you can always fulfill:

Digital codes, voucher sets with large inventories, external links
No inventory tracking needed

What Happens When Depleted

The depleted prize is skipped during the draw
The system redistributes probability among remaining eligible prizes
If all prizes are depleted, the game returns no prize

Active / Inactive Prizes

Each prize has an is_active flag:

Active — Included in draws, shown with a green badge in the dashboard
Inactive — Excluded from draws, shown with a gray badge

Use this to temporarily disable a prize without deleting it (e.g., pause a promotion, swap prizes mid-campaign).

How the Draw Works

DailyPlay uses a server-side cryptographic draw — prize selection cannot be manipulated from the frontend:

Game calls the draw endpoint with the game ID
Server fetches all active, eligible prizes (with inventory and score checks)
Weighted random selection picks a winner based on chance percentages
A signed token (HMAC-SHA256) is generated containing the result
Token is valid for 30 minutes
When the player claims, the server verifies the token signature before awarding

Claim Processing by Type

Prize Type	What happens on claim
Voucher Set	Next available code assigned, voucher marked `claimed`
Voucher	Fixed code string returned to player
Item	Prize name displayed, player fills claim form
External Link	URL returned, player redirected to external redemption
No Prize	”Try again” message shown

Connection Events

Every prize claim triggers outbound integrations if configured:

Zapier, Braze, Mailchimp, HubSpot, Salesforce, Segment, or custom webhooks
Event payload includes: game ID, player UUID, score, prize name, prize type, voucher code

Learn more in Connections.

Prizes Dashboard

Access from Organization → Prizes to monitor all prize activity.

Stats Cards

Metric	Description
Total Prizes	All configured prize slots
Active Prizes	Slots currently eligible for draws
Total Wins	Prizes awarded all-time
Wins Today	Prizes awarded in the last 24 hours
Vouchers Awarded	Voucher codes distributed

Per-Game Breakdown

Each game shows:

Number of prize slots configured
Total chance percentage (green if 100%, red if over)
Collapsible table with all prizes: name, type, chance %, quantity remaining, active status
Quick edit link to the game editor

Best Practices

Probability Balance

Recommended distribution for player engagement:

Tier	Chance Range	Purpose
High-value	2–10%	Creates excitement and aspiration
Medium	15–30%	Keeps players feeling rewarded
Low-value	25–40%	Frequent small wins
No prize	20–40%	Creates anticipation for retry

Visual Appeal

Upload custom images for each prize — players see them in the game UI
High-value prizes with compelling images drive more engagement
Images are resized to 256×256px automatically

Testing Before Launch

Play the game multiple times in preview mode
Verify all prize types display correctly (codes, links, names)
Check that voucher set prizes actually deliver a code
Confirm quantities decrement properly
Test with scores below and above min_score thresholds (if used)

Troubleshooting

Player won but no code displayed

Check that the linked voucher set still has available codes
Verify the set hasn’t expired
The prize may have hit its quantity limit — check remaining inventory

Probabilities seem wrong

Verify totals equal 100% in the editor
Small sample sizes will naturally appear skewed — test with 50+ plays
If some prizes are depleted, remaining prizes effectively have higher chances

Prize not showing in game

Confirm the prize is active (not inactive/disabled)
Check that remaining_quantity isn’t 0
Ensure the game is published (not in draft mode)
If using min_score, verify the player’s score meets the threshold

”Token expired” on claim

The draw token is valid for 30 minutes. If a player waits too long between seeing the result and claiming, the token expires. This is rare in normal gameplay.

Next Steps

Set up Voucher Sets → to supply codes for your prizes
Share your game → once prizes are configured