Smartico Help Center
Admin loginSmartico.aiTheAffiliatePlatform.com
  • Welcome
  • Products
    • 🔆CRM Automation
      • ◾Create Journey Flow
      • ◾Event Driven Journey
      • ◾Automation Rules
      • ◾Campaigns vs Automation Rules
      • ◾Segmentation
        • ▪️User State Segments
        • ▪️Behavioral Segments
        • ▪️Imported Segments
      • ◾Activities of Flows
        • ▪️Activity: Email
        • ▪️Activity: SMS, Viber and WhatsApp
        • ▪️Activity: Telegram Bot
        • ▪️Activity: Custom IM
        • ▪️Activity: WebHook
        • ▪️Activity: Limit
        • ▪️Activity: Add Points
      • ◾Communication channels
        • ▪️Email
        • ▪️Liquid Email
        • ▪️SMS, Telegram, Viber, and WhatsApp
        • ▪️Popups
        • ▪️Inbox
        • ▪️Push notifications
        • ▪️Content Variations
        • ▪️Opt-out & Communication Statuses
        • ▪️Gamification activities in the communications
      • ◾A/B Testing
    • 🎮Gamification Blocks
      • Setup steps and checklist
      • Points
      • Gems & Diamonds
      • Levels
        • Level Map
        • Levels Tips & Hints
      • Missions
        • Mission Types & Statuses
        • How to set up a Mission
      • Tournaments
        • Tournament Setup
      • Badges
      • Store
      • Example setup
      • Gamification UI skinning
      • Terms to protect
    • 🧠AI Models
      • ◾AI Enhancer
      • ◾Best Time Model
      • ◾Churn & LTV prediction
      • ◾Favorite product
      • ◾RFM Analysis
      • ◾Sport Recommendations
    • 🎲Mini Games
      • ◾Introduction to Mini Games
      • ◾Game template setup
      • ◾Custom skins for Mini-games
      • ◾Mini-games on the landing pages
      • ◾Using images instead of prize names in Spin the Wheel
      • 🏴‍☠️Treasure Hunt
      • ⚽MatchX Game
        • Creating Rounds
        • Resolution of a Round
        • Leaderboard
        • Game Statuses
        • FAQ: MatchX game
        • Loading MatchX & Quiz games on website
      • ❓Quiz Game
      • 🪂Prize Drop
    • 🗺️Lootbox 2.0
    • 🎁Missions Lootbox
    • 🏆Jackpots
    • 🎟️Raffles
    • 💡General concepts
      • ◾Bonuses
      • ◾Dynamic Rewards
      • ◾Custom Sections
      • ◾Attribution value
      • ◾Label tags
      • ◾Multi-currency usage report
      • ◾Multi-brands support
      • ◾Override translations on Label/Brand Level
      • ◾User markers (tags)
      • ◾Deep-links
      • ◾User roles in Back Office
      • ◾Email Gateways Guide
      • ◾"Client action" event
      • ◾Custom fields/attributes
    • 💻UI Widgets
    • ❔FAQs
      • FAQ: Gamification
      • FAQ: Data Studio & Reports
      • FAQ: CRM Automation
      • FAQ: Front-end integration
      • FAQ: Other topics
      • FAQ: Bonuses
  • Use cases
    • 🔆CRM Automation
      • ◾Cross-sell. Match users on different brands
      • ◾Mini-games usage in marketing campaigns
      • ◾Optimize Communication by excluding disengaged players
      • ◾Automated Sports Campaigns
  • Technical guides
    • ◾Integration process
    • ◾Front-end integration
      • ▪️Extended integration
      • ▪️Push configurations
      • ▪️Acquisition mode
    • ◾Data integration
    • ◾Bonus API integration
    • ◾Secured Messaging Gateways (Email/SMS/IM)
    • ◾Reverse integration
    • ◾Smartico Data Warеhouse
      • ◾Smartico DWH \ Affiliation views
      • ◾Smartico DWH \ CRM views
      • ◾Smartico DWH \ Gamification views
    • ◾Games catalog API
    • ◾Custom push gateways
    • Branded Links
  • More
    • 📝Release notes
      • 🌷May 2025
      • 🌷April 2025
      • 🌷March 2025
      • ❄️February 2025
      • ❄️January 2025
      • ⛄December 2024
      • 🍁November 2024
      • 🍁October 2024
      • 🍁September 2024
      • 🌞August 2024
      • 🌞July 2024
      • 🌞June 2024
      • 🌷May 2024
      • 🌷April 2024
      • 🌷March 2024
      • ❄️February 2024
      • ❄️January 2024
      • ⛄December 2023
      • 🍁November 2023
      • 🍁October 2023
      • 🍁September 2023
      • 🌞August 2023
      • 🌞July 2023
      • 🌞June 2023
      • 🌷May 2023
      • 🌷April 2023
      • 🌷March 2023
      • ❄️February 2023
      • ❄️January 2023
      • ⛄December 2022
      • 🍁November 2022
      • 🍁October 2022
      • 🍁September 2022
      • 🌞June 2022
      • ❄️January 2022
      • 🍁October 2021
      • 🌞July 2021
      • 🌷April 2021
      • ❄️February 2021
    • ⚙️Support Scope
    • 👍Request Demo
Powered by GitBook

More

  • expo.smartico.ai
  • ice.smartico.ai
  • play.smartico.ai

@ 2025 Smartico.ai

On this page
  • What Are Custom Fields?
  • Example Use Case
  • Technical Details

Was this helpful?

  1. Products
  2. General concepts

Custom fields/attributes

Last updated 3 months ago

Was this helpful?

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 elements, such as Tournaments, Missions, Badges, Levels, Mini-Games, and Store Items. 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 -

By default, player levels only include:

  • Name

  • Description

  • Image

  • Progress information

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

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 for different gamification elements, such as:

  • Tournaments

  • Levels

  • Badges

  • Mini-Games

  • Store Items

  • Prizes

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. 🚀

💡
◾
https://expo.smartico.ai/widgets/api_custom_lvl_map
Custom levels UI with additional fields/attributues
Default attributes of levels
Custom attributes