# FAQ: Gamification

### **What is "public user name"?**

Public user name is used to present the user in the gamification widget, for example, in the leaderboards, tournaments, raffles, jackpot winners, etc.

During the integration process, the Smartico technical team can configure the logic to retrieve the "public user name" value from the fields of your choice. The possible scenarios we are usually facing:

* In case your system already has a concept of "username", then it's the best candidate to be used for "public user name".
* If you don't have such, then we recommend using the "First name" of the user.
* Otherwise, you can pick any other user state property. Alternatively, if nothing is selected, you can use the user ID.
* It is also possible to set multiple fields; for example, setting the logic to "core\_username;user\_first\_name;user\_ext\_id" instructs the system to select the first non-empty field.

Notes:

* By default, the "public user name" is masked when visible in the gamification widget. You can adjust this logic in Label settings by configuring the "Mask names of other users" option.
* The end user can change their public username from the gamification widget. If its not desired, this option can be disabled.

### **I see the gamification widget in a language different than my account's core language**

Make sure you check the language settings in Label - Brand - Settings and verify that the desired language is among the widget's allowed languages.

<figure><img src="https://lh3.googleusercontent.com/aba6TYIQDn-udvhq6KSWuTNDuydPRwWQddG0UKhRZt0UFSjnm19nIjRU0TEzpUMrvzDJyMb8exFyX0_tzJDQGbTJtlewrZBRfeYOA6jyvKQ2fMNrdZaMeFCJyqyUc295T6StffOVlhgCeylNk-EfM_dp7V3-W1MOFUppxWnTVPMFEVCfAHqcIi0sVg" alt=""><figcaption></figcaption></figure>

### How store items are ordered?

The default order is the following:

* 1st priority - items that the user can buy (has enough points and eligible to buy from the conditions settings)
* 2nd priority - items ordered by "priority" value
* 3rd priority - items ordered by price, from high to low

{% hint style="info" %}
The order of items can be changed according to your vision, please contact your Customer Success Manager for more details.
{% endhint %}

### What are deep links?

Deep links are a way to navigate users to specific screens within the gamification widget or to screens specific to integrated products. They can be used across various channels such as popups, push messages, inbox messages, SMS, mail templates, and more.

### What is the difference between built-in deep links and product-specific deep links?

Built-in deep links usually start with the "gf" prefix and are related to the gamification widget's functionality. Product-specific deep links may have any name and lead users to specific screens in integrated products.

### Why should I use deep links instead of fixed URLs?

Deep links provide a unified way to lead users to specific screens, regardless of the channel used. They simplify operational work, especially when multiple brands use the system, and they can help you migrate to a new domain.

### How can I use deep links?

Deep links can be executed from various places in the Smartico system, including popups, push messages, inbox messages, SMS, mail templates, and more. You can also navigate directly to your site with specific parameters in the URL. Check ["Deep links"](/welcome/products/general-concepts/deep-links.md) article for more details

### When should I use the "standalone" and "hide\_main" parameters?

The "standalone" parameter is useful when you want to provide users with a seamless experience focused solely on the content of a specific screen. The "hide\_main" parameter is useful when you want to highlight a particular feature or functionality within the gamification widget.

### Why are some games not appearing when I try to create missions, tournaments, segments, or other activities?

Certain games may not appear in the system under "game name" for missions, tournaments, segments, and other activities if they have not been played yet by a user on your label. To resolve this issue, follow these steps:

1. **Make Bets**: Ensure that bets are made on the games in question. This action registers the game in the database.
2. **Verify Game Appearance**: After placing the bets, check if the games appear in the system.
3. **Further Action if Necessary**: If the games still do not appear, provide the Smartico profile link of the user who made the bets for further investigation.

**Additional Help:**

If you continue to experience issues, please contact support with:

* The specific games involved
* Confirmation that bets were placed
* The Smartico profile link of the user who made the bets

### **My recurring mission isn't visible. What could be the reasons?**

There are two main reasons why a recurring mission might not be visible:

#### 1. Criteria for Visibility and Progress

Recurring missions have a section called "Who can see and progress in mission", where you can specify different criteria the user should meet to see and progress in the mission.

<figure><img src="/files/6RxQuAfXbvgabqrC4xCk" alt="" width="563"><figcaption></figcaption></figure>

If you don't meet the specified criteria, you won't see the mission.

#### 2. Schedule Configuration

Recurring missions work on a schedule. They can run daily, on certain days of the week, or on specific days of the month.

<figure><img src="/files/ZeHzKAbqedmt0KI0xPFY" alt="" width="563"><figcaption></figcaption></figure>

{% hint style="info" %}
Please note that the schedule will execute as per the configuration, and if the scheduled time for today has already past it will exclude the current day and will start on the next scheduled time
{% endhint %}

<figure><img src="/files/DuTiziJI1U8vexdRAFNr" alt="" width="563"><figcaption></figcaption></figure>

For example, if a mission is created today at 12:00, May 24th (Friday), and configured to run every Friday at 11:00, the first execution of the mission will be on May 31st at 11:00.

#### Additional Help:

If you continue to experience issues with your recurring mission visibility, please contact support with detailed information, including:

* The specific criteria set for mission visibility
* The schedule configuration of the mission
* Any relevant screenshots or logs

By understanding these factors, you can ensure that your recurring missions are visible and executed as intended.


---

# 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/faqs/faq-gamification.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.
