MR Labs

Wheel Spin

A weighted prize wheel game with configurable segments, spin limits, and lead capture.

How It Works

The Wheel Spin game presents a circular wheel divided into segments. Each segment represents a prize or a no-prize outcome. When a participant spins, the wheel rotates and decelerates, landing on a segment. The outcome is determined by weighted probabilities assigned to each segment, not purely by visual position.

If the landed segment has a prize, the participant wins that prize. If it is a no-prize segment, the participant receives a "try again" outcome.

Configurable Prize Segments

Each segment in the wheel is defined in the game's JSONB configuration. A segment includes a label, a prize reference (or null for no prize), and a weight. The weight controls how likely the wheel is to land on that segment relative to the others.

  • label: The text displayed on the segment.
  • prize: The prize awarded if the wheel lands here, or null for a no-win segment.
  • weight: A positive number. The probability of landing on a segment is its weight divided by the total weight of all segments.

For example, with two segments weighted 1 and 9, the first segment has a 10% chance and the second a 90% chance of being selected.

Spin Limits

You can cap how many times a single participant can spin the wheel. This prevents abuse and keeps prize distribution fair across a campaign. The spin limit is set in the game configuration and applies per participant.

Prize Emails

When a participant wins a prize, an automated email can be sent to deliver the prize details or a redemption code. The email template and sender are configured at the organization level. Prize emails are triggered automatically on a win and logged as part of the prize distribution record.

Lead Capture

Before spinning, participants can be asked to provide contact information such as name and email. This turns the game into a lead capture tool: the participant gets a chance to win, and you collect a qualified lead. Lead capture is optional and can be toggled in the game configuration.

Captured leads are stored against the game and can be exported for follow-up campaigns.

Embedding

A Wheel Spin game can be embedded on any page using an embed snippet. The embed renders the wheel inline within your content, preserving your page layout while giving visitors an interactive prize experience. The embed uses the game's public URL and adapts to the available container width.