> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/gamification-basics/points.md). # Points, Gems and Diamonds ## **Points overview** In the gamification system, **Points** serve as the central currency that fuels player engagement, progression, and rewards. They represent a player's activity, achievements, and interaction with the platform. Accumulating points not only unlocks access to exclusive marketplace items, but also motivates continued participation through a sense of accomplishment and competition. ### Points Balance vs. Lifetime Points (Points Ever) Smartico tracks two distinct point metrics for every player: * **Points Balance (`ach_points_balance`)**: The current spendable balance. This balance increases when points are earned and decreases when points are spent on Store items, Tournament buy-ins, Clan fees, or Mini-game plays. * **Lifetime Points (`ach_points_ever`)**: The all-time cumulative points earned by the player. This metric is monotonic (it never decreases when points are spent in the Store) and serves as the default calculation base for Level progression and historical engagement.
Players can earn points through various gamification features—like tournaments, MatchX, quizzes, minigames, badges, prize drops etc. However, there are **three primary earning channels**, each designed to promote distinct types of behavior and interaction. ### Completing Missions and accompanied Tasks Points can be awarded for: * Finishing individual tasks within a mission * Completing all tasks in a mission This is managed via the **Gamification → Missions** section, where rewards can be configured per task or for full mission completion. **Examples:** * A mission with two tasks - *“Make 5 bets”* and *“Deposit 10 EUR”* - may grant **10 points** once both tasks are completed. * A mission with three tasks - *“Login 5 days in a row”*, *“Win 100 times in a day”*, and *“Make your 5th deposit”* — may award different point values for each task individually. ### Ranking on Leaderboard Players earn points by securing top positions on leaderboards. **Example:** * A **Weekly Leaderboard** might reward the top 5 players with: * 1st place: 100 Points * 2nd place: 50 Points * 3rd place: 30 Points * 4th place: 20 Points * 5th place: 10 Points ### Performing Product-Specific Action These actions are controlled in the Marketing → Automation Rules section. Points can be awarded based on player behavior and predefined criteria. **Examples of Rules:** * For every **100 EUR deposit**, a player receives **20 Points** * For **daily logins**, a player earns **3 Points per day** **Examples of Advanced Rules:** * Tiered deposits: * <100 EUR → 1 Point per EUR * 100–499 EUR → 2 Points per EUR * ≥500 EUR → 3 Points per EUR * Geographic segmentation: * Players from **Australia** → 1 Point per EUR * Players from **other regions** → 0.5 Points per EUR * Level-based rewards: * Levels 1–5 → 1 Point per EUR * Levels 6–15 → 2 Points per EUR * And so on... You can also use your existing Marketing segments to differentiate players and define points accumulation and if specific players are eligible for such rules at all. ### **Points accumulation analysis** Once gamification is active, you can begin analyzing player behavior across different point sources. One key metric to monitor is the **ratio of Points Collected to Points Spent in the Marketplace**. This ratio serves as a strong indicator of player engagement - highlighting how actively your audience participates in earning rewards and how motivated they are to spend them.

BO: Points collected analysis

You can access full analytics for all three currencies in the Back-Office under **Reports → Gamification → Points, Gems, Diamonds**. This report provides breakdown views of currency distributed and spent over time, top earning sources (Missions, Tournaments, Mini-games, Automation Rules), Store redemption velocity, and balance distribution across player tiers. ## Gems & Diamonds These two new virtual currencies are designed to enhance customization and elevate the gamification experience. These currencies, referred to internally as Gems and Diamonds, are distinct from one another, allowing you the flexibility to use both or just one based on your preferences. For example, additional currency can be utilized for exclusive items accessible only for the selected currency. {% hint style="info" %} The names "Gem" and "Diamond" are default names defined by Smartico. You can override these names in the Tools \ Translations. {% endhint %} ### Managing balances of Gems & Diamonds * From the campaigns, using new activities - add, deduct & reset {% hint style="info" %} You can Add/Deduct/Reset solely Gems, solely Diamonds or both Gems & Diamonds together with the same activity. {% endhint %}

BO: The activities you can use in the Flow builder

* From automation rules, using the same type of activities

BO: Example of setting up Gems & Diamonds activity in Automation

* Rewardings with gems & diamonds from Missions, Tournaments, Mini-games, Lootbox, Prize drop, Raffles

BO: Example of setting up Gems & Diamonds as rewards in Missions

* Making manual adjustments from the user profile

BO: Visualisation of the different types of manual adjustments

### Usage in the Store The store now includes the option to purchase items using Gems or Diamonds, providing greater flexibility. This feature allows you to designate certain items as exclusive or segment them to create an additional tier of items that can only be acquired using these new virtual currencies.

BO: Set up window for store item that can be bought with Gems

{% hint style="info" %} You can set up item exchanges in the store by allowing users to exchange points for gems or diamonds {% endhint %}

GF: Example of exchange store item. Buy 3 diamonds with 1000 points.

For complete details on configuring multi-currency items, category restrictions, and purchase limits, see the [Store](/welcome/products/gamification-basics/marketplace.md) guide. ### Gems & Diamonds events Four new events have been introduced to act on balance changes for the newly added virtual currencies: * Gamification: diamonds deducted * Gamification: diamonds added * Gamification: gems deducted * Gamification: gems added You can use these events: * To communicate to players whenever they have changes in the currencies using real-time campaigns * To set automation rules to run additional activities whenever the balance is changed. E.g., whenever a player gets a diamond to run Web Hook to report the change to the external API. * Build missions and badges. E.g. Mission "Collect 10 diamonds" Two new properties have been introduced to provide the actual balance data for the newly added virtual currencies: * Gamification: diamonds current balance * Gamification: gems current balance You can use these properties in the segmentation to find players with a specific amount in their balance. ### Presentation in the gamification widget Gems and Diamonds will be visible in the header of the Gamification section and can be fully customizable to match your preferences. * You can define which of the currencies to show * On which positions to place them * You are free to use all 3 currencies or only some of them.

Gamification: Visualisations of Gems and Diamonds in the header

You can configure counter visibility and click behavior for Desktop and Mobile widgets under Settings → Label settings → Widget.

BO: Counter settings for Gems and Diamonds

### Availability in the APIs and Data Warehouse Balances of new currencies can be retrieved on the front-end using the following code in JavaScript. ```javascript _smartico.api.getUserProfile() ``` The response will contain all balances: ```javascript { "ach_points_ever": 140, "ach_points_balance": 70, "ach_diamonds_balance": 0, "ach_gems_balance": 0 } ``` You can also track the change of the balances on the front-end in real time and get notifications, explained in detail in the extended guide for JavaScript - The transactional history for all changes for Gems and Diamonds balances is available in Smartico DWH as explained here - ### External APIs and Batch Import Operators can also manage balances programmatically or via batch file imports: * **External API Integration**: Server-to-server endpoints allow external platforms to credit, debit, or set user balances for Points, Gems, and Diamonds. * **User CSV Import**: Batch adjust points, gems, or diamonds using CSV import under **Marketing → CSV Import** by including currency columns alongside the desired operation (Add, Deduct, or Set).
### Frequently Asked Questions **Q: What is the difference between Points Balance and Lifetime Points (Points Ever), and which should I use in segments?**\ A: Points Balance (`ach_points_balance`) is the spendable wallet that decreases when players purchase items or pay tournament fees. Lifetime Points (`ach_points_ever`) accumulates monotonically and never decreases, serving as the basis for Level progression. To target players who currently have currency to spend in the Store, use Points Balance in your segment; to target players based on total historical engagement or VIP standing, use Lifetime Points. **Q: How do I activate Gems and Diamonds if they are not visible in my Back-Office?**\ A: Gems and Diamonds are available as a gamification extension. To show them in the player widget, enable their counters under **Settings → Label settings → Widget**. If the currency activities or store purchase options do not appear in your Back-Office, submit a request to your Account Manager or Support team (referencing feature activation for Gems and Diamonds) to enable the feature flag for your label. **Q: Do Gems and Diamonds contribute to player Level progression or Leaderboard rankings?**\ A: No. By default, only Points (`ach_points_ever` and period points) advance Level progression and default Leaderboard ranks. Gems and Diamonds function as independent secondary and tertiary currencies specifically intended for exclusive store items, mini-game buy-ins, or custom campaign rewards. **Q: Can I award Gems and Diamonds dynamically based on player behavior or formulas?**\ A: Yes. In Campaign Flows and Automation Rules, the Add Gems & Diamonds activity allows choosing between a fixed amount and a dynamic calculation using JavaScript expressions or Dynamic Formulas based on event properties and player attributes. **Q: Where can players view their currency transaction history?**\ A: Players can view recent balance additions and deductions directly within the gamification widget Activity Log. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://help.smartico.ai/welcome/products/gamification-basics/points.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.