Gamification

Amba provides a complete gamification system. Combine XP rules, achievements, leaderboards, and challenges to create compelling engagement loops.

Features

• XP and Levels — Auto-award XP when users track events, with daily caps and cooldowns
• Achievements — Badges that unlock automatically based on criteria (event count, streak length, XP threshold)
• Leaderboards — Rank users by XP, streak length, or custom metrics with daily/weekly/monthly periods
• Challenges — Time-limited goals with XP and achievement rewards

How they work together

A typical engagement loop:

1. User completes an action (e.g., "workout_completed")
2. XP rule fires: +50 XP for "workout_completed"
3. Achievement checks: "First Workout" unlocks (event_count >= 1) with +100 bonus XP
4. Leaderboard updates: user moves up the weekly XP rankings
5. Challenge progress: "7-Day Fitness Sprint" advances by 1

All of this happens automatically when the user calls client.track('workout_completed').