# How to set up a Mission

**To create a Mission, simply go to:**\
Gamification –> Missions –> Create

The creation wizard allows you to choose the type of mission you want to create.

<figure><img src="/files/x9DprbG39862mAP3jKyu" alt=""><figcaption><p>BO: Creation wizard in Missions</p></figcaption></figure>

Once you create a new mission, define the general settings:

1. Choose a **name** for your Mission\
   This name will appear on the client side in the Gamification widget.\
   If your brand supports different languages, you can choose a name for each language
2. Write a **description** for the mission
3. Write a **description for the unlocking** of the mission in case this is a locked mission
4. **Reward description**\
   Write a description on the reward for completing the mission (in case there is one)
5. **Upload Mission icon**\
   You can upload an icon for your mission, or insert your own URL. The icon size should be 256×256 for optimized visualization.
6. **CTA button text & CTA button action**\
   e.g. You can place a Deposit button in the mission, with a deep link to the cashier
7. **Hide list of tasks from UI**\
   Choose to hide the tasks if you want to have a secretive mission (i.e. mission called “Explore the horizon” will have a description but list of tasks such as “browse 5 pages”, or “open cashier” will not be exposed and the user will complete the mission without knowing what the mission is)
8. **Hide Mission** from UI until it’s unlocked\
   If the mission is locked, you can hide it from your users, until they complete a task that will unlock it. Progression in a locked mission will start only when the mission was unlocked.
9. **Require explicit opt-in**\
   The user will need to opt-in into the mission in order to start progress.

   If the mission is limited in time, the time count down will start from the moment of opting in to the mission.
10. **Status**\
    The newly created or cloned mission 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.
    * Draft
    * Active
    * Archived
11. **Mission Priority**\
    Choose a priority for this mission in the list of all missions. Missions with a lower value will be shown first
12. **Ribbon**\
    Choose the visual marker on the Mission that puts the user's focus on it. The images used for ribbons can be customized per label and/or brand by request to the Success Managers
13. **Custom Section**\
    Missions can be assigned to custom sections, so they will be visible in the dedicated menu in the Gamification Widget. For example, you can build a set of Missions dedicated to the World Cup and create a separate Custom section in the widget
14. **T\&C hint**\
    It is optional if you don’t add any text, the T\&C hint will not be displayed in the Gamification missions. The option is applicable for multibrand labels and different languages

### **Create a Task**

To create a task simple click on “*Add Task*“

1. Choose a Task **Name**\
   This is a public name that will be displayed on the client side. Brand language are supported.
2. **Points reward**\
   The amount of points that will be given to the user upon completion of this task.
3. **Progress increment**\
   The value that represents how completion of the task is contributing to the completion of the entire mission (i.e. if you have 5 tasks and each task has “1” progress increment, the completion on each task will contribute 20% in the completion of achievement. This is represented by the progress bar on the client side)
4. Task **Type**
   * **Complete action once**\
     An action such as Bet, Deposit, Withdrawal will be completed only one time for the completion of this task
   * **Complete action few times**\
     An action would be required to happen several times
     * *Times to complete* (i.e. “3”. Action “deposit” will need to happen 3 times)
     * *Period to complete*\
       You can limit the period which the user need to complete the task (i.e. Action “deposit” will need to happen 3 times, within “3 Days”
     * *How often action will be counted*\
       You can define whether to count completion of the task every time it is completed or limit per period of time (i.e. Action “deposit” will need to happen 3 times, in “3 days” but we will count only 1 deposit per day. In case player will make 3 deposits in the same day the task will not be completed)\
       The options are:\
       – Not limited\
       – Once per minute\
       – Once per hour\
       – Once per day\
       – Once per week\
       – Once per month

{% hint style="success" %}

* If '**How often the action will be counted'** is set to **days** (or an equivalent value such as **24 hours**, **1,440 minutes**, or **86,400 seconds**), the system will use **calendar days** for the calculation.
  * **Example:** If a player deposits at **22:00 UTC**, the next calendar day starts at **00:00 UTC**, meaning the counter resets at midnight, not 24 hours later.

* For **any other value**, the system will use a **sliding time window** based on the selected duration.
  * **Example:** If the window is set to **6 hours**, and the player deposits at **22:00 UTC**, the next count will be valid only after **04:00 UTC** — exactly 6 hours later.
    {% endhint %}

* **Complete action few times, with unique attribute.** i.e Play 3 different games<br>
  * *All completion should have unique value of*\
    For the tasks like “Play 3 different games” you need to specify the property which holds the identification of game (i.e. Game name, Game type , Login Country Level name) More examples would be:\
    – Complete 5 levels\
    – Play 2 different game types (Slots & Poker)\
    – Login from 2 different countries

* **Complete action few times, check a SUM of attribute.** i.e. Deposit in total €500
  * *Total value should reach*\
    For example you can sum up total of deposit, or total amount of bets in a sliding window
  * *Calculate total values of*\
    Choose the value/property you would like to sum up (i.e. bet amounts, deposit amounts, win amounts, deposit counts etc)

1. **Action** that **completes** the task\
   Choose the event that will be the scope of the task. For example user login, user deposit, user bet, level changed, mission completed etc.
2. Add **Condition**\
   Add any condition related to the event. You can add unlimited conditions, for example:\
   Event user deposit approved with conditions of Deposit Amount >= €50 and Deposit Payment method is Neteller

{% hint style="info" %}
**Example: Make a sport bet with odd more or equal to 2.5 on FIFA 2022**, Task type “Complete action once”\
Event “Sport bet selection”\
Condition 1, “Last bet league” is FIFA 2022\
Condition 2, “Sport bet odds” is >= 2.5
{% endhint %}

<figure><img src="/files/OkURhSc8HTgQKMUmEqAn" alt=""><figcaption><p>BO: Creating a Mission task</p></figcaption></figure>

**Time-dependent tasks**

Mission could have tasks that should be done in specific time period and expected number of times.\
For example task “Login 5 times in 1 week” – here, the fair meaning of the “week” is any consecutive 7 days. Such task will be completed whenever customer does fifth login during last 7 days.

More examples:

* Complete 5 Levels within 1 month
* Play 3 time in a week from mobile phone
* Win 10 times in 15 minutes

<br>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.smartico.ai/welcome/products/gamification-basics/missions/how-to-set-up-a-mission.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
