Question Types & Logic Statements
Question customization for Sprig Surveys and Prototype Tests
Configuring a Study
Adding a Question
To add a question to a Survey or Prototype Test, you can click + Add question at the bottom of your study editor and select from a menu of Question Types available for your study type.
Alternatively, you can click on the ... ellipses to the right of each question module and select Insert New Below. A new question will be added below, and you can change the Question Type by clicking on the icon to the left of the new question module and selecting from the menu.
Question Type | Description | Study Type | Plan | Delivery Method |
---|---|---|---|---|
Text / URL prompt | Used to introduce or conclude a study, or permit the study respondent to navigate to a URL. | All (Survey, Prototype Test) | All | All (Web, Mobile, Shareable Link) |
Consent / Legal | Enables respondents to consent to disclaimers before conducting the study. | All | All | All |
Recorded Task | Allows you to record voice, video, and screen responses. | Prototype Test | All | Link |
Rating Scale | Also known as a Likert scale. A rating scale to measure respondent's attitudes toward a statement. | All | All | All |
Open Text | Open text response to a text question. The themes analysis is performed on the response to this question type. | All | All | All |
Multiple Choice Single-Select | For example, What color is your hair? Possible answers may be Black, Brown, Blue, Green, Gray, Unknown/Other. | All | All | All |
Multiple Choice Multi-Select | For example, Select all the fruit you like? Possible answers may be Orange, Apple, Banana, Pear, Peach, Grapefruit. | All | All | All |
NPS | For example, How likely are you to recommend Sprig to a friend or colleague? Answer on a scale from 0 to 10. | All | All | All |
Video and Voice | Enable respondents to provide video and audio-only questions and responses | All | All | All |
Deleting a Question
To delete a question:
- Click
next to the question.
- Select Delete.
Requiring a Question
By making a study question “Required”, users must respond to the question before they can move forward with the rest of the study. This can be helpful when you need to capture essential details like customer satisfaction KPIs and user contact information.
To require a specific question, go to the top of each question module and click the Required toggle. To switch the question back to optional, just click the Required toggle again. This feature can be used with any of the Question Types listed above.
Editing Questions
You can edit the question, subheader, placeholder, and button text by clicking into the text field.
Change the Order of Questions
Click on the question number to the left of each question module and drag and drop it to the desired position in your study.
Skip Logic
Skip Logic statements are a great way to ensure that customers see the question you want them to see. At the bottom of each question module, you can click Add Logic to configure.
For example, imagine a study question "How easy is it to use the cut & paste feature in Google Docs" with a response rating scale from 1 to 5.
If the user answers with a 2, it won't make sense to follow up with: "What do you like most about the cut & paste feature in Google Docs?".
Instead, you might consider some routing logic only to show a "What can we do to make the feature easier?" question based on the response/response group.
Please note, there are minimum SDK version requirements to support certain logic types
Platform | min SDK Version |
---|---|
Web | 2.24.0 |
iOS | 4.17.0 |
Android | 2.14.0 |
React Native | 2.15.0 |
Note: Linked based studies can support all logic types and do not require any update
If the SDK version(s) is insufficient, you will still be able to launch a survey, but end users without the minimum SDK version on the target platform may not be presented the survey, or they will receive a backwards compatible version of the study.
Specifically, the logic statements that require the min SKD version in the table above are:
- Use of logic conditions with AND grouping
- Logic conditions contains and does not contain for Open Text Questions
- Logic conditions that depends on the answer from a previous question
See our SDK Versions by Feature table to determine other limitations based on your SDK version.
Customize Thank You Card
By default, studies end with a Thank you card. You have the option to hide or customize the Thank you card for depending on the Delivery Platform.
- Click on the Thank you card module at the bottom of the Study Editor page.
- For Web and Mobile studies, you can decide to show/hide the Thank You card by clicking on Show Thank You Card checkbox. For link studies, the Thank You card will always be shown.
- You can edit the headline and subheader by clicking in their respective text fields.
Editing In-Progress Studies
You can edit In-Progress Studies to:
- Add questions to the Study.
- Change the order of existing questions.
- Edit/Add logic to existing or new questions.
- Make edits to question/response wording.
You cannot:
- Delete existing options for multiple choice type questions.
- Change the question type.
Warning
While you may change the question semantic of an In-Progress study, it is not advised as the change may impact response consistency and data cleanliness. Changes you make to a prototype will also immediately be reflected in the study. Consider restricting edits to correct any mistakes.
Creating a Prototype Test
Sprig enables you to conduct unmoderated prototype testing using designs you create in any major design tool, plus Google Drive and Webflow.
- Create a design or prototype in your tool of choice.
- Generate a URL for the design or prototype you’d like to test. Click here for help on finding the prototype link in your design tool.
- Click on *+ New Study.
- Select a template category under the Concept and Usability Tests section.
- Select your desired template and click Use this template as a starting point.
- Edit the questions as appropriate for your prototype test.
- Scroll to the question you’d like to add the prototype to and click Add prototype URL to insert the prototype link into the text field.
- Complete the study and audience configuration, and click Launch Prototype Test.
- Check back on the Study as you normally would and review the Responses.
Info
You can only use Prototype Tests with the Shareable Link delivery method.
Question Types
Text / URL Prompt
The Text / URL prompt is used to introduce or conclude a study, or permit the study respondent to navigate to a URL. It comprises two text fields and a button that can go to the next question or a URL.
The steps to create a study with a Text / URL prompt are:
- Select Text / URL Prompt from the Add Question menu.
- In the Headline field, type in the purpose of the Text / URL prompt.
- Type in your question or statement in the Body field. The Body field also supports text formatting, allowing you to customize your study further. You can change the character style (bold, italicized, and underlined), create lists, and add links. This feature is not supported on iOS devices or versions of the Web SDK before v2.14.9.
- Select when the respondent clicks the button whether you want the navigation to continue in the survey or link to an external URL.
- Type in the text for the button
- If you selected Button to link to external URL, type in the URL you want the respondent to navigate to.
Recruiting Participants also describes a use case where the Text / URL prompt is employed.
Info
You may want to send information about study respondents through the external link to identify them. If you selected Button to link to external URL, you can identify the visitor through the URL.
Identifying the Visitor
If you have configured the Button to link to external URL, you can send information about study respondents through the external link to identify them. For example, with the URL placeholder {{email}}
, the Visitor's email will be substituted and sent to the destination website. For Web, Link, and Android studies, the following parameters are supported:
Placeholder | Description |
---|---|
{{email}} | Visitor's email address |
{{user_id}} | Visitor's user ID |
For example, if you had specified a Button URL of:
https://website.com/schedule?id={{user_id}}&email={{email}}
and a visitor has the user ID of 23481
and the email [email protected]
set,
when the user clicks on the button, they will be sent to the URL:
https://website.com/schedule?id=23481&[email protected]
You can also link to another Sprig study. For example, to associate both studies with the same user, you may want to send the user ID to a Prototype Test from the original study. In this case, the Button URL would be:
https://a.sprig.com/abcd-study-link-wxyz?user_id={{user_id}}
The exact format for the user ID and email name-value pairs may vary by destination site.
If the value for a parameter is not available for the visitor taking the study, that parameter will be removed. For example, if only the user ID is present, the Button URL:
https://website.com/schedule?id={{user_id}}&email={{email}}
would be sent as:
https://website.com/schedule?id=23481
If neither is present, it would be just:
https://website.com/schedule
.
In addition, there are specific considerations for Link, Web, and Android:
Link Platform Studies
To make user ID and email available to be replaced in button URLs in link studies, include them as part of the study URL. Add them as query parameters, with the key user_id
for user ID and email
for email. For example, for a study with the link https://a.sprig.com/abcd-study-link-wxyz
, user ID 23841
, and email [email protected]
, format the link as https://a.sprig.com/abcd-study-link-wxyz?user_id=23841&[email protected]
, with a ?
before the parameters and &
between them. See link study documentation for details on how to configure this in your 3rd-party marketing platform.
Web Studies
To make user ID and email available to be replaced in button URLs in Web studies, ensure they're set on the user before the study is displayed. See Web: Identify Users documentation. User ID is persisted in browser local storage, while email is not and should be set again with each session. Your Web SDK version must be at least v2.15.3.
Android Studies
Similar to Web, to make user ID and email available to be replaced in button URLs in Android studies, ensure they're set on the user before the study is displayed. See Android: Identifying Users documentation. User ID is persistent locally, while email is not and should be set again with each session. Your Android SDK version must be at least v2.6.0.
Consent / Legal
You can incorporate a Non Disclosure Agreement into your Study for your participant's review and obtain their consent before proceeding with the study. The copy can be in text format and/or a PDF file. You can also capture the respondent's name. You cannot add a prototype to this question type.
Recorded Task
We will use the Recorded Task question type in this example to evaluate a prototype. The steps to create the study are:
- Click on + New Study in the Navigation Pane.
- Select the Prototype & usability testing template category.
- Select Test an Interactive Prototype and click Use this template as a starting point.
- Scroll to question 3 and update the Task and Task Details fields as appropriate. You can also adjust the Recording Options to be either Screen, video and audio, Screen and audio, or just Screen.
- In question 3, click Add Prototype to insert the prototype link into the text field.
- Complete the study and audience configuration, and click Preview Study.
- When satisfied with the Study, click Launch Study.
- Check back on the Study as you normally would and review the Responses.
Skip Logic Supported for Recorded Task Question Type
- is submitted*
- is given up
- is skipped%
*Is submitted is accepted when any value is selected by the respondent.
% is accepted when the respondent provides no answer.
Rating Scale
A Rating or Likert scale is a type of scale used in survey research that measures respondents’ attitudes towards a certain subject. You can change the Range or number of points; the Labels, numeric or a star of smiley emoji; and the Lowest and Highest Value Labels
Skip Logic supported for Rating Scale Question Type
- is equal to
- is not equal to
- is less than
- is less than or equal to
- is greater than
- is greater than or equal to
- is submitted*
- is skipped%
*is submitted, accepted when the respondent selects any value.
%is skipped, accepted when the visitor does not respond to a specific question. Available for Video & Voice, Open Text, and Multiple Choice Multi-Select questions
Open Text
Open-Ended questions contain a text field in which respondents can compose their own answers. This qualitative data is sometimes harder to analyze than quantitative data. However, the Open Text question employs Sprig's Thematic Clustering service to automate the analysis stage.
Skip Logic Supported for Open Text Question Type
- is submitted*
- is skipped%
- contains
- does not contains
*Is submitted is accepted when any value is selected by the respondent.
% is accepted when the respondent provides no answer.
Multiple Choice Single-Select
The multiple choice single-select question type allows a respondent to choose only one option from a list of possible answers.
Skip Logic Supported for Multiple Choice Single-Select Question Type
- includes at least one
- does not include
- is submitted*
*is submitted: is accepted when the respondent selects any value.
Randomized Order Supported
For Multiple Choice Single-Select questions, the order of responses shown to the user can be randomized using the Randomize Order dropdown menu.
Multiple Choice Multi-Select
The multiple choice multi-select select question type allows a respondent to choose only multiple options from a list of possible answers.
Skip Logic Supported for Multiple Choice Multi-Select Question Type
In the following example, the skip logic is configured so that the user is taken to an open-ended question if Other is selected. If any of the options are selected the user is taken to the end of the survey.
- is exactly: evaluates to TRUE when respondent selects the EXACT options specified.
Rule | Options | Result |
---|---|---|
Exactly [a, b] | [a, b] | true |
Exactly [a, b] | [a] | false |
Exactly [a, b] | [a, b, c] | false |
- includes all: evaluates to TRUE when respondents select ALL that are included within specified options.
Rule | Options | Result |
---|---|---|
Includes all [a, b] | [a, b] | true |
Includes all [a, b] | [a] | false |
Includes all [a, b] | [a, b, c] | true |
- includes at least one: evaluates to TRUE when respondents select one or more options specified.
Rule | Options | Result |
---|---|---|
Includes at least one [a, b] | [a] | true |
Includes at least one [a, b] | [a, b] | true |
Includes at least one [a, b] | [a, b, c] | true |
Includes at least one [a, b] | [c] | false |
- does not include: evaluates to TRUE when respondents select one or more options specified.
Rule | Options | Result |
---|---|---|
Does not include [a, b] | [c] | true |
Does not include [a, b] | [c, d] | true |
Does not include [a, b] | [a] | false |
Does not include [a, b] | [a, b] | false |
Warning
If you have multiple matching rows of logic, for example:
- includes at least one a or b = skip to 2
- includes all a and b = skip to 3
If the user selects a and b, they would be routed to question 2 The first set of logic that returns TRUE is accepted. In the example above, selecting a and b would activate the first set, before checking the second set.
Randomized Order Supported
For Multiple Choice Multi-Select questions, the order of responses shown to the user can be randomized using the Randomize Order dropdown menu.
Net Promoter Score
Net promoter score (NPS) is a widely used market research metric that typically takes the form of a single survey question asking respondents to rate the likelihood that they would recommend a company, product, or service to a friend or colleague. NPS is a commonly requested sentiment score that investors and boards review across companies, segments and verticals. For more information on NPS, click here.
Skip Logic Supported for NPS Question Type
- is equal to
- is not equal to
- is less than
- is less than or equal to
- is greater than
- is greater than or equal to
- is submitted*
*is submitted is accepted when any value is selected by the respondent.
Video and Voice
As well as Open Text questions and responses, Sprig also supports video and audio-only questions and responses. The video and voice responses are automatically transcribed and optionally translated. Contact Sprig Support to enable the translation service. The transcription enables the same AI analysis of textual responses to be conducted on video responses. However, video and audio responses provide an additional emotional dimension that is not always visible in text-only responses. Usually, there is a lower response rate to voice and video questions due to the higher effort required by the study recipient than other study methods. Consider focusing voice and video questions on a specific area of interest and only share that study with recipients you think the topic would be particularly relevant.
The steps to create a study with video-enabled questions and responses are:
- Select Video & Voice from the +Add Question menu.
- Click Request Permissions to enable Sprig to request access to your camera and microphone.
- Click Allow for the browser to permit Sprig access to your camera and microphone.
- Click
Record to begin the recording countdown and will automatically begin recording for you to record your question. Optionally, click
Video to turn off video and record the audio only.
- Click
to Stop recording.
- Click
to Play back your recording.
- If you are not happy with the recording, click
to Delete your recording and start a new recording.
- When you are happy with the recording or do not need to add any more questions, click Audience to proceed with configuring the study.
- In the Design Tab, a preview of the survey is displayed on the platform you have selected.
- When satisfied, return to the app.sprig.com browser tab and click Launch Survey.
- Distribute the survey link to prospective respondents using your usual methods.
- Note that all respondents have to give permission in their browser to enable camera and microphone access.
Skip Logic Supported for Video & Voice Question Type:
- is submitted*
- is skipped%
*Is submitted is accepted when any value is selected by the respondent.
% is accepted when the respondent provides no answer.
Downloading a Video Response
- Click on the study from which you want to download a video response.
- Click on Responses.
- Click on Download CSV to download the responses CSV file.
- Open the CSV file in a spreadsheet.
- Locate the question and response you would like to download.
- Notice that the response cell has a field labeled downloadUrl.
- Copy that URL in your browser.
- Once the video loads, right-click on the video and select Save video as to download a copy of the video.
Content Security Policy
Supporting Video and Voice questions for Web studies may require you to update your web application's Content Security Policy (CSP). This may be required because Sprig uses third-party libraries to support Video & Voice questions, including fetching an external stream of the question and uploading the response.
The following list of sources is required to use Video & Voice questions:
- Base64 SVGs and fonts.
- Connecting to Mux (for streaming and short video uploads).
- Connecting to Google APIs (for long video uploads).
- A worker source required by our third-party library (videos).
Examples are shown in the following CSP source list:
<meta
http-equiv="Content-Security-Policy"
content="img-src data: https://*.mux.com;
connect-src blob: data: https://api.sprig.com https://*.mux.com https://storage.googleapis.com https://cdn.sprig.com https://cdn.userleap.com;
font-src data:;
media-src blob: https://*.mux.com;
worker-src blob:;"
/>
Info
As every company has different security policies the example may not reflect the complete configuration. You may need to add additional keys and values in order to comply with your own organization’s policies.
Troubleshooting Errors
After creating your first study with Video and Voice questions, test its display on your website using these instructions. Check your browser console for any CSP-related errors if the questions are not rendering correctly or responses aren't uploaded. You may have to work with your engineering and security teams to update your website's or app's CSP settings to resolve the errors.
Languages
Sprig supports over 70 languages. A question may be in one language, and its response may be in one or more other languages. Upon request to support, all study responses are then translated into English to enable analysis that uncovers themes (similar sets of responses) in one dataset. For example, you may have one study with responses in French and English. The French responses will be translated, and a common set of themes will be developed for both sets of responses.
For Web and Mobile studies, you may also decide to trigger a study in one language or another based on the language in the page being displayed or the browser's locale. When you create separate studies for each language, there will be a different dataset for each study. If there is an Open Text question, there is a translation to English and a corresponding analysis for each study. The Open Text theme analysis is performed on the original English or an English translation.
Question UI element translation
For web and mobile studies, by default, the following question UI elements are translated based on the survey respondent's browser/system language (example given in English): the question subtitle ("This will help us improve your experience."), open text placeholder ("I think that..."), "Next" and "Finish" buttons, and end text ("Thanks for your input!"). They are translated into the following languages: German (DE), Spanish (ES), French (FR), Hindi (HI), Italian (IT), Japanese (JA), Korean (KO), Portuguese (PT), Russian (RU), and Chinese (ZH). For link surveys, these elements will remain in English. To disable this translation, you may set custom values for these UI elements.
Updated about 1 month ago