Gems & Diamonds

We are introducing two new virtual currencies 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.

Note: The names "Gem" and "Diamond" are default names defined by Smartico; you can override these names in the Tools \ Translations.

Managing balances of Gems & Diamonds

From the campaigns, using new activities - add, deduct & reset

You can Add/Deduct/Reset solely Gems, solely Diamonds or both Gems & Diamonds together with the same activity.

From automation rules, using the same type of activities

Example of setting up Gems & Diamonds activity in Automation

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

Example of setting up Gems & Diamonds as rewards in Missions

Making manual adjustments from the user profile

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.

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

You can set up item exchanges in the store by allowing users to exchange points for gems or diamonds

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

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.

You can configure counters visibility for Desktop and Mobile widgets on the Label \ Label, settings \ Widget screen

Availability in the APIs and Data Warehouse

Balances of new currencies can be retrieved on the front-end using the following code in JavaScript.

_smartico.api.getUserProfile()

The response will contain all balances:

{
"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 - https://help.smartico.ai/welcome/technical-guides/front-end-integration/extended-integration#user-profile-details

The transactional history for all changes for Gems and Diamonds balances is available in Smartico DWH as explained here - https://help.smartico.ai/welcome/technical-guides/smartico-data-warehouse/smartico-dwh-gamification-views#dwh_ext_xxx.g_gems_diamonds_change_log

Last updated

Was this helpful?