Comprehension Game

Creating an account

Creating an account for Comprehension Game is possible at https://api.comprehensiongame.com/api/register/. If you can’t find your email confirmation message after creating an account make sure to check your spam folder. If you don’t receive the email confirmation message within 24 hours please contact technical support.

Web

The web version can be played on any modern browser, such as Chrome, Edge, or Firefox, at https://api.comprehensiongame.com/play/.

Android

The Android version is available on the Google Play store: https://play.google.com/store/apps/details?id=com.tokapeli.

    iOS (temporarily unavailable)

    1. Install TestFlight
    2. Join the external testing group by tapping this. The link will add your Apple ID (email you use to log in to Apple devices and services) to the tester group that enables Beta-testing via Apple’s TestFlight application. If you open a link without TestFlight on your device it will open a website with more information about testing.
    3. Open TestFlight from the application library if it didn’t open by the link. 
    4. Press “Install”
    5. Follow the last steps under the Android section starting from the 2nd point. 

    Comprehension Game Creator

    Comprehension Game Creator is available at https://api.comprehensiongame/creator/. The same user account as in the Comprehension Game is used in Creator.

    Creating a learning package

    A learning package includes the core content of the subject to be taught as a series of statements. False claims reflecting common misconceptions should be added to the mix. The learning package can be divided into sections that are played in a sequence, so not all claims in the learning package need to be mastered at once. The length of one section can be, for example, 20-30 claims. The number of claims should be adjusted according to your target audience and the complexity of the topic, keeping in mind that short sets of claims may not lead to as many repetitions as is required for effective learning.

    1. You can start creating a new learning package on the Creator’s “Learning packages” page by pressing the “Add new” button. If you don’t see the button you don’t have the required permission to create learning packages.
    2. Please note while creating a learning package:
      • For now claims should be written independently of each other, i.e. one shouldn’t have to read one claim to understand another. This is required because the order of claims is randomized in the game on repeat attempts. Randomization aims to prevent associating the truth value of a specific claim with the order of claims.
      • Required fields are marked with an asterisk (*).
      • Some fields show a tooltip with a more detailed description of the field if you hover your mouse over them.
      • Claims are grouped according to their section value. In the game, the player has to correctly determine the truth value of each claim in the first section before moving to the second section and so on.
    3. The learning package can be saved by pressing the “Save” button.

    Editing a learning package

    A learning package can be edited by choosing it in the learning packages list, making changes to it, and then saving it. The edit view’s dropdown menu, which is accessible by pressing the three dots next to the “Cancel”-button, has the following actions available:

    • Save a copy: Saves a copy of the learning package and switches to it. User permissions aren’t copied.
    • Replace package: Replaces all the content (across all translations) of the learning package with the content of another learning package.
    • Replace translation: Replaces the current translation with a translation from another learning package.
    • Import translation: Adds a translation from another learning package to the current learning package. A learning package can’t have multiple translations of the same language, so if e.g. a learning package already has a translation for English another English translation can’t be imported to it.

    Multiple claims can be selected by pressing the circle at the upper left corner of each claim. When multiple claims are chosen the following actions become available in the aforementioned dropdown menu:

    • Copy selected to new: Copies the selected claims to a new learning package and switches the edit view to it.
    • Copy selected to…: Copies the selected claims to the chosen learning package and switches the edit view to it.

    If you want to save changes to a learning package so that they don’t yet become available to the users of the learning package do the following:

    1. Save a copy of the learning package.
    2. Do your changes in the copy.
    3. When you are ready to publish the changes open the original learning package and choose “Replace package”, “Replace translation” or “Import translation” depending on your needs.
    4. Save the original learning package. After saving you may delete the copy if you have no further need for it.

    Learning package settings

    The learning package’s settings can be opened by pressing the cog icon in the edit view.

    • Prune condition: Defines after how many consecutive correct answers for a specific claim the claim isn’t displayed anymore during reattempts. A value of 0 means that the claim is never removed from the rotation. Some removed claims are randomly returned to the rotation, so even if the prune condition is fulfilled the claim may show up again. If an incorrect answer is given to a claim that was removed from the rotation it will be returned to the rotation.
    • Easy-mode condition: Defines after how many consecutive incorrect answers the player will be displayed X, or as many as there are available, claims that the player has already given a correct answer for. The “Easy-mode length” setting defines X. A value of 0 will disable this feature.
    • Easy-mode length: See “Easy-mode condition” above.
    • Explanation condition for correct: Defines how many times a correct answer has to be given for a specific claim before its explanation will be displayed. A value of 0 means that the explanation is never displayed.
    • Explanation condition for incorrect: Defines how many times an incorrect answer has to be given for a specific claim before its explanation will be displayed. A value of 0 means that the explanation is never displayed.
    • Correct immediate feedback condition: Defines how many times a correct answer has to be given for a specific claim before immediate feedback (was the answer correct or not) is given for it. A value of 0 means that feedback is never displayed. If either this or “Incorrect immediate feedback condition” is fulfilled the feedback is displayed.
    • Incorrect immediate feedback condition: Defines how many times an incorrect answer has to be given for a specific claim before immediate feedback is given for it. A value of 0 means that feedback is never displayed. If either this or “Correct immediate feedback condition” is fulfilled the feedback is displayed.

    Printing a learning package

    A learning package can be printed by downloading it in a text format and using a fitting program for printing the text.

    1. Choose from the edit view’s dropdown menu “Export as” -> “Text”.
    2. Open the downloaded text file in a program, such as Word or Notepad, that allows you to print it.

    Weighting claims

    Some claims can be given a higher weight, so that they will yield a higher reward after a correct answer when playing the gamified variant of Comprehension Game. Respectively, claims with a lower weight yield a lower reward. Changing the weights doesn’t affect the combined reward of all claims in a learning package. The weights only affect the size of the reward of claim in proportion to other claims within a section of a learning package. E.g. if claim A has a weight of 1 and claim B has a weight of 10, the reward of claim B is ten times that of claim A. If the weight of A and B is 1 their rewards are equal in size but the combined reward A + B would be the same as in the previous case.

    1. Open the advanced settings for a claim by pressing the pen icon within the claim’s field.
    2. Enter a weight to the “Weight” field.

    Sharing learning packages

    Other users can be given permission to view (play), edit, and/or share a learning package. By default, a new learning package is only visible to its creator.

    Learning package specific share

    In a learning package’s edit view, in the permissions section, other users may be given permissions for the learning package. The receivers have to confirm the permissions they are given by following a link sent to their email.

    1. Press the “Add user” button in the permissions section.
    2. Enter the username or email of the user you want to give permission to the text field that was created. (NOTE: You have to enter a username or an email of an existing user.)
    3. Choose which permissions to give to the user.
    4. Press the “Save” button.

    Sharing learning packages with groups

    The groups functionality makes it easier to share multiple packages with multiple users. Groups can be edited in the Creator’s “Groups” section, which is accessible through the menu on the left side of the page. Any users invited to a group have to confirm the invite by following a link sent to their email.

    1. Add a new group by pressing the “Add new” button or choose an existing one.
    2. Add a user to the group by pressing the “Add member” button.
    3. Enter the user’s username or email to the created input.
    4. Add permission by pressing the “Add permission” button.
    5. Choose the learning package, whose permissions you want to share, using the created select menu.
    6. Choose the permissions to share for the learning package using the checkboxes.
    7. Press the “Save” button.

    A persistent share link, which anybody can use to join the group as a member, may be created for the group by pressing the “Share” button. Group managers can edit the group, i.e. add and remove members, managers, and permissions. Adding managers works the same way as adding members.

    Statistics

    On the Creator’s “Statistics” page you may inspect your own and others’ game data in a visualized format. Start by choosing a learning package, and which data you want to inspect. By default, the data of all users, whose data you have permission to view, is displayed. By using the filters you can view the data of e.g. only one user.

    The data can be downloaded in a CSV format, which allows it to be viewed e.g. in a spreadsheet program. The download provides the filtered portion of the data.

    Homework

    You may instruct your students to play a certain package e.g. verbally and later check through the “Statistics” page to see if they actually played the game. For this to be possible do the following:

    1. Choose an existing or create a new learning package.
    2. Share the chosen learning package with your students using the group functionality. Using groups to share the learning package automatically also enables you to view your students’ play data.

    Sharing play data

    Other users won’t be able to view your play data unless you permit them.

    Play data sharing with groups

    A group’s owner and managers are permitted to view all the play data of the group’s members for those packages that they themselves are permitted to play.