Search…
Introduction
Getting Started
Setup
Creating your experiment
Running your experiment
Updating your experiment
Guides
Tutorial: Your First Experiment
The Admin Panel
Special Empirica Elements (and how to modify them)
Deploying Your Experiment
Managing the Data
Conceptual Overview
Game Life Cycle
Concepts
Randomization & Batches
API
FAQ
I need help!
The Processes and Elements of an Empirica Experiment
Managing Players and Games
Community Demos
Guess The Correlation
Random Dot Motion
Room Assignment
Tips & Tricks
Helpful Linux Commands
Code Editors
Links
Empirica website
Twitter
GitHub
Powered By GitBook
The Admin Panel
We are currently updating documentation for Empirica v2. The information here is incorrect.

Structure

The Admin Panel, that you can access at <url>/admin is made of two parts:
  • The monitoring tab
  • The configuration tab

The Monitoring Tab

Here you can create and run batches of game, monitor player statuses, and export the data.

The Configuring Tab

Here you can create factors, to then make treatments, to then be used with lobby configurations when creating batches.

Deleting Game and Player data but keeping Treatments, Factors, and Lobby Configurations

In the Monitoring tab, you can click on Reset and then Reset Games to clean the data from previous instances/tests. It will remove the current batches, games, players but it will keep the treatments, factors, and lobby configurations.

Deleting all the data and settings of an experiment

In the Admin Panel, in the Monitoring tab, you can click on Reset and then Reset Entire App to clean the whole database. It will remove all of the data in the database.

Retiring Players: How players can play again, even if they got gameFull, LobbyTimedOut, etc.

Players can only play once. If there was a problem (e.g., the lobby timed out or the game was full), or if you want players to play again, you can retire them which allows them to play again.
In the monitoring tab, in the players tab, you can see the status of every Player. At the bottom of the page, you can select a type of exit status and retire every player with that status.
Once retired, players can refresh their page/return to the link of your game and they will be randomly allocated to a game with the same treatment as before. They are allocated to a game with the same treatment so that they don't discover a game with different conditions or instructions.

I tried to retire a player but got this error: Failed to return players: Error: ID cannot exceed 256 characters in players update [400], what should I do?

This means that the player id of the player was too long. If you go to your data base you can find that player and modify their player id so that it is not as long.

Lobby Configuration

In the Configuration tab, in Lobby Configurations, you can set important aspects of the Lobby such as:
  • The Timeout Type (whole lobby or individual)
  • The Timeout Duration in Seconds
  • The Timeout Strategy (fail, ignore)
  • The Extend Count

What happens when the Lobby times-out?

When players start a Game, they go through Intro Steps, and when they have finished the Intro Steps they arrive at a Lobby where they are set as ready and they wait for other players to join until there are as many ready players as the number set in the playerCount factor.
However, it is possible that there won't be enough players and you don't want players to wait indefinitely in the Lobby for others to join. Hence, you can set a time after which the Lobby times-out.
This is set in the Configuration tab, in Lobby Configurations. What happens when the Lobby times-out depends on these settings.
If Timeout Type is set to Lobby then the countdown to the timeout starts as soon as the first player reaches the Lobby. Here the Timeout Stragety determines what happens when the Lobby times-out:
  • If set to Fail, the Game will fail (it will be terminated) and the current players waiting in the Lobby will be sent to the Exit Steps set for them with their Exit Status set to gameLobbyTimedOut.
  • If set to Ignore, it will start the Game anyway, even if there aren't enough players.
If Timeout Type is set to Individual then a different countdown starts for each player when they reach the Lobby. If the Lobby times-out, the player will be sent to the Exit Steps set for them with their Exit Status set to playerLobbyTimedOut, but the Game will not fail (i.e., players can still join the game). With Extend Count you can set the number of times the player needs to timeout before they are sent to the Exit Steps. If Extend Count is set to 0, then after one timeout the player is sent to the Exit Steps, if it is set to 1, then after two timeouts the player is sent to the Exit Steps.

Importing and exporting my treatments, factors, and lobby settings

In the configuration tab there are Import and Export buttons.
The Export button will produce a .yaml file of your treatments and factors.
The Import button will allow you to select a .yaml file to set the treatments and factors.
If you want to share your app with someone, it is important to provide this .yaml so that they can use the same treatments and factors as you.
Previous
Part 5: Adding Bots
Next - Guides
Special Empirica Elements (and how to modify them)
Last modified 4mo ago
Copy link
Outline
Structure
The Monitoring Tab
The Configuring Tab
Deleting Game and Player data but keeping Treatments, Factors, and Lobby Configurations
Deleting all the data and settings of an experiment
Retiring Players: How players can play again, even if they got gameFull, LobbyTimedOut, etc.
I tried to retire a player but got this error: Failed to return players: Error: ID cannot exceed 256 characters in players update [400], what should I do?
Lobby Configuration
What happens when the Lobby times-out?
Importing and exporting my treatments, factors, and lobby settings