Survey

SurveyCompo offers a powerful and versatile way to design surveys using a flexible data model written in JSON. This section introduces you to the key building blocks of a SurveyCompo survey.

Survey Structure

Imagine your SurveyCompo survey as a journey. Here's a visual breakdown of the key elements:

Start Screen (Optional)

Welcomes users, sets the stage, and provides initial instructions.

Survey Pages

The heart of your survey, where questions are asked and data is collected. Each page is made up of one or more "Blocks". SurveyCompo gives you the freedom to design your surveys in either of these styles:

• Single Page: All questions are displayed on one page.
• Multi-Page: Questions are divided into multiple pages, guiding users through the survey.

Blocks

The fundamental units that hold your questions. They contain input controls where users provide their responses. SurveyCompo offers a variety of input controls, from text boxes to specialized elements like Likert scales.

End Screen (Optional)

Signal the end of the survey.

SurveyCompo offers two customizable end screens to manage your survey flow.

• Completion Screen: Thanks respondents and may provide further instructions.
• Abort Screen: Informs users if they don't meet survey criteria.

The User Flow

Imagine a user journey through the survey:

1. Invitation: The optional Start Screen introduces the survey.
2. Questions and Answers: Users navigate through Survey Pages, providing responses in Blocks.

3. Outcome:

4. Success: Upon completion, they see the Completion Screen.

5. Disqualification: If ineligible, they are directed to the Abort Screen.

Survey JSON Example

SurveyCompo uses JSON (JavaScript Object Notation) to define your survey's structure. Think of JSON as a blueprint, using key-value pairs to describe each survey element and its properties. Here's a simplified example:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25

{
  "name": "My Survey",
  "startScreens": [
    /* ... */
  ],
  "pages": [
    {
      "blocks": [
        {
          "inputs": [
            /* ... */
          ]
        }
      ]
      /* ... */
    }
    /* ... */
  ],
  "completeScreens": [
    /* ... */
  ],
  "abortScreens": [
    /* ... */
  ]
}

Survey Data Keys