Event Settings

Overview

Events are the core actions in the Lynes Loyalty backend. When creating events in the dashboard, various settings can be configured to determine how and when users earn rewards. It is also possible to create events without rewards, such as for tracking streaks based on an event.

Event Configuration Fields

When creating or editing an event in the dashboard, the following fields can be configured:

Basic Information

• ID: Unique identifier for the event (used in API calls)
• Name: Display name for the event
• Description: Detailed explanation of the event

Event Types

Events can be categorized into three types, each with their own specific settings:

Fix Events

Fixed events are simple, one-time actions that award a set number of points upon completion.

• Maximum Completions: How many times a user can complete this event (e.g., once per day, unlimited, etc.)
• Reward: Fixed amount of points awarded upon completion

Example: Login event that awards 10 points each time a user logs in, with a maximum of once per day.

Conditional Events

Conditional events only trigger rewards when a specific threshold is met.

• Maximum Completions: How many times a user can receive rewards for this event
• Condition: A numerical threshold that must be met or exceeded to trigger the reward
  • The API call includes an "amount" parameter that is compared against this condition
  • Reward is only given if the amount is greater than or equal to the condition
• Reward: Fixed amount of points awarded when the condition is met

Example: "Watch 5 minutes of video" event that awards 20 points when a user watches at least 5 minutes (condition: 5).

Transactional Events

Transactional events award points based on the value of a transaction or action.

• Maximum Completions: How many times a user can receive rewards for this event
• Maximum Points Per Event: Cap on the total points a user can earn for a single instance of this event
• Reward Per X (Amount): Points awarded per unit of the transaction amount

Example: "Purchase" event that awards 2 points per $1 spent, with a maximum of 500 points per purchase.

Reward Settings

Optional Rewards

• Events can be created with or without rewards
• Non-rewarding events can be useful for tracking purposes or as components of streak systems

User Group Specific Rewards

• Rewards can be configured either:
  • Uniformly for all user groups
  • Individually for each user group (e.g., subscribers vs. non-subscribers)

Reward Structures by Event Type

Gamification Without Direct Rewards

Events play a crucial role in gamification beyond just direct point rewards. Non-rewarding events can be utilized to:

Benefits of Non-Rewarding Events

Using events without direct rewards offers several advantages:

• Cleaner Analytics: Track user behavior without skewing actions through point incentives
• Future Flexibility: Capture event data now that you might want to reward later
• Reduced Point Inflation: Prevent your economy from becoming devalued by too many point-earning opportunities
• Intrinsic Motivation: Foster engagement based on interest and enjoyment rather than external rewards
• Complementary Systems: Build holistic gamification by combining direct rewards with achievement systems
• Progressive Disclosure: Introduce users to your platform through guided experiences before introducing rewards

Streaks

Track consecutive actions to build user habits:

• Daily logins
• Weekly content consumption
• Monthly purchases
• Consecutive completion of specific actions

These events may not directly award points but contribute to streak counters that can trigger separate rewards or achievements.

Challenges

Events can be components of larger challenges:

• Track progress toward multi-step goals
• Serve as building blocks for missions or quests
• Enable badge/achievement systems based on event completion patterns

User Journey Tracking

Non-rewarding events help map the user's journey through your platform:

• Onboarding milestone completion
• Feature discovery and usage
• Progression through different levels of engagement

Behavioral Analytics

Events can provide valuable insights about user behavior even without rewards:

• Identify common usage patterns
• Discover user preferences
• Understand engagement cycles

By combining rewarding and non-rewarding events, you can build a comprehensive gamification system that drives engagement through multiple psychological motivators beyond just point accumulation.

Example Configuration

Here's an example of how different events might be configured: