# Connect your survey with redirect links

> Add your survey link to Self-Serve, record vsid and surveyid, set up our redirects in Qualtrics or another survey platform, and pass the Testing Survey step.

Source: https://www.verasight.io/docs/run-your-study/connect-your-survey

Add your survey link to Verasight Self-Serve, then set up our redirects in Qualtrics or [any survey platform](https://www.verasight.io/docs/run-your-study/connect-your-survey#use-another-survey-platform) that can record link values. Each redirect must pass a test before you pay and launch.

## Before you begin

Have these ready before you click **New survey**:

- A [researcher account](https://www.verasight.io/docs/get-started/create-a-researcher-account).
- A finished survey. [Build your survey](https://www.verasight.io/docs/run-your-study/build-your-survey) covers survey platforms and Doc2Survey.
- An active survey and its anonymous link, not the edit or preview link. It is the one link anyone can use to take your survey, and it never changes.
  - To find it in Qualtrics, open **Distributions** and choose **Anonymous link**.
  - For a new survey, choose **Web**, click **Use Anonymous Link**, then click **Resume response collection**.
  - The first time you publish a survey, Qualtrics also shows its anonymous link in the confirmation window.
- A survey that fits the [survey rules](https://www.verasight.io/docs/run-your-study/what-a-survey-can-include). You confirm the quota and screen-out rules in [Step 1](https://www.verasight.io/docs/run-your-study/connect-your-survey#step-1-configuration).
- If you use an attention check, it must come from Verasight's [pre-approved list](https://www.verasight.io/docs/run-your-study/what-a-survey-can-include#your-own-attention-check).

## How the survey link and redirects work

When a panelist opens your survey, we add two parameters to your survey link:

- `surveyid` identifies the survey.
- `vsid` identifies the panelist.

For example, www.survey.com becomes www.survey.com?surveyid=123&vsid=user123. Your survey has to record both.

When a respondent's survey ends, your survey sends them back to us through a redirect link. The redirect tells us how they left, and the `vsid` at its end tells us who they were. `vsid` is also the column that [joins your survey responses to your data file](https://www.verasight.io/docs/data-and-methods/your-data-file#join-your-survey-export-to-your-data-file).

Your survey can use up to three redirect links:

| Redirect (name in Self-Serve) | Send respondents here when | When you need it |
|---|---|---|
| [Completes](https://www.verasight.io/docs/run-your-study/connect-your-survey#completes) | They finish the survey. | Always. |
| [Do Not Consent to Participate](https://www.verasight.io/docs/run-your-study/connect-your-survey#do-not-consent-to-participate) | They actively decline your consent form. | Only if your consent form has an opt-out choice, such as "No, I do not want to participate in this survey". |
| [Fail Attention Check](https://www.verasight.io/docs/run-your-study/connect-your-survey#fail-attention-check) | They consent but fail your attention check. | Only if your survey has an attention check. |

Every redirect link from Self-Serve has the same form. This example is the Qualtrics version:

```
https://backend.verasight.io/surveys/redirect?surveyid=__vskey__<your survey id>&vsref=<1, 2 or 3>&vsid=${e://Field/vsid}
```

`vsref` is 1 for Completes, 2 for Do Not Consent, and 3 for Fail Attention Check. The example is an illustration and does not work as a link.

Each redirect link is unique to your survey and to its path. Copy it from Self-Serve with the copy button next to it. Do not type it, edit it, or reuse a link from another study.

> **Warning:** A redirect link built or changed by hand is not recognized. Respondents who reach it do not return to Verasight.

## Step 1: Configuration

In Configuration, you choose your sample, enter your question counts, add your survey link, and record `vsid` and `surveyid`.

1. Choose a [sample type](https://www.verasight.io/docs/run-your-study/choose-a-sample-type) and a sample size.
2. Enter your [question counts](https://www.verasight.io/docs/run-your-study/what-a-survey-can-include#count-your-questions) for the longest path a respondent can take through your survey.
3. Select both confirmations of the [quota and screen-out rules](https://www.verasight.io/docs/run-your-study/what-a-survey-can-include#quotas-and-screen-outs):
   - **I confirm that my survey does not contain quotas.**
   - The confirmation that your survey only terminates respondents who decline consent or fail an attention check, and has no other screen-outs.
4. On the Survey URL card, enter a name in **Survey Name (internal only)**. Respondents never see it.
5. Paste your [anonymous link](https://www.verasight.io/docs/run-your-study/connect-your-survey#before-you-begin) into **What's the URL of your survey?**. The survey must be active, or the link will not work in the Testing Survey step. If you paste an edit link, Self-Serve shows "Use your survey's anonymous link, not its edit link".

![The Survey URL card has a Survey Name (internal only) field and a "What's the URL of your survey?" field, with a note to use the Qualtrics anonymous link.](https://www.verasight.io/docs/images/connect-your-survey--survey-url.png)

Next, set up your survey to record `vsid` and `surveyid`:

1. Under **Survey Platform**, select **Qualtrics** or **Other**. If you select **Other**, follow [Use another survey platform](https://www.verasight.io/docs/run-your-study/connect-your-survey#use-another-survey-platform) instead.
2. In Qualtrics, open your survey's **Survey Flow**.
3. Click **Add a New Element Here** and choose **Embedded Data**. Qualtrics adds the element at the end of the flow.
4. Add two fields to it, named exactly `vsid` and `surveyid`. Leave their values blank. Qualtrics fills them from the survey link.
5. Drag the element above every block, so it comes first in the flow.

![A Qualtrics Set Embedded Data element in Survey Flow holds two fields, vsid and surveyid.](https://www.verasight.io/docs/images/connect-your-survey--embedded-data.png)

6. Click **Apply**. Qualtrics saves the survey flow.
7. Back in Self-Serve, click **Confirm** on "Add the vsid and surveyid parameter to your survey". The item shows a Completed badge.
8. In Qualtrics, click **Publish**. Qualtrics does not use survey flow changes until you publish. Its publish window notes that changes can take up to 5 minutes to reach new respondents.
9. Back in Self-Serve, click **Confirm** on "Republish your survey with these changes".
10. Click **Continue to Redirects**.

## Step 2: Redirects Setup

In Redirects Setup, you add one redirect for each place your survey can end.

### Completes

Every survey needs the Completes redirect.

1. In Self-Serve, copy the Completes redirect link with the copy button.
2. In Qualtrics, open **Survey Flow**. At the end of the flow, click **Add a New Element Here** and choose **End of Survey**. Then click **Customize** on that element.

![A Qualtrics End of Survey element with its Customize option.](https://www.verasight.io/docs/images/connect-your-survey--end-of-survey-customize.png)

3. Select **Override Survey Options**, then select **Redirect to a URL**.
4. Paste the Completes link into the field.

![The Qualtrics Customize End Of Survey window with Override Survey Options ticked and Redirect to a URL selected, holding a link that ends in vsid=${e://Field/vsid}.](https://www.verasight.io/docs/images/connect-your-survey--redirect-to-url.png)

5. Click **Save**, then **Apply**.
6. Back in Self-Serve, click **Confirm**. The Completes row shows a Redirect added badge, which records only your confirmation. [Step 3](https://www.verasight.io/docs/run-your-study/connect-your-survey#step-3-testing-survey) checks the redirect itself.

### Do Not Consent to Participate

Self-Serve first asks whether your survey has a consent form. It then asks whether respondents opt out by clicking a response option. If either answer is No, there is nothing to set up.

If both answers are Yes, set up a branch in Qualtrics:

1. In Self-Serve, copy the Do Not Consent redirect link with the copy button.
2. In Qualtrics **Survey Flow**, find the block where the consent question is answered.
3. Below that block, add a **Branch** element with this condition: the consent question, "No" is selected.
4. Inside the branch, add an **End of Survey** element.

![Qualtrics Survey Flow with a branch on the consent question ("No" is selected) leading to an End of Survey element.](https://www.verasight.io/docs/images/connect-your-survey--consent-branch.png)

5. On that element, click **Customize**.
6. Select **Override Survey Options**, then select **Redirect to a URL**.
7. Paste the Do Not Consent link into the field.
8. Click **Save**, then **Apply**.
9. In Qualtrics, click **Publish**.
10. Back in Self-Serve, click **Confirm**.

### Fail Attention Check

Self-Serve asks whether your survey has an attention check. If it does not, the row shows No redirect and you can move on.

If it does, set up a branch in Qualtrics:

1. In Self-Serve, copy the Fail Attention Check redirect link with the copy button.
2. In Qualtrics **Survey Flow**, find the block with your attention-check question.
3. Below that block, add a **Branch** element with a condition that catches the failing answer.
4. Inside the branch, add an **End of Survey** element.
5. On that element, click **Customize**.
6. Select **Override Survey Options**, then select **Redirect to a URL**.
7. Paste the Fail Attention Check link into the field.
8. Click **Save**, then **Apply**.
9. In Qualtrics, click **Publish**.
10. Back in Self-Serve, click **Confirm**.

### Republish and check every ending

If an End of Survey element has no custom redirect, respondents who reach it do not return to us. This is the most common setup mistake.

1. In Qualtrics **Survey Flow**, check that every End of Survey element has its own custom redirect.
2. In Qualtrics, click **Publish**.
3. In Self-Serve, click **Confirm Survey Republished**.
4. When every row you use shows a green badge, click **Continue to Testing**.

![The Redirect links step lists Completes, Do Not Consent to Participate and Fail Attention Check, each marked Redirect added, plus "Republish your survey with these changes" marked Completed.](https://www.verasight.io/docs/images/connect-your-survey--redirect-links.png)


## Step 3: Testing Survey

**Continue to Payment** stays disabled until every required test shows Completed. Once a row shows Completed, that redirect is verified. **Test again** appears only if a test times out.

We test redirects so that after launch our team only has to monitor your survey. A broken link means pausing your survey to troubleshoot.

1. From the dropdown, choose about how long your survey takes. The setting tells Self-Serve how long to wait for each test, and the dropdown goes up to 20 minutes. You can give yourself more time once a test is running.
2. On the Completes row, click **Start Test**. Your survey opens in a new tab with a test respondent ID attached.
3. Answer every question and finish the survey. The row shows the test in progress. When your survey redirects you back to us, the row shows a green Completed badge.

If a test ends on the Qualtrics message "We thank you for your time spent taking this survey", that ending has no redirect. The row stays in progress.

While a test runs, **Nothing happened? See common causes** under the row lists what to check.

By default, Qualtrics does not block repeat responses from the same browser. If you turned on Prevent multiple submissions in your Qualtrics survey options, do one of these:

- Turn it off while you test.
- Click **Copy URL** on the row, and paste the test link into a private (incognito) browser window.

Only tests started from **Start Test** or **Copy URL** count.

4. If your survey uses the Do Not Consent redirect, click **Start Test** on its row.
5. Decline the consent form.
6. If your survey uses the Fail Attention Check redirect, click **Start Test** on its row.
7. Answer the attention check incorrectly.
8. When every required test shows Completed, click **Continue to Payment**.

![The Testing Survey step shows Completes and Do Not Consent to Participate as Completed. Fail Attention Check has Copy URL and Test again buttons, and a note that Self-Serve has not heard back from that test.](https://www.verasight.io/docs/images/connect-your-survey--testing-survey.png)

Next, [pay and launch](https://www.verasight.io/docs/run-your-study/pricing-and-payment#pay-in-self-serve) in Step 4, Payment & Launch.

## Tests that do not register

If a test does not register, check these first:

- `vsid` and `surveyid` are in an Embedded Data element at the top of the survey flow, above all blocks.
- You published the survey after adding the embedded data, and again after adding the redirects.
- Every End of Survey element has its own custom redirect.
- No End of Survey element is inside a randomizer, where it may never run.
- Each redirect link was copied with the copy button, pasted in full, and left unedited.
- No redirect link is reused from another study.
- You started each test with **Start Test**, or pasted the **Copy URL** link into a private (incognito) browser window.
- The survey link in Self-Serve is this survey's anonymous link, and the survey is active.

If tests still do not register, email research@verasight.io.

## Use another survey platform

On another [survey platform](https://www.verasight.io/docs/run-your-study/build-your-survey#choose-a-survey-platform), you do the same two things as in Qualtrics. Capture `surveyid` and `vsid` from the survey link, and send respondents to the redirect links at the end of the survey.

1. In the Configuration step, under **Survey Platform**, select **Other**.
2. Set your platform to record `vsid` and `surveyid` from the survey link and store them with each response. Platforms call these link parameters, hidden fields, custom variables, or inbound variables. These help articles cover recording link values and redirecting respondents at the end:
   - REDCap: [survey parameters](https://help.redcap.ualberta.ca/help-and-faq/advanced-form-design/survey-parameters) and [survey termination options](https://kb.wisc.edu/smph/informatics/121171)
   - Typeform: [URL parameters](https://help.typeform.com/hc/en-us/articles/360052676612-Using-URL-parameters-formerly-Hidden-Fields) and [end screens and redirects](https://help.typeform.com/hc/en-us/articles/360051791392-End-Screens-and-redirects)
   - SurveyMonkey: [custom variables](https://help.surveymonkey.com/en/surveymonkey/send/custom-variables/) and [survey end page](https://help.surveymonkey.com/en/surveymonkey/create/survey-end-page/)
   - Forsta: [participant sources](https://forstasurveys.zendesk.com/hc/en-us/articles/4409470024347-Adding-Participant-Sources-Using-the-Survey-Editor)
3. To capture the values for every respondent, record them before the first question.
4. Copy each redirect link from Self-Serve with the copy button. With **Other** selected, each link ends in the placeholder `{{VSID VALUE}}`.
5. Replace only that placeholder with your platform's field for the recorded `vsid` value. Leave the rest of the link as we gave it.
6. At the end of the survey, redirect respondents to the Completes link. On the consent and attention-check paths, redirect to the matching link.
7. To put the redirects in the live version, publish or activate the survey.
8. Test each path as in [Step 3: Testing Survey](https://www.verasight.io/docs/run-your-study/connect-your-survey#step-3-testing-survey).

If your links end in `${e://Field/vsid}`, Qualtrics is still selected in the Configuration step. Replace that ending the same way, or select **Other** under **Survey Platform**.

If you change **Survey Platform** after Redirects Setup, Self-Serve clears your redirect confirmations. Copy each new link and confirm the redirects again.

## Qualtrics help pages

Qualtrics documents each element in these steps:

- [Embedded Data](https://www.qualtrics.com/support/survey-platform/survey-module/survey-flow/standard-elements/embedded-data/)
- [End of Survey Element](https://www.qualtrics.com/support/survey-platform/survey-module/survey-flow/standard-elements/end-of-survey-element/)
- [Branch Logic](https://www.qualtrics.com/support/survey-platform/survey-module/survey-flow/standard-elements/branch-logic/)
- [Anonymous Link](https://www.qualtrics.com/support/survey-platform/distributions-module/web-distribution/anonymous-link/)
- [Survey Publishing & Versions](https://www.qualtrics.com/support/survey-platform/survey-module/survey-publishing-versions/)
- [Security Survey Options](https://www.qualtrics.com/support/survey-platform/survey-module/survey-options/survey-protection/) (Prevent Multiple Submissions)