Researcher Guide

• Question Types
  • Normal Curve Questions
    • Example
    • Settings
  • Tradeoff Questions
    • Line Graph Tradeoff
      • Example
      • Settings
    • Bar Graph Tradeoff
      • Example
      • Settings
• Coordinating with Qualtrics
  • Basic use
    • Sending the ID from Qualtrics
    • Recieving Data into Qualtrics
    • Branching to different ss questions based on qualtrics answers
    • Branching to different ss questions based on embedded data
    • Semi-automatic forwarding to different qustions
  • Qualtrics Help
• Working with data after the study

What it does

Serverless survey transforms a configuration file of questions and plot settings and generates a set of html files that comprise a survey that will, upon submission forward to another service, typically qualtrics.

Recommended Use

We recommend using our provided template repo and creating one repository per study or project. A study may have multiple surveys in it, but will all be hosted in the same place. Treat each repository as a separate folder, with no nesting.

In this case your overall workflow will include the following steps:

1. Use template (more details in template README)

2. Start your qualtrics study(ies) to get the URLs for forward from the generated questions

3. Set up your study in the configuration file following yaml guide, page settings, and question specific settings

4. Build the survey using actions in your study repo (more details in template README)

5. Use the generated instructions to set up your qualtrics survey to forward and recieve data using embedded data following our qualtrics instructions page

6. check at the end of the instructions page that your study does not need to send more than the maximum amount of data to qualtrics at once

7. Take your survey, entering plausible values to check that your data is showing up as expected in qualtrics (check all of the surveys).

8. Run your study!

Notes:

• your repo can be private, but you do have to turn on the github pages

• there is a limited number of characters that can be passed, but it is not well documented and varies browser to browser. We recommend no more than 2000 characters passing to qualtrics at each time. You can split into multiple surveys for longer studies.

You’ll then have a set of data files to merge together to combine multiple sections and be able to analyze your data.

Use details

There is a CLI tool and it generates html files in a single folder. These files can then be hosted anywhere.

The CLI includes two main commands:

• ssgeneratehtml generates the html files and instructions md file.

• sslengthcheck checks the length of the forwarded message after a study has been generated. It uses the instructions file as input