Eligibility Rules in Instant Win Results

Create tiered prize systems with conditional results based on user eligibility, loyalty status, contact properties, and more

Eligibility Rules in Instant Win Results

Create sophisticated, tiered prize systems by applying eligibility rules to specific instant win results. This feature allows you to offer different prizes to different user segments based on their profile, behavior, or loyalty status.

Overview

The instant win system supports three types of results, each serving a different purpose:

1. General Success Results

Available to all users who complete the instant win action. These ensure your base win rate and provide prizes to your general audience.

2. Success Results with Eligibility Rules

Conditional prizes only available to users who meet specific criteria (e.g., VIP members, high loyalty points, specific contact properties). These create premium experiences for valued segments.

3. Fallback Results

Non-winning outcomes for users who don’t win any success result. These cannot have eligibility rules and serve as the default when no success results are won.

How It Works

The Prize Selection Process

1. User completes action (form submission, spin, etc.)
2. System evaluates eligibility for conditional results first
3. If eligible for conditional results:
   • User enters pool for those specific prizes
   • Probability calculated based on eligible results only
4. If not eligible for any conditional results:
   • User enters pool for general success results
   • Standard probability applies
5. If no success result won:
   • Fallback result displayed

Probability Distribution

Important: The system ensures probabilities make sense across all result types:

Example Setup:

• General Success Results: 60% total probability
• Conditional Success Results (VIP only): 30% total probability
• Fallback: 10% (automatically calculated as remainder)

For a VIP user:

• Eligible for: General (60%) + Conditional (30%) = 90% win chance
• 10% chance of fallback

For a regular user:

• Eligible for: General (60%) only
• 40% chance of fallback (60% general + 40% fallback = 100%)

Setting Up Eligibility Rules on Results

Step 1: Create General Success Results

These are your baseline prizes available to everyone:

1. Navigate to Instant Win card > Gameplay > Results
2. In the “Success results” section, click Add Result
3. Configure the prize:
   • Prize type (coupon, points, physical item)
   • Win probability percentage
   • Inventory limits
   • Visual design (colors, images, text)
4. Leave eligibility rules empty (this makes it available to all)
5. Repeat for multiple general results

Best Practice: General results should total 40-70% probability to leave room for conditional results.

Step 2: Create Conditional Success Results

These are premium prizes for specific segments:

1. In the “Success results” section, click Add Result
2. Configure the prize with premium value (better than general results)
3. Click “Add Eligibility Rules”
4. Configure rules using the predicate builder:

Available Rule Types:

Contact Property Rules

• Property value equals specific value
• Property value greater/less than numeric values
• Property exists/doesn’t exist

Example:

Property: "Customer Tier" = "VIP"
Property: "Age" > 25

List Membership Rules

• Is member of specific contact list
• Is not member of specific list
• Has any of multiple lists
• Has all of multiple lists

Example:

List: "Loyalty Program Members" = Has
List: "Premium Customers" = Has

Subscription Rules

• Subscription status is subscribed/unsubscribed/pending
• Specific subscription exists

Example:

Subscription: "Newsletter" = Subscribed

Loyalty Balance Rules

• Points greater than specific amount
• Points less than specific amount
• Points between range
• Program participation exists

Example:

Loyalty: "Main Program" > 1000 points

Form Field Rules

• Specific answer to form question
• Field value matches criteria

Example:

Form Field: "Purchase Intent" = "High"

Step 3: Configure Fallback Result

The fallback appears when users don’t win any success result:

1. Scroll to “Fallback” section
2. Configure consolation experience:
   • Message (e.g., “So close! Try again tomorrow”)
   • Visual design
   • Optional consolation prize (small discount, points)
   • Call-to-action (e.g., “Shop Now”, “Learn More”)

Important: Fallback results cannot have eligibility rules. They serve as the default non-winning outcome.

Step 4: Balance Probabilities

Ensure your probability distribution makes sense:

Recommended Distribution:

• General Success: 40-60%
• Conditional Success: 20-40%
• Fallback: Remainder (10-30%)

Validation Checks:

• System warns if probabilities don’t total correctly
• Ensure conditional results don’t exceed logical limits
• Test with different user types

Advanced Configurations

Tiered Prize System Example

Bronze Tier (General Users):

• 10% discount coupon (30% probability)
• 50 loyalty points (20% probability)
• Total: 50% win chance

Silver Tier (Loyalty Members 100+ points):

• 20% discount coupon (15% probability)
• Free shipping (10% probability)
• Total: 25% win chance (only for eligible)

Gold Tier (VIP List Members):

• 50% discount coupon (10% probability)
• Free product (5% probability)
• Total: 15% win chance (only for eligible)

Fallback:

• “Thanks for playing” message (10% probability)

Outcome:

• VIP users: 50% + 25% + 15% = 90% win rate
• Loyalty members: 50% + 25% = 75% win rate
• Regular users: 50% win rate

Time-Based Conditional Results

Create urgency with time-sensitive eligibility:

Happy Hour Prizes (2-4 PM only):

Rule: Time of Day between 14:00-16:00
Prize: Double points bonus
Probability: 20%

Weekend Special:

Rule: Day of Week = Saturday OR Sunday
Prize: Premium discount
Probability: 15%

Location-Based Results

Target users by geography:

Local Store Promotion:

Rule: Contact Property "City" = "Sydney"
Prize: In-store exclusive offer
Probability: 25%

Behavior-Based Results

Reward specific actions:

First-Time Users:

Rule: Contact Property "Total Entries" = 0
Prize: Welcome bonus (higher value)
Probability: 80%

High-Value Customers:

Rule: Contact Property "Lifetime Value" > $500
Prize: Exclusive premium prize
Probability: 30%

Best Practices

Probability Management

Do:

• Ensure total probabilities make sense (general + conditional should be 70-90%)
• Leave 10-30% for fallback
• Test probability calculations with sample users
• Monitor actual win rates vs. configured rates

Don’t:

• Set conditional results to 100% (no room for general results)
• Create overlapping conditions that confuse the system
• Forget to account for users who qualify for multiple conditional results

User Experience

Clear Communication:

• Tell users they have different chances based on their status
• “VIP members get 2x the win rate!”
• “Join our loyalty program for better prizes”

Transparent Design:

• Show locked prizes to non-eligible users (creates aspiration)
• “Unlock this prize by joining our VIP program”
• Visual distinction between available and locked prizes

Fallback Experience:

• Always provide value in fallback (discount, points, content)
• Encourage future participation
• Explain how to improve chances next time

Rule Design

Specificity:

• Be precise with rule criteria
• Test rules with sample contacts
• Avoid overly complex rule combinations

Performance:

• Too many complex rules can slow down instant win processing
• Optimize by using list membership instead of multiple property checks
• Cache frequently used eligibility calculations

Use Cases

Use Case 1: VIP Customer Appreciation

Goal: Reward top customers with exclusive prizes

Setup:

General Results (All Users):
- 10% off: 40% probability
- Free shipping: 20% probability

Conditional Results (VIP List):
- 50% off: 15% probability
- Free product: 10% probability
Rules: List "VIP Customers" = Has

Fallback:
- 5% off consolation: 15% probability

Result: VIP customers get 85% win rate with premium prizes

Use Case 2: Loyalty Program Tiers

Goal: Incentivize loyalty program participation

Setup:

General Results:
- 50 points: 35% probability
- 10% off: 25% probability

Conditional (Bronze Tier 100+ points):
- 100 points: 15% probability
Rules: Loyalty > 100 points

Conditional (Silver Tier 500+ points):
- 250 points: 10% probability
Rules: Loyalty > 500 points

Conditional (Gold Tier 1000+ points):
- 500 points + free gift: 5% probability
Rules: Loyalty > 1000 points

Fallback:
- 25 points: 10% probability

Result: Higher loyalty = better prizes and higher win rates

Use Case 3: Geographic Product Launch

Goal: Target specific cities for new product promotion

Setup:

General Results (All Locations):
- Brand awareness content: 60% probability

Conditional (Target Cities):
- New product sample: 20% probability
Rules: Property "City" IN ["Sydney", "Melbourne", "Brisbane"]

Conditional (Local Store Members):
- In-store discount: 10% probability
Rules: List "Local Store Members" = Has

Fallback:
- "Coming to your city soon" message: 10% probability

Result: Targeted geographic promotion with local engagement

Use Case 4: Survey Response Rewards

Goal: Incentivize detailed survey responses

Setup:

General Results:
- 50 points: 50% probability

Conditional (High Engagement):
- 200 points: 25% probability
Rules: Form Field "Survey Completion" = "Complete"
AND Form Field "Feedback Length" > 100 characters

Conditional (Valuable Feedback):
- $10 coupon: 15% probability
Rules: Form Field "Net Promoter Score" <= 6
(Addresses detractors with special offer)

Fallback:
- Thank you message: 10% probability

Result: Rewards quality engagement and addresses concerns

Troubleshooting

Issue: Users Not Getting Conditional Results

Check:

1. Are eligibility rules configured correctly?
2. Does the user meet ALL criteria (AND logic)?
3. Is the contact data up to date?
4. Are there inventory limits preventing distribution?

Debug:

• Test with a contact that should qualify
• Check eligibility rule evaluation in contact profile
• Verify contact properties are populated

Issue: Probability Calculations Seem Wrong

Check:

1. Total of all results (general + conditional) should be 70-90%
2. Fallback should be 10-30%
3. Conditional results only apply to eligible users
4. System calculates based on eligible results only

Example:

• Configured: General 60%, Conditional 30%, Fallback 10%
• For eligible user: 60% + 30% = 90% total win chance
• For non-eligible user: 60% general + 40% fallback (100% - 60%)

Issue: Conditional Results Not Showing in Preview

Check:

1. Preview uses sample data - does sample contact meet criteria?
2. Are eligibility rules published/active?
3. Is the result status set to “Active”?

Issue: Performance Slowdown

Optimize:

1. Reduce number of complex eligibility rules
2. Use list membership instead of multiple property checks
3. Simplify rule logic (avoid nested AND/OR)
4. Consider caching for high-traffic campaigns

Analytics and Monitoring

Key Metrics to Track

Win Rate by Segment:

• General users win rate
• Conditional-eligible users win rate
• Compare configured vs. actual rates

Eligibility Rule Performance:

• How many users qualify for each conditional result?
• Which rules are most/least effective?
• Are rules too restrictive or too broad?

Prize Distribution:

• Are conditional prizes being won?
• Inventory depletion rates by result type
• Cost per win by segment

Optimization Insights

If conditional results are rarely won:

• Rules may be too restrictive
• Probability may be too low
• Target segment may be too small

If general results are exhausted quickly:

• Increase inventory limits
• Adjust probability distribution
• Add more general results

If fallback rate is too high:

• Increase total success probability
• Review if conditional results are working
• Check if users understand how to qualify

FAQ

Q: Can a user win multiple results? A: No, each user gets one result per instant win interaction. The system selects the best available result they qualify for.

Q: What happens if a user qualifies for multiple conditional results? A: They enter the pool for all eligible conditional results plus general results. The system randomly selects based on probability weights.

Q: Can I change eligibility rules after launch? A: Yes, but changes only affect future instant win attempts. Past results are not retroactively updated.

Q: Do eligibility rules work with Spin to Win cards too? A: Yes! The same eligibility rule system applies to both Instant Win and Spin to Win cards.

Q: Can I use time-based eligibility rules? A: Yes, you can create rules based on time of day, day of week, or specific date ranges using contact properties or form fields.

Q: What if no users qualify for a conditional result? A: The probability is redistributed to other available results. If no success results are available, users get the fallback.

Q: Can I have conditional results without any general results? A: Technically yes, but not recommended. Users who don’t qualify for any conditional result would immediately get fallback (0% win chance for non-eligible users).

Q: How do I test eligibility rules? A: Use the preview mode with test contacts that have different properties, or create test entries and check the eligibility evaluation logs.

Q: Can eligibility rules reference external data? A: Not directly. Rules can only use contact properties, list membership, subscriptions, loyalty balance, and form fields stored in Komo.

Q: What’s the maximum number of conditional results I can have? A: There’s no hard limit, but for performance and user experience, we recommend 3-5 conditional result tiers maximum.

Related Documentation

• Instant Win Cards - General instant win setup
• Eligibility Rules - General eligibility rule concepts
• Spin to Win Cards - Spin to win with eligibility rules
• Contact Properties - Managing contact data for rules
• Contact Lists - Using lists in eligibility rules
• Loyalty Program - Setting up loyalty-based rules
• Prizes and Comms - Prize configuration

---

Need Help? Contact [e-mail] for assistance with eligibility rule configuration.