Trophio Gamification User Guide

Trophio

What is Trophio?

Adding Tasks to an Existing Space/World (aka a Property)

Sharing access to a property with somebody

Creating a task

Task details

Task repetition

Notifications

Other settings

Reports

Trophio and Scenario

Using Trophio in the conversation editor

Adding Trophio tasks to items

Using Trophio in scripts

Tasks

Items

Trophio and LMSs

Trophio

What is Trophio?

Trophio is a service that allows for seamless integration of gamification tasks into Scenario. It includes Analytics (such as time spent in a conversation, in a space, or number of times a form has been opened), Achievements (which are configurable in a variety of ways and can be triggered at any point during an experience and based on a number of factors) and Reporting (visualizations of analytics and achievements data). Trophio is also compatible with SCORM and LTI.

Adding Tasks to an Existing Space/World (aka a Property)

By default, Trophio will query Dashboard to get a list of the logged in user’s properties (the spaces and worlds they own). This list can be accessed at https://app.learnbrite.com/trophio 

Sharing access to a property with somebody

Share access to Properties (to modify Tasks and view Reports) using the recipient’s email.

  1. Click on the property to share; the page will change to the Property’s details.
  2. Click on “Share with another user”; the page will change to a form


  1.  Insert the recipient’s name and email, then click “Send invite”.

The recipient will now have access to that property when they log into Trophio with the email used in the invite.

Creating a task

To create a task, navigate to the property in which the task should be created and click on “+Add task” button on the right.

A form with several sections will appear.

Task details

  • Name: the task’s name (will be visible to the user in Scenario)
  • Description: a short description of the task, max 255 characters (will be visible to the user within Scenario)
  • In world: tasks can appear for a space, for a world, and also for a specific space within a world. To make a task only appear for the current space within a world, the worldId should be inserted in this field.
  • Reward: the reward to be bestowed upon the player when the task is completed. This is formatted as key.value, where the following are valid options for key:
  • points: will give the user points. Any numeric value is valid. E.g. points.200 or points.-50
  • openUrl: will open the url in another tab. E.g. openUrl.google.com

Task repetition

  • Task is repeatable: whether the task can be completed more than once or not.
  • Number of repetitions: how many times the task can be completed (the reward will be given every time the task is completed). If a value of -1 is used, the user will be able to complete the task infinitely many times.

Notifications

  • On task started: the text to be included in a notification when the task is marked as started. Can include HTML.
  • On task completed: same as above, but shown when the task is completed. Can also include HTML.

Other settings

  • Task is enabled: whether the task can be completed.
  • Task is visible: decides if the user can see the task in the achievements list.
  • Order in task list: the position of this task in the achievements list.
  • Tags: used in conjunction with a Spaces setting for the property (Achievements – filter by tag), will filter out achievements that don’t have the tag in a space, no matter the other settings. The Spaces setting is off by default. Note: if you are not using this feature, make sure that the setting is off for the space, otherwise you won’t see any achievements in the modal within Scenario!

Reports

A number of reports are available to extract useful information from the raw data collected by Trophio. Note that the Collected items report relies on some custom configuration that cannot currently be set by normal users (all relevant information will appear in the Full report, however).

  • Full report: a complete report of the achievements of all users (the status and how many times they completed each), along with the related score.
  • Leaderboard: a report ranking the users by score.
  • Analytics: a report detailing the analytics data of each user.
  • Collected items: a report that allows seeing both the detailed data about item collection, and graphs examining the ratio of correct/wrong/missed answers on “answerable” items (both by item and by user), along with the collection ratio of “collectible” items.

Creating a report is only a matter of clicking on the property to examine, and selecting the time frame in the form that appears. Clicking on “Create Report” will use the selected dates, whereas clicking on “Create report (all dates)” will include all available data.


Trophio and Scenario

Using Trophio in the conversation editor

It is possible to add conversations directly from the space, using the conversation editor. This also allows to trigger gamification updates (such as starting or completing a task, or collecting an item) at any point in the conversation.

To enter the conversation editor, enter “Edit mode” and choose the desired bot to add a gamification task to.

Hovering over a bot’s feet (or tapping on them) will show a blue or gray wireframe box with three icons. To open the conversation editor, click or tap the middle one (with a speech bubble icon).

To add Trophio tasks, click on “More”: the conversation editor will pop up. It is a script that allows speech and conversations to be added to bots in a space.


This will show all actions that can be added through the conversation editor. In the bottom right corner there is a “Gamification” section.

By clicking on any of them, a small popup will appear to fill in some detail (in the example, “Start task” was chosen).

The gamification task used referenced in the action (which will be set to “started” in this case) can be selected in the “Task” dropdown, from the list of available ones. After choosing a task, this action can be saved by clicking on the green “Add action” button.

Note: if no tasks appear in the dropdown, check that they were added in Trophio first. If they were, try reloading Scenario.

The result is now visible in the conversation editor. Make sure to click “Save” in the conversation editor afterwards, or your changes will not be saved!

Adding Trophio tasks to items

It is also possible to add trophio tasks as onclick actions to objects.

Instead of clicking on the speech bubble like in the previous section, the cog icon should be clicked instead. A popup will appear

In the “onclick” field, click on the “Edit action” button. This will open the conversation editor for this object. Notice that the example is titled “Conversation with Player” and therefore it will also include actions related to the player (or user). From here, the steps detailed in the previous section can be followed.

Using Trophio in scripts

For any of these, “task” can be either the task’s shortcode or the propertyId, and “item” is the item’s name.

Tasks

  • Trophio.startTask(task)
    Sets the status of the task to “started”.
  • Trophio.completeTask(task)
    Sets the status of the task as “complete” and reward the player.
  • Trophio.getTaskStatus(task)
    Will return a string with the status of the task. Can be any of “not-started”, “started” or “complete”
  • Trophio.setTaskStatus(task, status)
    Allows to set any status to a task. Mostly useful when the status is determined programmatically.

Items

  • Trophio.collectItem(item)
    Will add the item to the user’s inventory, with a status of “collected”
  • Trophio.dropItem(item)
    Will set the status of the item to “dropped”, but will not remove it from the user’s inventory.
  • Trophio.checkIfCollected(item)
    Returns “true” if the item has a status of “collected”, false otherwise.
  • Trophio.getItemStatus(item, type)
    Returns the status of the item.
  • Trophio.setItemStatus(item, status, type)
    Allows to set an arbitrary status for a specific item.

Trophio and LMSs

It is possible to integrate Scenario and SCORM-compliant LMSs through either Articulate Storyline or Adobe Captivate. Please refer to this guide to set up score tracking with Articulate Storyline, and to this guide to set up score tracking within Adobe Captivate.

To report the user’s score in the LMS, first make sure that the combined task rewards (e.g. “points.200”) do not exceed the maximum score for the LMS module. Submitting the user’s result to the LMS consists of first obtaining the user’s current score, and then posting it to the LMS, like so:

var userScore = LB.gamificationController.getScore().status;
LB.Lms.submitScore(userScore);

How useful was this article?

Click on a star to rate it!

We are sorry that this article was not useful for you!

Let us improve this article!