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
  • Deep-links in Mini Games
  • List of deep links supported out of the box
  • Standalone & hide_main parameters
  • Implementing custom deep links

Was this helpful?

  1. Products
  2. General concepts

Deep-links

Last updated 22 days ago

Was this helpful?

"Deep links" is the way to navigate the user through the built-in gamification functionality or to the screens specific to the integrated product.

The built-in deep links - in most cases are starting with "gf" prefix, for example, the gf_missions deep link will navigate the user to the screen with a list of the missions.

Product-specific deep links - may have any kind of name, for example, a deep link with the name "cashier" can lead users to the deposit page.

We are strongly encouraging to use of deep links instead of the fixed URLs as they are providing a unified way to lead users to specific screens no matter the channel used - deep links are working the same way for online communication, like Popups & Inbox, and for the offline, like Mails, SMS and Push notifications.

They are also simplifying operational work in the case of multi-brand usage because they are abstracted from the target domain on which a specific brand is set up.

And they can help you to migrate to a new domain, in in case a main domain got blocked or is not available for whatever reason.

Deep links can be executed from the main places in the Smartico system:

  • From the Popup, Push messages, and Inbox messages

  • From the SMS, you can build a message like "Try our new missions dp:gf_missions", the deep link will be replaced dynamically at the time of the sending message and after clicking on the link, the user will land on the main site with the needed deep link executed. The same is working for other IMs like WhatsApp, Viber, Telegram, etc.

  • From Mail templates, when building link like <a href="dp:gf_missions">Click here</a>

  • From the main site using javascript call _smartico.dp("dp:gf_missions");

  • Directly by navigating to your site with specific parameters in the URL, e.g.

  • From the descriptions of missions, tournaments, mini-games, levels, etc. All places that are supporting HTML or have a dedicated place to put a deep link

Deep-links in Mini Games

Open Mini Game in the Gamification widget

Mini games can be opened as part of Smartico Gamification widget using a Deep Link;

  • dp:gf_saw - will open the mini games section with 1st by priority game

  • dp:gf_saw&id=19 - will open specifically mini game template ID 19

Open Mini Game in standalone mode

Mini games can be opened in standalone mode directly on the operator site when the user clicks on a specific HTML element placed on the website.

  • _smartico.dp('dp:gf_saw&id=19') - will opened game with id 19 in the Gamification widget context

  • _smartico.miniGame(19) - will open Mini-game with id 19 in standalone mode

List of deep links supported out of the box

Deep link
Action
Standalone
Hide main

dp:gf

Opens main screen of gamification widget

dp:gf_activity

Opens the "Inbox" section inside the gamification widget

dp:inbox

dp:telegram

Opens telegram and starts authentication process.

dp:go&url=https://smartico.ai

Redirects to the specified url. Notes:

  • The url cannot contain any query parameters (symbols like ? and &).

  • The url can be a tag that will be replaced.

  • The url can be uri encoded.

  • The url can be relative path (exampe: /deposit)

dp:go&target=_blank&url=https://smartico.ai

Opens the specified url in the specified way - current tab or in a new tab.

Possible values:

  • _blank - open in new tab

  • _self - open in current tab

dp:gf_missions

Opens overview screen of missions

dp:gf_missions&category=completed

Opens one of 4 categories in the missions:

  • overview

  • available

  • locked

  • completed

dp:gf_missions&id=123

Opens missions with specific ID

dp:gf_missions&id=123&opt_in=true

Opens missions with specific ID and opts in the user to it

dp:gf_matchx

Opens 'Match X' section

dp:gf_matchx&id=123

Opens a 'Match X' game with specific ID

dp:gf_quiz

Opens 'Qiuz' section

dp:gf_quiz&id=123

Opens a 'Quiz' game with specific ID

dp:gf_badges

Opens badges screen

dp:gf_board

Opens leaderboards section

dp:gf_board&type=2

Open leaderboard of type Weekly, other types

  • 1 - Daily

  • 2 - Weekly

  • 3 - Monthly

dp:gf_tournaments

Opens main tournaments screen

dp:gf_tournaments&category=myTournaments

Opens specific list of tournaments, possible values:

  • all

  • inProgress

  • myTournaments

  • finished

dp:gf_tournaments&id=123

Opens tournament lobby with defined id

dp:gf_tournaments&id=123&register=true

Opens tournament lobby with defined id and registers user in it

dp:gf_tournaments&id=123&section=leaderboard

Opens tournament leaderboard section

dp:gf_tournaments&id=123&future=true

Opens future run of a tournament. The future instance of the tournament that is in status 'Open for Registration'. If there is no future run it will open the current instance of the tournament

dp:gf_bonuses

Opens bonuses screen

dp:gf_levels

Opens level screen

dp:gf_levels&id=123

Opens level details with specified id

dp:gf_saw

Opens Spin The Wheel screen

dp:gf_saw&id=123

Opens Spin The Wheel screen with focus on the specific game template

dp:gf_section&id=123

Opens "custom section" with defined ID

dp:gf_store

Opens store screen

dp:gf_store&category=123

Open store screen with defined category

dp:gf_store&id=456

Open store item with defined id

dp:gf_change_nickname

Opens gamification widget with an interface to change nickname

dp:gf_change_avatar

Opens gamification widget with an interface to change avatar

dp:action&action=START_X

Triggers "Client action" event that can be used in campaigns, missions, automation rules .etc

dp:gf_jackpots

Open jackpots main screen

dp:gf_jackpots&id=123

Open jackpots main screen with focus on specific jackpot template

Standalone & hide_main parameters

Most deep links related to gamification support "standalone" and "hide_main" parameters.

Adding "&standalone=true" parameter to the deep link will lead to opening only a dedicated section of the gamification widget without the left menu and header. For example, "dp:gf_missions&standalone=true" will open the missions screen like in the screenshot below

Adding "&hide_main=true" to the deep link will focus on the specific element, usually identified with "id". For example, the deep link "dp:gf_missions&id=123&hide_main=true" will open a mission with id 123 in the focus.

Similar way you can trigger the opening of the "Change avatar" interface or "Change nickname" interface ('dp:gf_change_avatar&hide_main=true' and 'dp:gf_change_nickname&hide_main=true')

Mini-games specifics

Mini-games can be called in 3 different ways

  • dp:gf_saw - will open the main gamification widget with a focus on the Mini-games screen

  • dp:gf_saw&id=123 - will do the same, but will focus on specific game template

  • dp:gf_saw&id=123&standalone=true - will open mini-game in standalone mode, see screenshot below

  • dp:gf_saw&id=123&standalone=true&with_games_list=true - will open mini-games in standalone mode, list all available games, and focus on template id 123

Implementing custom deep links

Smarico JS SDK can be extended with custom Deep Links, developed by Partner.

An example of a custom Deep Link is “dp:deposit&amount=50&method=PaySafe” which could navigate users to the deposit page on the Partner side with a predefined amount and payment method.

Whenever such Deep Links are implemented they can be used from all the places of the Smartico system and communication resources as a unified way to control user flow.

In order to implement a custom deep link(s), the Partner needs to define a function named __smarticoDPCustom. Example of implementation

function __smarticoDPCustom(dp) {
    switch (dp.action) {
       case 'deposit' : {
           window.location.href = '/deposit/?amount=' + (dp.params.amount ? '&method=' + dp.params.method : '')
           break;
       }
       default: {
           return false
       }
   }
   return true;
}

As soon as deep links are implemented by Partner, they need to be registered on the Smartico side in order to be visible in all the places with auto-complete possibility.

Opens separate "Inbox" widget, please refer to the article explaining the concept of this communication channel and widget

💡
◾
https://smartico.ai/#_smartico_dp=dp:gf_missions
Inbox
Missions in standalone mode
Mission opened with hide_main=true
dp:gf_saw
dp:gf_saw&id=123&standalone=true
dp:gf_saw&id=123&standalone=true&with_games_list=true