Configuring a Study

All question types are available on all plan types

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

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.

Question Types

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

1. is equal to
2. is not equal to
3. is less than
4. is less than or equal to
5. is greater than
6. is greater than or equal to
7. is submitted^*
8. 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

1. is submitted*
2. is skipped^%
3. contains
4. does not contains

*Is submitted is accepted when any value is selected by the respondent.
^% is accepted when the respondent provides no answer.

Matrix / Accordion

🚧

Please note, there are minimum SDK version requirements to support all Matrix Question functionality

Display Behavior

• Desktop Web: Defaults as full scale matrix, Option to Always display as accordion on desktop
• Mobile Web: Always as accordion (full scale matrix not supported)
• Mobile Apps: Always as accordion (full scale matrix not supported)

Skip Logic Supported for Matrix Question Type

1. is completely submitted*
2. is only partially submitted*

*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

1. includes at least one
2. does not include
3. is submitted*

*is submitted: is accepted when the respondent selects any value.

Randomized Order Supported

The order of responses shown to the user can be randomized using the Randomize Order dropdown menu. Additionally, users can configure choices to be pinned to the bottom of the list of responses by adding a Pinned Choice, even alongside an Other choice.

Display as Dropdown

You can choose to display MC as a dropdown instead of a list by toggling Show choices in a dropdown ON

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.

• includes all: evaluates to TRUE when respondents select ALL that are included within specified options.

• includes at least one: evaluates to TRUE when respondents select one or more options specified.

• does not include: evaluates to TRUE when respondents select one or more options specified.

🚧

If multiple skip logic statements are true, visitors will be routed to a randomly selected true logic statement

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 a randomly selected TRUE logic statement. In the example above, a visitor would have an equal chance of landing on question 2 or 3.

Randomized Order Supported

The order of responses shown to the user can be randomized using the Randomize Order dropdown menu. Additionally, users can configure choices to be pinned to the bottom of the list of responses by adding a Pinned Choice, even alongside an Other choice.

None of the Above Choice

For Multiple Choice Multi-Select questions, users can also configure a None of the Above choice that, when selected, other options are deselected.

Display as Dropdown

You can choose to display MC as a dropdown instead of a list by toggling Show choices in a dropdown ON

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

1. is equal to
2. is not equal to
3. is less than
4. is less than or equal to
5. is greater than
6. is greater than or equal to
7. is submitted*

*is submitted is accepted when any value is selected by the respondent.

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:

1. Select Text / URL Prompt from the Add Question menu.
2. In the Headline field, type in the purpose of the Text / URL prompt.
3. 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.
4. Select when the respondent clicks the button whether you want the navigation to continue in the survey or link to an external URL.
5. Type in the text for the button
6. 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:

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 different study 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.

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:

1. Select Video & Voice from the +Add Question menu.
2. Click Request Permissions to enable Sprig to request access to your camera and microphone.
3. Click Allow for the browser to permit Sprig access to your camera and microphone.
4. 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.
5. Click to Stop recording.
6. Click to Play back your recording.
7. If you are not happy with the recording, click to Delete your recording and start a new recording.
8. When you are happy with the recording or do not need to add any more questions, click Audience to proceed with configuring the study.
9. In the Design Tab, a preview of the survey is displayed on the platform you have selected.
10. When satisfied, return to the app.sprig.com browser tab and click Launch Survey.
11. Distribute the survey link to prospective respondents using your usual methods.
12. 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:

1. is submitted*
2. 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

1. Click on the study from which you want to download a video response.
2. Click on Responses.
3. Click on Download CSV to download the responses CSV file.
4. Open the CSV file in a spreadsheet.
5. Locate the question and response you would like to download.
6. Notice that the response cell has a field labeled downloadUrl.
7. Copy that URL in your browser.
8. 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.