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

# Achievements

> Gamified milestone tracking that rewards customers for cumulative engagement with the brand.

Achievements are cumulative goals that customers reach by interacting with a brand in predetermined ways. They bring a gamification element to the incentive program, customers progress through levels as they accumulate counts, unlocking rewards or benefits at each milestone.

## Key characteristics

* A customer **cannot lose an Achievement Level**: unlike Tiers, achievement progress only goes forward
* Customers can hold **multiple Achievements simultaneously**
* Achievements are attached to a profile for the **lifetime of their relationship** with the brand
* Achievements can operate **independently or in conjunction** with the broader incentive suite

## Structure: counts and levels

An Achievement is made up of:

**Counts**: increments that go up by 1 each time a qualifying event occurs. Counts are tracked automatically via Omneo events or via the Achievements API.

**Levels**: thresholds defined within an Achievement. When a Count crosses a Level threshold, the customer "levels up." Levelling up can trigger other incentives (Rewards, Benefits).

## Level strategies

Brands can structure achievements in different ways:

| Strategy       | Description                                                    | Example                                       |
| -------------- | -------------------------------------------------------------- | --------------------------------------------- |
| **On/Off**     | 1 Level achieved at Count 1. Binary, either earned or not.     | "First purchase made" badge                   |
| **Linear**     | Level up every X counts. Infinite progression.                 | "Level up every 10 purchases"                 |
| **Non-linear** | Early levels are easy; higher levels get progressively harder. | "Level up at 1, 5, 10, 25, 50, then every 50" |

## Achievement visibility

Achievements can be configured with different visibility modes:

| Mode         | Description                                                                |
| ------------ | -------------------------------------------------------------------------- |
| **Standard** | Visible to the customer, including instructions for how to earn            |
| **Hidden**   | Not visible until unlocked by reaching Count 1 or more                     |
| **Mystery**  | Visible as earnable with an optional hint, but not revealed until unlocked |
| **System**   | Never shown to customers, used for internal logic or reporting             |

## Achievements vs tiers

|                    | Tiers                      | Achievements                   |
| ------------------ | -------------------------- | ------------------------------ |
| Progress direction | Can go up or down          | Only goes up                   |
| Count per customer | One tier at a time         | Multiple simultaneously        |
| Reset mechanism    | Annual anniversary review  | Lifetime accumulation          |
| Primary use        | High-value customer status | Gamified engagement milestones |

## When to use achievements

Achievements are most effective when:

* You want to reward engagement beyond spending (profile completion, referrals, event attendance)
* Your tier program is getting overly complex: Achievements can handle non-financial milestones separately
* You want to create a sense of discovery and progress for customers

## Displaying achievements

Achievements can be shown in CX Manager, Clienteling, Profile Portal, and via the Omneo SDK for embedded experiences.