Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.fanfare.io/llms.txt

Use this file to discover all available pages before exploring further.

​
Configure Draw Experience

Draw experiences (also called lotteries) use random selection to fairly allocate limited products. All eligible consumers enter during an entry window, and winners are randomly selected at a specified time. This is ideal when you want to give everyone an equal chance regardless of when they enter.

​
When to Use Draws

Draws are best for:
  • Fair allocation - Equal chance for all participants
  • High-demand launches - When demand far exceeds supply
  • Giveaways - Free product distributions
  • Exclusive access - VIP opportunities for loyal customers
  • Avoiding queues - No advantage to being first

​
Creating a Draw Experience

  1. Navigate to Experiences > Create Experience
  2. Select Draw from the experience type options
  3. Complete the draw configuration form
Caption: The draw creation form with all configuration options

​
Draw-Specific Settings

​
Entry Period

Configure when consumers can enter the draw: Caption: Set when consumers can enter the draw
FieldRequiredDescription
Entry OpensYesWhen consumers can start entering
Entry ClosesYesDeadline for entries
Draw TimeYesWhen winners are randomly selected
Allow at least 24-48 hours between entry close and draw time to build anticipation and give latecomers a chance to hear about the draw.

​
Draw Configuration

Caption: Configure how winners are selected
FieldRequiredDescription
Number of WinnersYesHow many winners to select
Selection MethodYesRandom or weighted selection
Backup WinnersNoNumber of alternates to select

​
Selection Methods

MethodDescriptionBest For
Pure RandomEqual chance for everyoneFair giveaways
Weighted by EngagementHigher chance for active usersRewarding loyalty
Weighted by TierBased on loyalty tierVIP prioritization

​
Inventory Allocation

FieldRequiredDescription
Total InventoryYesTotal items available
Per-Winner AllocationNoItems each winner receives (default: 1)
Reserve for AlternatesNoInventory held for backup winners

​
Winner Handling

​
Selection Process

When the draw time arrives:
  1. System validates all entries
  2. Random selection algorithm runs
  3. Winners are determined
  4. Backup winners selected (if configured)
  5. Notifications sent
Caption: View draw results after selection

​
Winner Confirmation

Winners typically need to confirm their win within a timeframe:
SettingDescription
Confirmation WindowTime winners have to accept (e.g., 24 hours)
Auto-forfeitAutomatically pass to alternates if not confirmed
Manual OverrideAllow admin to manually confirm/reject

​
Alternate Promotion

If a winner doesn’t confirm:
  1. Winner is marked as forfeited
  2. First alternate is notified
  3. Alternate gets same confirmation window
  4. Process continues until inventory is allocated

​
Notifications

​
Entrant Notifications

EventNotification
Entry ConfirmedYou’re entered in the draw
Entry ReminderDraw happening soon
You WonCongratulations + next steps
You Didn’t WinBetter luck next time
Winner Confirmation ReminderReminder to confirm your win

​
Non-Winner Options

Configure what non-winners see:
OptionDescription
WaitlistOption to join waitlist for forfeits
Related ProductsShow similar available products
Next DrawInfo about upcoming draws

​
Draw States

Draft → Scheduled → Entry Open → Entry Closed → Drawing → Confirmation → Completed
                                                   ↓
                                               Cancelled
StateDescription
DraftNot published
ScheduledPublished, waiting for entry window
Entry OpenAccepting entries
Entry ClosedNo more entries, waiting for draw
DrawingSelection in progress
ConfirmationWinners confirming
CompletedAll inventory allocated or expired

​
Example: Product Launch Draw

​
Scenario

  • Product: Limited edition sneakers
  • Inventory: 200 pairs
  • Expected entries: 10,000+

​
Configuration

Name: "Jordan Retro Launch Draw"
Product: Jordan Retro 2024
Audience: Loyalty Members

Entry Period:
  Entry Opens: Monday 9 AM
  Entry Closes: Wednesday 9 PM
  Draw Time: Thursday 12 PM

Draw Settings:
  Number of Winners: 200
  Selection Method: Pure Random
  Backup Winners: 50

Winner Handling:
  Confirmation Window: 24 hours
  Auto-forfeit: Enabled

Per-Winner:
  Allocation: 1 pair
  Purchase Required: Yes
  Payment Window: 48 hours

Notifications:
  - Entry confirmed
  - Draw reminder (1 hour before)
  - Win/loss results
  - Confirmation reminders
Caption: A fully configured product launch draw

​
Best Practices

​
Entry Period

  1. Give adequate time - At least 48 hours for entry
  2. Promote early - Announce before entries open
  3. Clear deadlines - Make entry close time obvious
  4. Multiple reminders - Send reminders before close

​
Fair Selection

  1. Use pure random for giveaways - Ensures fairness
  2. Document your method - Be transparent about selection
  3. Exclude duplicates - Verify one entry per person
  4. Audit trail - Keep records of selection process

​
Winner Management

  1. Reasonable confirmation window - 24-48 hours minimum
  2. Clear next steps - Explain what winners need to do
  3. Multiple contact attempts - Don’t forfeit too quickly
  4. Backup winner process - Have alternates ready

​
Common Configurations

Use CaseWinnersEntry PeriodConfirmation
Small giveaway101 week48 hours
Product launch100-5002-3 days24 hours
VIP access501 week72 hours
Large raffle1,000+2 weeks48 hours

​
Handling Issues

​
Low Entry Count

If entries are below expectations:
  • Extend entry period
  • Increase promotion
  • Lower any entry requirements
  • Partner for cross-promotion

​
Duplicate Entries

If you detect duplicate entries:
  1. Review entry patterns
  2. Identify linked accounts
  3. Remove duplicates before draw
  4. Consider stricter verification

​
Winner Disputes

If a winner disputes results:
  1. Provide selection documentation
  2. Show their entry confirmation
  3. Verify their eligibility
  4. Escalate to support if needed

​
Mass Forfeit

If many winners don’t confirm:
  1. Extend confirmation window
  2. Send additional reminders
  3. Verify notification delivery
  4. Consider re-drawing if needed

​
Compliance Considerations

​
Sweepstakes Rules

For promotional draws:
  • Check local gambling/sweepstakes laws
  • Provide official rules
  • Consider “no purchase necessary” options
  • Document winner selection

​
Data Handling

  • Only collect necessary information
  • Secure entry data
  • Delete after required retention
  • Handle winner info appropriately