Points System
Points are the core currency of FanFest's engagement system. Every meaningful fan interaction on the platform earns points, which accumulate in wallets, drive leaderboard rankings, and unlock rewards.
How Points Are Earned
Fans earn points through two categories of actions:
Platform Actions (Automatic)
These are built-in actions that the platform tracks automatically. They cover core engagement behaviors:
| Action Type | Description |
|---|---|
| Show attendance | Watching a live or recorded show |
| Contest participation | Entering quizzes, raffles, or polls |
| Chat activity | Sending messages in show chat |
| Thread engagement | Creating threads, posting replies, receiving likes |
| Onboarding | Completing account setup steps |
Each platform action has a base point value defined by system administrators through the Action Points management panel.
Channel Actions (Custom)
Channel operators can define custom actions that map to specific interactions on their website or application. For example:
- "Browsed Tickets" -- a fan views ticket inventory
- "Newsletter Subscription" -- a fan signs up for email updates
- "Merchandise Purchase" -- a fan completes a purchase
Channel actions are linked to platform-level App Actions that define the base reward rules. See Creating a Channel Action for setup instructions and Tracking Events for connecting these actions to your website.
Wallets
Points are stored in wallets that track each fan's balance within a channel.
Channel Wallet
Every fan has a channel wallet that accumulates all points earned within a channel, regardless of community. This wallet provides the total balance displayed on leaderboards and in a fan's profile.
Community Wallet
When a channel has multiple communities, fans also have community wallets that track points earned within each community's context. This enables community-scoped leaderboards and targeted rewards.
Transactions
Every point-earning event creates a wallet transaction that records the details of the award.
Transaction Fields
| Field | Description |
|---|---|
| Points | The number of points earned in this transaction |
| Multiplier Applied | The points multiplier factor (default 1.0, higher for premium members) |
| Source Experience | The show, contest, or thread that triggered the points |
| Status | Either on_hold (pending settlement) or settled (finalized) |
| Retention Expiry | Optional expiration date for the transaction |
| App Action | The platform-level action that matched |
| Channel Action | The channel-specific action, if applicable |
Transaction Statuses
- On Hold: Points have been awarded but are pending settlement. This status is used during live events where points may be adjusted (e.g., a contest result reversal).
- Settled: Points are finalized and fully counted toward the fan's wallet balance and leaderboard position.
Flow Types
Transactions are categorized by the context in which they were earned:
| Flow Type | Context |
|---|---|
contest | Quiz, raffle, or poll participation and winnings |
show | Show attendance and engagement |
thread | Thread creation, replies, and likes |
onboarding | Account setup and first-time actions |
bonus | Manual rewards and leaderboard prize distributions |
chat | Chat message activity during shows |
Points Multiplier
Fans with a premium membership (Superfan tier) earn points at an elevated rate. The multiplier is applied automatically to every transaction and is recorded in the multiplier_applied field.
The leaderboard section displays a promotion encouraging non-premium fans to upgrade. See Memberships for configuring membership tiers.
Viewing Activity
Fans can view their own engagement activity through the Activity Modal, accessible by clicking on their name in the leaderboard. This modal provides two views:
Summary Tab
An aggregated overview of points earned, grouped by action type. This gives fans a quick understanding of which activities contribute most to their score.
Activity Tab
A chronological list of individual transactions showing exactly when and how each batch of points was earned.
Points and Gating
Points can be used as criteria for access gating. Channel admins can require fans to have earned a minimum number of points (within a configurable time window) before they can access certain content. This creates a natural progression system where engagement unlocks new experiences.
Time window options include:
- All time -- Total points earned since the fan joined
- Custom time ranges for seasonal or periodic gating
See the Channels section for more on configuring content access rules.
Related
- Leaderboards -- How points feed into rankings and prizes
- Tracking Events -- Connecting external actions to the points system
- Memberships -- Premium membership with points multiplier