Support Home Launching Your Study Data

Data

  • Overview
  • Downloading data
  • Accessing individual participant data
  • Combining data
  • Understanding and analysing data

Overview


This guide describes how to access your participant data from your experiment. For guidance on how to analyse your data once you've downloaded it, check out our Data Analysis Guide.


Downloading data


All data you collect is owned by you. Data can be downloaded from the Data tab in the Experiment Builder.

The Data Tab will appear slightly different depending on whether you are using New Experiment Builder or Classic Experiment Builder.

New Experiment Builder:

Screenshot of the Data Tab in New Experiment Builder. Change Version dropdown and Download Experiment Data button are highlighted.

Classic Experiment Builder:

Screenshot of the Data Tab in Classic Experiment Builder. Version Picker dropdown and Download Experiment Data button are highlighted.

Respondent data is stored by version, meaning that if you make changes to your experiment during data collection, data from respondents who completed the earlier version of the experiment will be stored separately from data from later respondents. In New Experiment Builder, at the top-left, you can see at a glance how many participants are included in the currently selected version and in other versions.

To download your data, use the Change Version/Version Picker dropdown to select the version of your experiment that your participants completed. Then click Download Experiment Data.

You can find out which version of your experiment participants completed from the Participants Tab, as shown below:

A screenshot of the Participants Tab in the experiment builder. A purple box highlights the Version column of the participant table.

Once you have selected the correct version, you can choose to download your data from each task and questionnaire separately, or all together in a zip file. We also have a useful guide on Combining your data.

Pro Tip

We are currently developing a new feature, Data Hamster, that allows you to combine data across experiment versions. Find out how to request access in our Data Hamster Guide.

To download all your data, click the button labelled Download Experiment Data. To download data from a specific task or questionnaire, click the task or questionnaire node in the experiment tree in the Data tab. In both cases, you will then see the data generation options:

Screenshot of the data generation options when clicking Download Experiment Data
Info

This screenshot shows the new Experiment Builder interface. If you’re still using the classic interface, it will appear slightly different.

Select what file type you’d like your data to be downloaded in: XLSX, CSV (comma, semicolon or tab delineated), or ODS.

You have the option to unblind your data, which displays Public IDs along with Private IDs in your metrics, meaning that your participants could potentially be identified.

You can also select the timeframe of data you’d like to download: all data, from today, from the last five days, or from a custom time period.

Task data will be generated in Long-Format (one row per trial). For Questionnaire data, you have the option to download data in either Long-Form or Short-Format (one row per participant). Check out our guide to Data Format for more information, and follow our walkthrough on how to clean and transform your data into Short-Form using R.

Warning

Scores calculated in the Scoring tab in Questionnaire Builder 2 are included in both short-form and long-form data. However, other data from the Store in Questionnaire Builder 2, and from the Script widget in Questionnaire Builder 1, are not included in short-form data. If you want to include other Store data, or any data from a script widget, download the long-form version.

If you select short form data, you can also choose whether you want your column headers to use the name and the unique ID of the associated questionnaire object (to guarantee uniqueness) or just the object name (if you have already given your questionnaire objects unique names). You can also optionally choose to add a second header row to your questionnaire data containing the full text of each question.

If you select long form data, you can choose to include additional questionnaire metrics. If this box is ticked, your questionnaire data will include detailed information on participants' interactions with your questionnaire, such as whether they went back to a previous page and changed their answers.

Once you are happy with the options you have selected, click Generate. Generating data does not affect your tokens, and you can generate your data an unlimited number of times.

Screenshot of the Data Generation window where data is generating. Screenshot of the Data Generation window once data has finished generating and data is ready to download.
Info

These screenshots show the new Experiment Builder interface. If you’re still using the classic interface, it will appear slightly different.

Once your data has been generated, click Download Data. If your data takes longer than 24 hours to generate, please Contact Us!

If your data file is blank, check that participants have completed the version you’ve downloaded data for, and that any incomplete participants whose data you want to download have been included.

To regenerate your data with different settings, scroll down past the Download Data button, select your preferred settings, and click Regenerate Data.

To find out how to understand and analyse your data, check out out Gorilla data analysis guide.


Accessing individual participant data


If you wish to download the data from a specific participant, you can do this via the Participant Tab. To access all data from all participants, see the downloading all data section of this guide.

To download the data from a single participant, navigate to the Participants Tab of the Experiment Builder, and click the Actions button, and select 'Download Data'. You can only download the data from participants that have Completed the experiment, or have been manually included in the dataset.

A screenshot of the Participants Tab in the experiment builder. The Actions button has been clicked, revealing the option to Download Data.

Once you click Download Data, you will be able to choose the format and filetype of the data, and whether you would like to Unblind the data.

A screenshot of the data generation window for an individual participant.

Combining data

It's good practice to keep performance data, demographic data and identifying data separate, which is why we give you a separate file for each node. You can combine data from tasks into a single file, and data from questionnaires into a single file.

We have a couple of guides to help you combine your data. We have created an R Studio walkthrough and a video guide in Excel which provide more details on how to combine your data files. You can also see an example of how to do this with data from a real experiment, and download the relevant R script, in this Gorilla Academy case study.


Understanding and analysing data


Everything you need to know about understanding your data can be found in our Data Analysis guide.

Check it out to understand:

  • Data format
  • What each data column means
  • How to tidy your data ready for analysis in Excel and RStudio
  • How to handle advanced data such as mousetracking and eyetracking