◾Custom fields/attributes

Smartico allows you to extend any gamification element with custom fields, enabling you to add additional data that enhances your custom UI.

What Are Custom Fields?

Custom fields are user-defined attributes that can be attached to various gamification and communication elements, such as Tournaments, Missions, Badges, Levels, Mini-Games, Store Items and Inbox. These fields are not used by Smartico’s internal logic or the default Gamification widget, but they are available for use in custom UIs built with Smartico APIs.

Example Use Case

Suppose you want to classify tournaments as VIP or Regular. You can add a custom field to a Tournament to store this information and then use it in your own UI to visually distinguish VIP tournaments.

Another example can be seen on our Expo page - https://expo.smartico.ai/widgets/api_custom_lvl_map

Custom levels UI with additional fields/attributes

By default, player levels only include:

• Name

• Description

• Image

• Progress information

Default attributes of levels

However, many casino and sportsbook operators associate player levels with perks such as cashback percentages, rakeback, or VIP status. To showcase this, we added custom fields like:

• Cashback (%)

• Monthly Rakeback (%)

• VIP Club Membership

Custom attributes

These fields are defined by the operator in Smartico BackOffice, and their values are fetched via the Smartico API to display them in a custom UI.

Technical Details

Defining Custom Fields

Custom fields can be set up in the following gamification elements:

• Tournaments

• Jackpots

• Raffles

• Levels

• Missions & Badges

• Mini-Game templates and mini-game prizes

• Store Items

Custom fields can be set up in the following communication resources:

• Inbox

The definition of custom fields is managed by Smartico personnel. You will need to fill out the JIRA request by specifying the fields you would like to see for the required gamification blocks, and the support team will make the necessary configurations.

As soon as the configurations are applied, you will see fields available for editing on the screens of gamification blocks (such as tournaments, levels, etc.). Note: custom fields can be applied to the mentioned gamification blocks, and by request, they can be added to other Gamification blocks.

Custom fields can be applied only to the Inbox from the communication resources, while all others (SMS, Push, Email, and Popups) cannot. Although you can explore the Custom IM concept implementation, which is flexible in terms of defining custom fields.

Custom fields are defined using JSON format. Below is an example:

[
  {
    "name": "cashback",
    "field": "int",
    "label": "Cashback, %",
    "required": false
  },
  {
    "name": "rakeback",
    "field": "int",
    "label": "Monthly Rakeback, %",
    "required": false
  },
  {
    "name": "has_vip_club",
    "field": "bool",
    "label": "VIP Club",
    "required": true
  },
  {
    "name": "reward",
    "field": "text",
    "label": "Reward",
    "required": false,
    "translatable": true
  },
  {
    "name": "image_inactive",
    "field": "image",
    "label": "Image (Inactive)",
    "required": false
  },
  {
    "name": "image_active",
    "field": "image",
    "label": "Image (Active)",
    "required": false
  }
]

Accessing Custom Field Data via API

Once defined, you can access custom field values from the API like this:

javascriptCopyEditsmartico.api.getLevels().then((result) => {
     console.log(result[0].custom_data.cashback);
});

This will fetch the cashback percentage assigned to the level and allow you to display it in your custom UI.

---

By leveraging custom fields, you can enhance user engagement and personalize the gamification experience to better suit your needs. 🚀