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. In the Navigation Pane, click + New Study.
  2. Select Create from Scratch or click Browse Templates to customize a template.
  3. Select Text / URL Prompt from the Add Question menu.
  4. In the Headline field, type in the purpose of the Text / URL prompt.
  5. In the Body field, type in your question or statement. 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.
  6. Select when the respondent clicks the button whether you want the navigation to continue in the survey or link to an external URL.
  7. Type in the text for the button
  8. 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.

️ Note

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 identity through the URL

If you have configured 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 Concept 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.