> ## Documentation Index
> Fetch the complete documentation index at: https://help.fanaura.com/llms.txt
> Use this file to discover all available pages before exploring further.

# VIP Tiers & Engagement

> Fanaura's VIP tier system lets you identify, reward, and engage your most dedicated fans. Learn how engagement scores, tokens, and tiers work together.

Your fans are not all the same. Some discover your music once and move on. Others pre-save every release, buy merch on day one, RSVP to every show, and tell all their friends. Fanaura's VIP tier system helps you identify those superfans, reward their loyalty, and give them a reason to keep showing up.

The system has two interconnected parts: the **Engagement Score** (a real-time measure of how active a fan is) and the **VIP Tier** (a loyalty level based on total tokens earned). Together, they give you a complete picture of who your most valuable fans are.

***

## Engagement Score

### What It Is

Every fan in your database has an engagement score from 0 to 100. This score is a real-time composite measure of how active and engaged the fan is with your content, marketing, and releases.

### How It Is Calculated

The engagement score weighs recent activity more heavily than older activity. A fan who was very active six months ago but has gone silent will see their score decline over time. A fan who just started engaging will see their score climb quickly.

<Tabs>
  <Tab title="Score Boosters">
    | Activity                    | Impact     |
    | --------------------------- | ---------- |
    | Pre-saving a release        | High       |
    | RSVPing to an event         | High       |
    | Purchasing merch            | High       |
    | Replying to SMS             | Medium     |
    | Opening an email            | Low-Medium |
    | Clicking a link in an email | Medium     |
    | Clicking a smart link       | Low-Medium |
    | Completing a flow step      | Low        |
    | Engaging with Instagram DM  | Medium     |
  </Tab>

  <Tab title="Score Reducers">
    | Factor                                   | Impact          |
    | ---------------------------------------- | --------------- |
    | Time without activity (inactivity decay) | Gradual decline |
    | Opting out of a channel                  | Moderate drop   |
    | Email bounces                            | Slight drop     |
  </Tab>
</Tabs>

### Reading the Score

| Score Range | What It Means                                                               |
| ----------- | --------------------------------------------------------------------------- |
| **80-100**  | Superfan. This person is deeply engaged and likely shows up for everything. |
| **60-79**   | Highly engaged. Active across multiple touchpoints. A strong supporter.     |
| **40-59**   | Moderately engaged. Interacts occasionally but not consistently.            |
| **20-39**   | Low engagement. May have signed up but is not very active.                  |
| **0-19**    | Dormant. Either new with no activity yet, or has gone quiet.                |

<Tip>Use the engagement score to time your asks. A fan with a high engagement score is more likely to convert on a call to action (buy merch, buy tickets, share a link). Target high-engagement fans for your most important asks.</Tip>

### Where You See It

The engagement score appears in several places:

* Fan Directory (as a column you can sort by)
* Fan Profile header (as a circular progress indicator)
* List stats (as an average across list members)
* Flow conditions (to branch based on engagement level)

***

## VIP Tier System

### How It Works

While the engagement score measures *current* activity, the VIP tier reflects *cumulative* loyalty. Fans earn tokens for various actions, and their total token count determines their tier.

Think of tokens like frequent flyer miles — they accumulate over time and unlock progressively better rewards.

### The Five Tiers

<CardGroup cols={5}>
  <Card title="Bronze" icon="medal">
    **0 tokens**

    The starting tier for every new fan. Everyone begins here.
  </Card>

  <Card title="Silver" icon="medal">
    **100+ tokens**

    Early-stage engaged fans who have taken a few meaningful actions.
  </Card>

  <Card title="Gold" icon="medal">
    **500+ tokens**

    Consistently engaged fans who regularly interact with your music and marketing.
  </Card>

  <Card title="Platinum" icon="gem">
    **2,000+ tokens**

    Highly engaged superfans who show up across multiple channels and touchpoints.
  </Card>

  <Card title="Diamond" icon="gem">
    **10,000+ tokens**

    Your most dedicated fans. The ones who have been with you through thick and thin. These are rare and precious.
  </Card>
</CardGroup>

### Tier Progression Example

Here is what a fan's journey to Diamond might look like:

<Steps>
  <Step title="Sign up via pre-save (50 tokens)">
    Bronze tier, 50 total tokens.
  </Step>

  <Step title="Opens 3 emails (15 tokens)">
    Bronze tier, 65 total tokens.
  </Step>

  <Step title="RSVPs to a show (30 tokens)">
    Bronze tier, 95 total tokens.
  </Step>

  <Step title="Clicks a link in an email (10 tokens)">
    Levels up to **Silver**! 105 total tokens.
  </Step>

  <Step title="Buys a t-shirt (100 tokens)">
    Silver tier, 205 total tokens.
  </Step>

  <Step title="Completes profile + pre-saves another release (75 tokens)">
    Silver tier, 280 total tokens.
  </Step>

  <Step title="Refers a friend (200 tokens)">
    Silver tier, 480 total tokens.
  </Step>

  <Step title="Opens 4 more emails (20 tokens)">
    Levels up to **Gold**! 500 total tokens.
  </Step>

  <Step title="Continues engaging over months...">
    Reaches 2,000 tokens and levels up to **Platinum**!
  </Step>

  <Step title="Dedicated fan for a year or more...">
    Reaches 10,000 tokens and levels up to **Diamond**!
  </Step>
</Steps>

***

## How Fans Earn Tokens

Every meaningful action earns tokens. Here are the default token values:

<Tabs>
  <Tab title="Releases & Events">
    | Action                           | Default Tokens |
    | -------------------------------- | -------------- |
    | **Pre-save a release**           | 50 tokens      |
    | **RSVP to an event**             | 30 tokens      |
    | **Attend an event** (if tracked) | 75 tokens      |
  </Tab>

  <Tab title="Purchases">
    | Action                              | Default Tokens |
    | ----------------------------------- | -------------- |
    | **Merch purchase**                  | 100 tokens     |
    | **High-value purchase** (over \$50) | 150 tokens     |
  </Tab>

  <Tab title="Email Engagement">
    | Action                       | Default Tokens |
    | ---------------------------- | -------------- |
    | **Open an email**            | 5 tokens       |
    | **Click a link in an email** | 10 tokens      |
  </Tab>

  <Tab title="SMS Engagement">
    | Action                     | Default Tokens |
    | -------------------------- | -------------- |
    | **Reply to an SMS**        | 15 tokens      |
    | **Click a link in an SMS** | 10 tokens      |
  </Tab>

  <Tab title="Profile & Social">
    | Action                     | Default Tokens |
    | -------------------------- | -------------- |
    | **Complete their profile** | 25 tokens      |
    | **Refer a friend**         | 200 tokens     |
    | **Share on social media**  | 25 tokens      |
  </Tab>

  <Tab title="Bonus Events">
    | Action                           | Default Tokens                                            |
    | -------------------------------- | --------------------------------------------------------- |
    | **Birthday bonus**               | 100 tokens (awarded annually on their birthday)           |
    | **Anniversary bonus**            | 150 tokens (awarded on the anniversary of becoming a fan) |
    | **First interaction in 30 days** | 10 tokens (re-engagement reward)                          |
  </Tab>
</Tabs>

<Note>Token values shown above are defaults. You can customize every value in Settings → Fan Rewards → Token Configuration.</Note>

***

## Reward Modes

Fanaura offers four reward modes that control how quickly fans progress through tiers. The right mode depends on the size of your fan base and how exclusive you want higher tiers to feel.

<CardGroup cols={2}>
  <Card title="Conservative Mode" icon="shield">
    **Timeline to Diamond:** \~3 years of consistent engagement.

    Best for artists with large, established fan bases who want Diamond to feel truly exclusive. Only the most dedicated, long-term fans reach the top.
  </Card>

  <Card title="Balanced Mode (Default)" icon="scale-balanced">
    **Timeline to Diamond:** \~1.5 years of consistent engagement.

    The recommended starting point for most artists. Rewards loyalty without giving everything away too quickly. Fans feel steady progress.
  </Card>

  <Card title="Generous Mode" icon="gift">
    **Timeline to Diamond:** \~6 months of consistent engagement.

    Best for newer artists building their fan base or for short, intense campaign periods (like an album cycle). Fans see fast progress, which can drive early excitement.
  </Card>

  <Card title="Custom Mode" icon="sliders">
    **Full control.**

    Set your own token values for every action and your own thresholds for every tier. For artists or managers who want to fine-tune the system.
  </Card>
</CardGroup>

***

## Configuring Tier Rewards

Tiers are more than just labels — they can unlock real perks for your fans. You configure what each tier earns in **Settings → Fan Rewards**.

### Reward Ideas by Tier

| Tier         | Reward Ideas                                                                                                                                    |
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Bronze**   | Welcome message, free digital download, access to fan community                                                                                 |
| **Silver**   | Early access to ticket pre-sales (30 minutes before general), 10% merch discount code                                                           |
| **Gold**     | Priority ticket access (1 hour early), 15% merch discount, exclusive behind-the-scenes content                                                  |
| **Platinum** | First access to tickets (24 hours early), 20% merch discount, exclusive livestream invites, signed merch lottery                                |
| **Diamond**  | VIP meet & greet access, free merch item per tour, 25% lifetime discount, personal thank-you message from artist, exclusive Diamond-only events |

### Setting Up Rewards

<Steps>
  <Step title="Navigate to Fan Rewards">
    Go to **Settings** → **Fan Rewards**.
  </Step>

  <Step title="Select a tier">
    Click on a tier to expand its reward configuration.
  </Step>

  <Step title="Configure rewards">
    For each tier, set the **Reward Name**, **Reward Description** (what the fan will see), **Reward Type** (discount code, early access, content unlock, or custom), and optionally trigger a flow when a fan reaches this tier.
  </Step>

  <Step title="Save your configuration">
    Click **Save**.
  </Step>
</Steps>

### Communicating Rewards to Fans

When a fan reaches a new tier, you can automatically:

* **Send a congratulations email** — "You just hit Gold! Here's what that unlocks..."
* **Send an SMS** — "Welcome to Platinum! You now get 20% off all merch. Code: PLAT20"
* **Enroll them in a tier-specific flow** — A multi-step welcome to their new tier with all the perks explained
* **Update their fan portal** — If you have a fan portal, their tier badge and available rewards update automatically

<Tip>Set up flows triggered by the "VIP Tier Change" event to automate reward delivery. This way every fan gets a personalized congratulations message the moment they level up.</Tip>

***

## Customizing Token Values

### Adjusting Individual Actions

<Steps>
  <Step title="Open Token Configuration">
    Go to **Settings** → **Fan Rewards** → **Token Configuration**.
  </Step>

  <Step title="Edit token values">
    You will see a list of every token-earning action with its current value. Click any value to edit it and enter the new token amount.
  </Step>

  <Step title="Save changes">
    Click **Save**. Changes apply going forward — existing token earnings are not recalculated.
  </Step>
</Steps>

### Adjusting Tier Thresholds

<Steps>
  <Step title="Open Tier Thresholds">
    Go to **Settings** → **Fan Rewards** → **Tier Thresholds**.
  </Step>

  <Step title="Edit thresholds">
    You will see the current token requirement for each tier. Edit any threshold.
  </Step>

  <Step title="Save and review impact">
    Click **Save**.
  </Step>
</Steps>

<Warning>Lowering a threshold may instantly promote fans who were previously below it. Raising a threshold may demote fans who are now below the new bar. Fanaura will show you a preview of how many fans would be affected before you save.</Warning>

***

## Using VIP Tiers in Your Marketing

<Tabs>
  <Tab title="In Blasts">
    Target blasts by VIP tier:

    * Send exclusive content only to Gold+ fans
    * Send re-engagement campaigns only to Bronze fans who have been inactive
  </Tab>

  <Tab title="In Flows">
    Use tier as a condition:

    * **If tier is Platinum or Diamond** → Send VIP ticket link
    * **If tier is Bronze** → Send a "Here's how to level up" message
    * **When tier changes** → Trigger a congratulations flow
  </Tab>

  <Tab title="In Lists">
    Create dynamic lists based on tier:

    * "Superfans" list: Platinum + Diamond fans
    * "Engaged Fans" list: Gold+ fans
    * "Need Re-Engagement" list: Bronze fans with engagement score below 20
  </Tab>

  <Tab title="In Smart Links">
    Show different content based on tier:

    * Diamond fans see the VIP landing page with early access
    * Bronze fans see the standard page with a call to action to engage more
  </Tab>
</Tabs>

***

## Viewing VIP Data

### On Fan Profiles

Each fan profile shows:

* Current tier badge
* Total tokens earned
* Progress bar to next tier
* Token earning history
* Tier change history

### On the Dashboard

The main dashboard includes a VIP overview widget showing:

* Total fans at each tier
* Tier distribution chart
* Recent tier upgrades
* Average tokens earned this month

### In the Directory

Sort or filter the Directory by VIP tier to quickly find fans at any level.

***

## Tips & Best Practices

<AccordionGroup>
  <Accordion title="Do not set rewards you cannot deliver">
    If you promise a meet and greet for Diamond fans, make sure you can actually do it. Start with digital rewards (discount codes, early access links, exclusive content) and add in-person experiences as you grow.
  </Accordion>

  <Accordion title="Celebrate tier upgrades publicly">
    A shoutout on social media (with permission) — "Congrats to Sarah for hitting Diamond status!" — encourages other fans to engage more and shows that you notice your supporters.
  </Accordion>

  <Accordion title="Use Generous mode for album launch campaigns">
    Switch to Generous mode for a 3-month album cycle to drive maximum engagement, then switch back to Balanced for the in-between period.
  </Accordion>

  <Accordion title="Review your tier distribution monthly">
    If 90% of your fans are still Bronze, your token values might be too low or your calls-to-action are not clear. If 40% are already Diamond, your thresholds might be too low.
  </Accordion>

  <Accordion title="Make Diamond truly special">
    Diamond should be rare — no more than 1-3% of your total fan base. These fans deserve your personal attention. Consider sending them a personal voice memo, a handwritten note, or an invite to something nobody else gets.
  </Accordion>
</AccordionGroup>

***

## What's Next

<CardGroup cols={2}>
  <Card title="Fan Profiles" icon="id-card" href="/fans/profiles">
    See VIP data on individual fan records.
  </Card>

  <Card title="Fan Lists" icon="list" href="/fans/lists">
    Create tier-based segments.
  </Card>

  <Card title="Flow Builder" icon="diagram-project" href="/flow-builder/">
    Automate tier upgrade rewards.
  </Card>

  <Card title="Settings" icon="gear" href="/settings/">
    Customize token values and tier thresholds.
  </Card>
</CardGroup>
