# Notification

The Notification channel allows you to **send players messages that appear on their screen** during an exercise.

| Benefit                                                                                                                                                                                                                                               | Feature                                                                                       |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| <ul><li>Mimic desktop alerts</li><li>Provide essential updates, warnings or prompts that need immediate visibility</li><li>Ensure critical moments in the scenario are highlighted</li><li>Keep both participants and Facilitators informed</li></ul> | Send players simple, attention-grabbing messages that appear on the screen during an exercise |

## Running

<figure><img src="https://3476309720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsNKxYbIPgfYmCR9EJgAu%2Fuploads%2Fi70Kz17aMG5n5f6lnLbO%2Fnotification.png?alt=media&#x26;token=38340fac-f375-45f9-a9d5-7d06941b3fea" alt=""><figcaption><p>This is what notifications look like in the player view</p></figcaption></figure>

***

## Designing

### When to Use <a href="#when-to-use" id="when-to-use"></a>

* Provide **in-world alerts** like an SMS notification or **out-of-world instructions** to the facilitator
* Use for **quick updates** to notify participants of important milestones
* Highlight critical moments in a scenario that require **immediate attention**
* **Interrupt** player activity for essential prompts or decisions

### How to (Configuration) <a href="#how-to-set-it-up" id="how-to-set-it-up"></a>

To add or remove audio bleep, navigate to the `Configuration` tab in the exercise editor. Choose `Channels` and select `Notification`.

### How to (Inject)

All other setup is in the inject (i.e. in `Exercise`)

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FTFP0uOMw5It0cvuD00kI%252Fimage.png%3Falt%3Dmedia%26token%3Ddbd543ce-4afe-41a7-9fcc-cafd6592ae83&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=93266016&#x26;sv=2" alt=""><figcaption><p>Example notification with optional question</p></figcaption></figure>

#### Option Descriptions <a href="#option-descriptions" id="option-descriptions"></a>

| Option        | Description                                                          |
| ------------- | -------------------------------------------------------------------- |
| Sound         | Toggle sound alerts on or off for notifications. (in `Style`)        |
| Attach media  | Add image to make more realistic or appealing                        |
| Add timer     | Include a countdown that closes the notification (avoid if possible) |
| Add questions | Present the user with choices that cannot be skipped                 |

#### What the Player Sees <a href="#what-the-player-sees" id="what-the-player-sees"></a>

1. **Standard Notification**: Appears as a simple pop-up on the participant's screen:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FEzdcaJFvcJo2GNKCUtIR%252Fimage.png%3Falt%3Dmedia%26token%3Dba204158-746e-4d35-8cf5-09695796559c&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=4a1aa27f&#x26;sv=2" alt=""><figcaption></figcaption></figure>

2. **Notification with Question**: Displays a choice of buttons that the user must click. Two buttons appear side-by-side, while more than two will stack vertically:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FLAzdd0XhtlPwVSAyjY3V%252Fimage.png%3Falt%3Dmedia%26token%3Ddd693464-91f5-4b7a-9a10-e29bd4ffd6d2&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=7d50ff12&#x26;sv=2" alt=""><figcaption></figcaption></figure>

3. **Notifications with Timers:** Shows a timer countdown; once started, it cannot be skipped or sped up:

<figure><img src="https://helpdocs.conducttr.com/~gitbook/image?url=https%3A%2F%2F3476309720-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252FsNKxYbIPgfYmCR9EJgAu%252Fuploads%252FbzfX9yQhN3r2oiwkcXFS%252Fimage.png%3Falt%3Dmedia%26token%3De3114a08-1b5e-41d4-9308-dc0c4d7492bc&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=3535f969&#x26;sv=2" alt=""><figcaption></figcaption></figure>

{% hint style="danger" %}
Note that timers and questions cannot be used simultaneously.
{% endhint %}

### ⭐Best practices <a href="#best-practices" id="best-practices"></a>

* Use media attachments to enhance the impact of your notifications
* Design clear, concise, and purposeful messages to ensure user engagement
* Avoid timer if possible or else set reasonable timers to allow participants adequate time to respond. But not too long because you're removing agency if the pop-up is just a message

### :zap:FAQs: <a href="#faqs" id="faqs"></a>

<details>

<summary>Can notifications be sent to specific people?</summary>

Yes, just like any other inject, you can decide to send it to all players, the EXCON team, roles or positions etc.

</details>

<details>

<summary>Can players dismiss or acknowledge notifications? </summary>

Notifications cannot be skipped, they will appear on screen and the player will have to close the notification to see their dashboard again.

</details>

<details>

<summary>Do notifications persist, or do they disappear after being viewed?</summary>

A "X" appears for the standard notification allowing players to close the notification.

Question notifications require players to select a choice in order for the notification to disappear.

With a timer notification, there is not choice for the player to close the notification. They have to wait for the timer to be up.

</details>

<details>

<summary>Is there a way to track whether a notification was seen or interacted with?</summary>

Only question notifications are tracked and the data can be found in the facilitator dashboard within the review tab and reports.

</details>

### Examples <a href="#examples" id="examples"></a>

The sharefile below has an example of each type of notification option:

* Standard (no button or timer)
* Choice
* Timer

{% file src="<https://3476309720-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsNKxYbIPgfYmCR9EJgAu%2Fuploads%2FSuyIzDmWhF9RY7hRJ1vJ%2FNotification%20Examples_2024-07-07%2014-20-46.txplib?alt=media&token=33f1c93d-297f-4dc1-a964-e5d0c38824ff>" %}

In the above example, we move players in Groups depending on their choice.

* Group 1 is the default group that all players belong to at the start of all exercises.
* The player is prompted to make a choice of running the anti-virus scan or not. Those who do are added to Group 2 and those who delay are added to Group 3.
* After this choice no players will belong to Group 1. This means we can use Group 1 later for those of accept another chance to run the virus scan.
* You'll see that injects are sent to Group instead of to All and hence players see the consequence of their choice
