Achievements

Achievements are milestone badges that reward customers for specific accomplishments. They create memorable moments of recognition and provide additional points rewards. This guide covers everything you need to know about creating and managing achievements for your loyalty program.

Understanding Achievements

Achievements are permanent badges that customers earn by completing specific milestones. Unlike challenges, achievements don't expire and are always available for customers to work toward.

Key Characteristics

• Permanent: Once earned, achievements remain on the customer's profile
• Trigger-Based: Automatically awarded when conditions are met
• Points Rewards: Each achievement can award bonus points
• Visual Recognition: Displayed as badges in the mobile app
• One-Time or Repeatable: Can be earned once or multiple times

Purpose of Achievements

1. Celebrate Milestones: Mark significant customer accomplishments
2. Encourage Exploration: Motivate customers to try new behaviors
3. Boost Engagement: Provide collection/completion goals
4. Reward Loyalty: Give tangible recognition for continued usage

---

Achievement Trigger Types

Achievements are awarded when specific triggers are met. The system supports these trigger types:

Total Rides (rides_count)

Award based on cumulative lifetime ride count.

Use case: Reward overall usage milestones.

Distance Traveled (distance_km)

Award based on cumulative kilometers traveled.

Use case: Reward distance-based milestones.

Streak Days (streak_days)

Award for maintaining consecutive riding days.

Use case: Encourage daily ridership habits.

First Ride (first_ride)

Award for completing the very first ride.

Use case: Celebrate new customer onboarding.

Parking Zone Ends (parking_zone)

Award for ending rides in designated parking zones.

Use case: Encourage proper parking behavior.

Weekend Rides (weekend_rides)

Award for rides taken on weekends (Saturday/Sunday).

Use case: Drive weekend usage.

Points Earned (points_earned)

Award based on cumulative loyalty points earned.

Use case: Reward overall program engagement.

Eco Distance (eco_distance)

Award based on estimated CO2 savings from rides.

CO2 Calculation: The system estimates CO2 savings using the formula:

CO2 Saved (kg) = Distance (km) × 0.12

This assumes replacing a car trip with an electric vehicle ride saves approximately 120 grams of CO2 per kilometer.

Use case: Promote environmental consciousness.

Time of Day (time_of_day)

Award for rides completed during specific hours.

Use case: Recognize off-peak riders or specific time-based behaviors.

Tier Reached (tier_reached)

Award when a customer reaches a specific loyalty tier.

Use case: Celebrate tier milestones with additional recognition.

Monthly Rides (monthly_rides)

Award for completing a certain number of rides within a calendar month.

Use case: Encourage consistent monthly usage.

Referrals (referrals)

Award based on successful referral count.

Use case: Recognize top referrers.

---

Creating Achievements

Step-by-Step Guide

1. Access Achievements Page

   • Navigate to Dashboard > Loyalty > Achievements
   • Or go directly to /dashboard/loyalty/achievements/

2. Click "New Achievement"

   • Opens the achievement creation modal

3. Fill in Basic Information

   • Name: Customer-facing achievement name (e.g., "First Ride")
   • Description: How to earn this achievement (e.g., "Complete your first ride")

4. Configure Trigger

   • Trigger Type: Select from available types
   • Target Value: Set the threshold to earn

5. Set Reward

   • Points Reward: Bonus points awarded when earned

6. Configure Appearance

   • Badge Color: Select a hex color for the badge

7. Optional Settings

   • Repeatable: Allow earning multiple times
   • Cooldown Days: Minimum days between repeated earnings
   • Secret: Hide until earned

8. Save Achievement

---

Configuring Achievement Settings

Form Fields Explained

Basic Information

Trigger Configuration

Reward Configuration

Appearance

Behavior Settings

Example Configuration

Century Club Achievement:

Name: Century Club
Description: Complete 100 rides and join an elite group of riders
Trigger Type: Total Rides (rides_count)
Target Value: 100
Points Reward: 1000
Badge Color: #F59E0B (Gold)
Repeatable: No
Secret: No

---

Repeatable Achievements

Some achievements can be earned multiple times. This is useful for ongoing rewards:

How Repeatable Achievements Work

1. Customer earns achievement for the first time
2. Counter resets (if cooldown is set, must wait)
3. Customer can work toward earning again
4. Each earning awards the points reward again

Cooldown Period

Set a minimum time between earnings to prevent exploitation:

Example: Weekly Warrior

Name: Weekly Warrior
Description: Complete 5 rides in a week
Trigger Type: Total Rides (rides_count)
Target Value: 5 (weekly count)
Points Reward: 50
Repeatable: Yes
Repeat Cooldown Days: 7

---

Secret Achievements

Secret achievements add an element of surprise and discovery:

Characteristics

• Not shown in the achievement list until earned
• Create "surprise and delight" moments
• Encourage sharing and word-of-mouth
• Great for special or rare accomplishments

When to Use Secret Achievements

Example: Secret Achievement

Name: Night Owl
Description: Complete a ride after midnight
Trigger Type: Time of Day (time_of_day)
Target Value: 0 (midnight)
Points Reward: 100
Secret: Yes

---

Managing Achievements

Viewing All Achievements

The achievements page shows:

• Statistics Cards:

  • Total Achievements (active count)
  • Total Earned (sum of all customer earnings)
  • Most Popular (highest earned achievement)

• Achievement Cards:

  • Name and description
  • Trigger type and value
  • Points reward
  • Times earned count
  • Repeatable/Inactive badges

Editing an Achievement

1. Find the achievement card
2. Click the pencil (Edit) icon
3. Modify settings
4. Click "Update"

Deactivating an Achievement

1. Find the achievement card
2. Click the trash (Delete) icon
3. Confirm deactivation

What happens:

• Achievement is marked inactive
• No longer shown to new customers
• Existing earned records are preserved
• Can be reactivated by editing

Viewing Earning Statistics

Each achievement card shows:

• Times Earned: Total number of times earned by all customers
• Helps identify popular vs. rarely-achieved goals

---

Mobile App Experience

Achievement Display

The mobile app shows achievements in a horizontal scrolling gallery:

Earned Achievements:

• Full-color badge icon
• Achievement name
• Points earned displayed

Locked Achievements:

• Grayed-out badge icon
• Lock overlay
• Achievement name (unless secret)
• Points available

Achievement Summary

The app header shows:

Achievements: 8/15 earned

Where:

• 8 = Achievements earned by customer
• 15 = Total available achievements (non-secret)

Earning Notification

When a customer earns an achievement:

1. Achievement unlocks visually
2. Points are added to balance
3. Achievement appears in recent activity

---

Best Practices

Achievement Design

1. Create a Progression

   • Design achievements that build on each other
   • Example: 10 rides → 25 rides → 50 rides → 100 rides

2. Balance Difficulty

   • Mix of easy, medium, and hard achievements
   • Most customers should earn 3-5 within first month
   • Some should be truly aspirational

3. Reward Proportionally

   • Easy: 50-100 points
   • Medium: 100-500 points
   • Hard: 500-2000 points
   • Legendary: 2000+ points

Recommended Starter Set

Tips for Success

1. Launch with 8-12 achievements - Enough variety without overwhelming
2. Add 1-2 new achievements monthly - Keep it fresh
3. Use secret achievements sparingly - 2-3 is enough
4. Track earning rates - Adjust difficulty if too easy or hard
5. Promote difficult achievements - Highlight customers who earn rare badges

---

Frequently Asked Questions

General Questions

Q: Can customers lose achievements they've earned? A: No, once earned, achievements are permanent.

Q: Are achievements account-specific? A: Yes, each account/fleet can have its own achievements.

Q: Can I create the same achievement for multiple subaccounts? A: Yes, you'll need to create it separately for each subaccount.

Trigger Questions

Q: When are achievements checked? A: After every ride completion, the system checks all applicable triggers.

Q: What if a customer meets multiple achievement criteria at once? A: All applicable achievements are awarded simultaneously.

Q: Can I use custom trigger logic? A: Not currently. Contact support for complex trigger requirements.

Reward Questions

Q: Do achievement points count toward tier qualification? A: No, only ride spending counts toward tier progress. Achievement points are bonus.

Q: Can I award something other than points? A: Currently, achievements only award points. Wallet credits can be done through challenges.

Q: Is there a limit to points I can award? A: Technically no, but we recommend keeping individual achievements under 10,000 points.

Technical Questions

Q: What happens to achievements if I delete them? A: They're deactivated but customer earning records are preserved.

Q: Can I edit an achievement's trigger after creation? A: Yes, but it won't retroactively award or revoke from customers.

Q: How do I make achievements available to all subaccounts? A: Create them for each subaccount individually, or contact support for bulk creation.

---

Technical Reference

Trigger Type Mapping

Database Schema

achievements table:

customer_achievements table:

API Endpoints

---