Missions

Overview

Missions are a powerful way to guide users toward meaningful actions. They give players a sense of purpose and progress, rewarding them with a strong feeling of accomplishment once completed. In the Smartico system, a Mission is a collection of tasks. When a user completes all the tasks in the list, the mission is marked as completed.

GF Widget: Missions Overview
GF Widget: Opened Mission

Mission Statuses & Types

The possible mission statuses are:

  • Draft

  • Active

  • Archived

The newly created or cloned missions will automatically be in 'Draft' status. You can switch the mission from there to 'Active' or 'Archived.' Once a mission is set to 'Active,' it cannot be reverted to 'Draft' - only to 'Archived.' Additionally, an archived mission cannot be restored to 'Active' or 'Draft' status.

The mission types are:

Every type supports the following options:

Generally Available Missions

The mission becomes available to the end user after it is activated without the need to unlock it. Once it is completed, it goes to the Completed tab. The behavior of the mission on the UI also depends on the configured settings.

[Opt-in: OFF] Generally Available + Availability period

If the opt-in option is disabled and the Start and End dates are configured, the mission will have the following behavior:

  • Before the Start Date, the mission will appear under the Locked tab with a label indicating the start date and a countdown timer showing the time remaining until it becomes available.

  • After the Start Date, the mission will move to the Available tab, with a timer showing the time until the End date is reached.

  • When the End date is reached and the mission is not completed, it moves to the Missed tab with an Expired label.

[Opt-in: OFF] Generally Available + Time to complete the mission

If the opt-in option is disabled and 'Time to complete the mission' is set, the mission will have the following behavior:

  • Once the mission is activated, it will be displayed under the Available tab with a timer showing the time left to complete the mission.

  • When the time to complete the mission is reached and the mission is not completed, it will go to the missed tab with the Expired chip.

[Opt-in: OFF] Generally Available + Time to complete the mission + Availability period

If the opt-in option is disabled, 'Time to complete the mission' is set, and Start and End dates are configured, the mission will have the following behavior:

  • Before the Start Date, the mission will appear under the Locked tab with a label indicating the start date and a countdown timer showing the time remaining until it becomes available.

  • After the Start Date, the mission will move to the Available tab, with a timer showing the time that is set in the ‘Time to complete the mission’ setting. This timer takes into consideration the End date as well, and it shows the shortest period that is left. So, in case the End date is closer in time than the time set in Time to complete the mission, the timer will show the time left until the End date and vice versa.

  • After the time to complete the mission or the End date is reached, the mission will go to the missed tab with the Expired chip.

GF Widget: Expired Mission
GF Widget: Active Mission
GF Widget: Locked Mission by Date

[Opt-in ON] Generally available + Availability period

If the opt-in option is enabled and the Start and End dates are configured, the mission will have the following behavior:

  • Before the Start Date, the mission will appear under the Locked tab with a label indicating the start date and a countdown timer showing the time remaining until it becomes available. The opt-in button is disabled.

  • After the Start Date, the mission will move to the Available tab, with a timer showing the time until the End date is reached. The opt-in button is active, and there is a ‘Requires opt-in’ chip.

  • After Opt-in, the timer continues counting the time until the End date, and there is a ‘You are opted in’ chip.

  • After the End date is reached, no matter if the player has opted in or not, if the mission is not completed, it will go to the missed tab with the Expired chip.

[Opt-in ON] Generally available + Time to complete the mission

If the opt-in option is enabled and the 'Time to complete the mission' is set, the mission will have the following behavior:

  • Once the mission is activated, it will be displayed under the Available tab with an Opt-in button and ‘Requires opt-in’ chip without a timer.

  • After Opt-in, the timer appears, showing the time left to complete the mission

  • When the time to complete the mission is reached and the mission is not completed, it will go to the missed tab with the Expired chip.

[Opt-in ON] Generally Available + Time to complete the mission + Availability Period

If the opt-in option is enabled, 'Time to complete the mission' is set, and Start and End dates are configured, the mission will have the following behavior:

  • Before the Start date, the mission will appear under the Locked tab with a label indicating the start date and a countdown timer showing the time remaining until it becomes available. The opt-in button is disabled.

  • After the Start Date, the mission will move to the Available tab, with a timer showing the time until the End date is reached. The opt-in button is active, and there is a ‘Requires opt-in’ chip.

  • After Opt-in, the timer is changed, and it shows the time left to complete the mission. This timer takes into consideration the End date as well, and it shows the shortest period that is left. So, in case the End date is closer in time than the time set in Time to complete the mission, the timer will show the time left until the End date and vice versa.

  • After the time to complete the mission or the End date is reached and the mission is not completed, the mission will go to the missed tab with the Expired chip.

GF Widget: Expided mission with opt-in
GF Widget: Active mission with opt-in
GF Widget: Locked mission by date with opt-in

📖 Read more about 'Locked missions' here 📖 Read more about 'Recurring missions' here 📖 Read more about 'Recurring upon completion' missions here 📖 Read more about 'Featured manually' missions here

Multi-currency amount

Multi-currency amount provides the possibility to tune mission names or descriptions according to the user's currency. As soon as the values are defined, you can use them in the mission name and descriptions with the placeholder tag {{amount}}.

Example of usage in mission description: 'To unlock this mission, you should deposit in total {{amount}} {{state.core_wallet_currency}}' For such a mission, users of the EUR currency will see the amount and currency name matching the EUR configuration, and users of the USD own value.

BO: Multi-currency setting in Missions

Multi-currency amount in Mission Tasks

You can tune the task name according to the user's currency.
Use the placeholder tag {{amount}} in the task name once values are defined.

For example:
'Bet {{amount}} {{state.core_wallet_currency}} in total'
Could be transformed based on the user currency to:
'Bet 100 EUR in total' or 'Bet 120 USD in total'

BO: Multi-currency setting in Missions Tasks

Scheduled Missions

You can schedule a mission to unlock at a specific time using the ‘Availability Period’ feature, which allows you to set a Start and End date for the mission. This feature is compatible with all mission types, including Recurring, Recurring Upon Completion, Locked, Featured Manually, and Generally Available missions.

BO: Availability period in Missions

You can configure either the Start and End dates or just one (e.g., only a Start date or only an End date).

  • Before the Start Date: The mission will appear under the Locked tab with a label indicating the start date and a countdown timer showing the time remaining until it becomes available.

  • After the Start Date: The mission will move to the Available tab, ready for players to engage.

  • If the time to complete the mission is reached and the mission is not completed, it moves to the Missed tab with an Expired label.

    • For recurring missions, there will not be an Expired label, only a timer showing the time left till the next reset date.

  • If the End date is reached and the mission is not completed, it moves to the Missed tab with an Expired label. For recurring missions, this means the mission will not reappear.

Show expired missions

You can choose whether to expose expired and not completed missions or to hide them. A mission is considered expired when its set duration has passed and the player did not complete it. The option to show/hide the expired missions is located in the missions template within the BO and is available only if you have set a time limit. If a mission expires, the ‘Hide mission when expired’ is disabled, and the user hasn’t completed it, it moves to the Missed tab. In case the user completes it before it expires, the mission moves to the Completed tab. If the ‘Hide mission when expired’ is enabled, it will disappear from the gamification widget when the mission expires.

BO: Hide mission when expired setting in Missions

The table below outlines 'Generally available' missions with the 'Hide mission when expired' option and their respective behaviors upon completion or expiration.

Mission Type
Hide mission when expired
Completed Missions
Expired Missions

Generally Available with Time Limit set and opt-in or Scheduled

Yes

Goes to the completed tab

Disappears from GF Widget

Generally Available with Time Limit set and opt-in or Scheduled

No

Goes to the completed tab

Goes to the missed tab

Manual Reward Claiming

Players can manually claim rewards after completing missions. The 'Enable reward claiming' option can be found within the Missions template in the BO, and it is available for all mission types. By default, this option is disabled, meaning rewards will be automatically released to the player upon mission completion.

BO: 'Enable reward claiming' option in Missions

When enabled, players must manually claim their rewards after completing a mission by pressing the ‘Claim reward’ button. Until then, the reward will not be released. Completed missions with unclaimed rewards can be found in the 'Completed' tab with a ‘Reward not claimed’ label. Players can then open the mission pop-up to claim their reward.

GF Widget: Not Claimed mission
GF Widget: Not claimed mission opened

Operators can also manually claim rewards for a specific player in the BO from two locations: 1. From the mission template -> Users Completed

BO: Claim mission reward from 'Users Completed' tab

2. From the user profile page -> Active Missions

BO: Claim mission reward from User Profile page

Display Missions' Progress as Count

The 'Display progress as count' option is located in the Mission template -> Tasks within the BO. This option allows you to show the remaining number of event occurrences as a count (e.g., 35/100) instead of a percentage in the progress bar of the mission. This feature is available for both single and multiple-task missions.

GF Widget: Display progress as Count in missions
GF Widget: Display progress as Count in missions
GF Widget: Display progress as Count in missions with multiple tasks

The 'Display progress as count' option can be configured per task and is available only for the following multi-action tasks:

  • 'Complete action a few times'

  • 'Complete action a few times, with a unique attribute'

  • 'Complete action a few times, check a SUM of attribute'

BO: Display progress as Count setting in missions tasks

Manually Unlock mission for a specific user segment

You can manually unlock locked missions for specific user segments. For example, if a mission is set to unlock at level 7, you can unlock it for users who have already reached that level before the mission was created.

The 'Manual Unlock' option is available only for active Locked missions and does not apply to missions in 'Draft' or 'Archived' status. You'll find this option under the 'More' dropdown. Use conditions and 'OR' groups to define the user segments you wish to unlock the mission for. Once a mission is manually unlocked for these users, it cannot be reverted back to locked.

BO: Manual Unlock option for Locked missions
BO: Manual Unlock settings

Manually Complete mission for a specific user segment

You can also manually complete missions for specific user segments. For example, if you create a KYC mission and some users have already completed KYC before the mission was created, you can manually complete the mission and reward those users.

The ‘Manual Complete’ option is available for all types of missions in status Active. You'll find this option under the 'More' dropdown. Use conditions and 'OR' groups to define the user segments you wish to complete the mission for. Once a mission is manually completed for these users, it cannot be reverted back and the rewards will be issued, unless manual reward claiming is enabled.

BO: Manual Complete for missions
BO: Manual Complete settings

We’ve improved the functionality of ‘Featured Manually’ missions by introducing a new option called 'Progress Reset Mode'. This feature gives you greater flexibility in managing mission progress when assigning a mission via a campaign, automation rule, or manually through the user profile page. You can now choose how the mission’s progress is handled, based on its current state (mission completed or not completed). The following options are available:

  • Keep progress if the mission was already given to the user - The mission’s progress remains unchanged, regardless of whether it is completed, not started, or in progress but incomplete.

  • Reset progress, if the mission was given, but not Completed yet - The mission’s progress will be reset if the mission is not completed yet. The mission will appear in the ‘Overview’ and ‘Available’ tabs with no progress.

  • Reset process and restart mission, if it was given and already completed - The mission’s progress will be reset even if it has already been completed. The mission moves from the ‘Completed’ tab back to the ‘Overview’ tab with no progress.

  • Reset progress if the mission was already given to a user - The mission’s progress will be reset regardless of whether the mission was completed.

BO: Progress reset mode in Campaigns
BO: Progress reset mode in Automation Rules
  • You can find "Gamification: missions" data cube in the Data Studio in Smartico Back Office

  • You can access DWH with the row data about all facts related to the missions. This topic is explained in the Access to DWH article. The tables related to the missions are:

    • g_ach_completed - facts of completing missions

    • g_ach_optin - facts of opt-ins

    • g_ach_claimed - facts of claimed prizes

    • dm_ach - dictionary of all missions and badges defined in your setup

Last updated

Was this helpful?