Spin Wheel

⌘K
  2. Home
  4. Spin Wheel
  6. Campaign
  8. Prize & Coupon Configuration

Prize & Coupon Configuration

The Economy of Your Wheel

The Coupons & Rewards tab is the heart of your campaign. This is where you define exactly what users can win, how many times they can win it, and the odds of that happening.

Unlike simple popup plugins, Ultimate Spin Wheel provides a professional-grade “Prize Engine” that can handle everything from simple text outcomes to complex, auto-generated WooCommerce coupons.

1. Coupon Types (The 3 Engines)

When you click “Add Coupon”, you can choose from three distinct logic engines for each slice.

A. Static (The “Universal” Coupon)

  • Best for: Generic codes like SAVE10 or non-coupon prizes.
  • How it works: Everyone who lands on this slice sees the same text or code.
  • Use Cases:
    • Generic Discount: Enter code WELCOME10 (created manually in WooCommerce).
    • Physical Prize: Enter text “Free T-Shirt” (no code).
    • Losing Slice: Label it “Bad Luck” and leave the code empty.

B. Unique Pool (The “Code Bank”)

  • Best for: Single-use codes from external sources (Amazon Gift Cards, Groupon, or pre-generated CSVs).
  • How it works:
    • You paste a comma-separated list of codes (e.g., X7K, M9P, L2Q...).
    • When a user wins, the system takes one code from the pool and assigns it to them.
    • Inventory Control: Once the pool is empty (all codes are distributed), the system automatically hides this slice or effectively marks it as “Sold Out” (0% probability).

C. WooCommerce Dynamic (The “Auto-Generator”)

  • Best for: Secure, high-value discounts.
  • Requirement: Requires Pro Version.
  • How it works: You don’t need to create coupons in WooCommerce. The plugin dynamically generates a unique coupon code for every single winner in real-time.
  • Configuration: You define the rules directly in the wheel settings:
    • Discount Type: Percentage, Fixed Cart, or Fixed Product.
    • Amount: e.g., “15” (for 15%).
    • Expiry: e.g., “3 Days” (creates urgency).
    • Product Restrictions: meaningful for “Loss Leaders” (e.g., “50% Off” but only for Product ID 123).

2. Segment Customization

Beyond just the prize value, you can control the visual and emotional presentation of each slice.

Visual Settings

  • Label: The text shown on the wheel (e.g., “Jackpot”).
  • Color: Pick a distinct color for the slice. We recommend alternating colors (e.g., Red / White / Red / White) for visual contrast.
  • Icon / Image:
    • You can upload a custom graphic (PNG/SVG) to replace or sit alongside the text.
    • Tip: Use simple icons (like a “Gift Box” or “Sad Face”) as they spin clearly.

Individual Win Messages

You can customize the “Celebration Text” for each specific prize.

  • Default: “Congratulations! You won!”
  • Custom: “Holy Cow! You just won the GRAND PRIZE!”
  • Template Tags: Use {{discount_label}} to dynamically insert the prize name.

3. Probability & Math (The Algorithm)

The wheel uses a “Weighted Probability” system to ensure fairness and budget safety.

Setting the Odds

  • Validation: The system automatically calculates the Total Probability.
  • Safety Check: If your total exceeds 100%, a red warning card (“Over 100%”) will appear. You must adjust the numbers until they equal 100 or less.
  • The “Losing” Gap: If your probabilities add up to 80% (e.g., 4 winning slices of 20% each), the remaining 20% automatically becomes the “Lost” probability. You don’t need to create a specific “Looser” slice; the wheel will simply land on a non-winning sector (or you can create an explicit “Bad Luck” slice and assign it that 20% for better UX).

Real-Time Stats

At the bottom of the tab, you will see a Live Dashboard:

  • Total Coupons: How many slices are active.
  • Avg. Win Rate: The average chance a user has of winning something.
  • Total Probability: Your math check.

4. WooCommerce Specific Settings

When using the WooCommerce Dynamic type, you have granular control over the generated coupon:

  • Prefix: Add your brand (e.g., MYBRAND-xxx).
  • Free Shipping: Toggle this ON to create a “Free Shipping” prize without needing a monetary discount.
  • Individual Use: Prevent the winner from stacking this prize with other coupons during Black Friday.
  • Expiry (Urgency): Setting this to “1 Day” is a powerful psychological trigger. The user knows the prize will vanish if they don’t buy now.

Frequently Asked Questions

Q: Can I use this for non-WooCommerce sites? 
A: Yes! Use the Static or Unique Pool types. You can give away PDF links, secret passwords, or external gift cards.

Q: What happens when my “Unique Pool” runs out of codes? 
A: The probability for that slice effectively becomes 0. The wheel will skip it. You should monitor your pool size or use “WooCommerce Dynamic” to generate infinite codes.

Q: Can I limit how many “Grand Prizes” are given per day? 
A: Yes, in the Settings > Inventory tab (if enabled globally), but the primary control is the Probability. Setting a prize to 0.1% ensures it is rare without needing a hard cap.

Q: Can I edit a coupon after I have published the campaign? 
A: Yes. You can change the “Master Template” at any time. However, coupons that have already been generated and sent to users will remain unchanged. Your edits will only apply to future winners.

Q: What happens if I delete the Master Coupon in WooCommerce? 
A: The spin wheel will fail to generate new codes. It creates a critical error in the log. Please ensure you never delete a coupon that is currently linked to an active campaign.

Q: Can I offer a “Variable” discount? 
A: No, each slice must map to a specific coupon. If you want to offer 5%, 10%, and 20%, you must create three separate slices, each linked to a different WooCommerce coupon template.

Q: Why are my probabilities not saving? 
A: Ensure they total exactly 100%. Even 99.9% or 100.1% can sometimes cause the validation logic to reject the save.

Troubleshooting

  • “Probability Warning”: If you see a red warning that your total is > 100%, the wheel logic might get confused. Ensure your slices add up to exactly 100% (or less, if you want “lost” spins to be the default for the remainder).

Conclusion

The Coupons tab transforms your wheel from a graphic into a “Sales Engine.” By combining Dynamic Codes (for security) with Probability Math (for budget control), you can run a campaign that is both exciting for the user and profitable for you.
Proper Inventory Management prevents a marketing campaign from becoming a financial disaster. By verifying your probabilities and using hard limits on high-value items, you can run aggressive contests without fear of “giving away the farm.”

How can we help?