Games: Overview
Interactive prize games for engagement and lead capture. Covers game types, configuration, status, and public URLs.
What are Games?
Games are interactive experiences that participants play for a chance to win prizes. They are designed for engagement, lead capture, and promotional campaigns. Each game is configured with a set of prize segments or outcomes and can be embedded on any page or shared via its public URL.
Games track prize distribution so you can monitor how many prizes have been awarded and manage inventory across a campaign.
Game Types
The platform supports 4 game types:
| Game | Description | Status |
|---|---|---|
| Wheel Spin | A spinning wheel divided into prize segments. The wheel lands on a segment based on weighted probabilities. | Ready |
| Scratch Card | A virtual scratch-off card that reveals a prize when the participant scratches the surface. | Coming soon |
| Memory Match | A card-matching game where participants flip pairs to find matches. Matching a prize pair wins the prize. | Coming soon |
| Plinko | A pegboard drop game where a disc falls through a field of pegs into a prize slot at the bottom. | Coming soon |
Only Wheel Spin is currently available. The other game types are under active development.
Game Configuration
Each game stores its configuration as a JSONB object. The configuration defines the game-specific parameters such as prize segments, weights, spin limits, and visual settings. Because the config is flexible JSON, each game type uses its own schema.
See the Wheel Spin page for the configuration shape of that game type.
Game Status, Visibility, and Access
Games share the same lifecycle and access controls as forms and quizzes:
- status:
draft(default),published, orarchived - visibility:
private(default),public, orunlisted - access_mode:
anonymous(default),authenticated, oroptional
A game must be published and public (or unlisted) for its public URL to be accessible without authentication.
Public Game URL
Every game has a public URL in the format {org_slug}/g/{game_slug}. The game_slug is auto-generated from the title if not specified explicitly.
Prize Distribution Tracking
Games track every prize awarded to a participant. For each prize win, the platform records the participant, the prize, and the timestamp. This lets you monitor how many of each prize remain, cap high-value prizes, and reconcile prize inventory against actual fulfillment.