---
title: External Tool Integration
description: Learn how to connect an external survey with RealEye eye-tracking studies, pass custom variables, and ensure proper participant redirection.
---

[Skip to content](http://support.realeye.io/connecting-study-with-external-survey#main-content)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png)](https://support.realeye.io/?hsLang=en)

Open main navigation

Close main navigation

- [Contact us](mailto:contact@realeye.io)

[Contact us](mailto:contact@realeye.io)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [RealEye Knowledge Base](http://support.realeye.io/?hsLang=en)
2. [Advanced Features & Integrations](http://support.realeye.io/advanced-features-integrations?hsLang=en)

# External Tool Integration

## Learn how to redirect your participants from RealEye to an external survey/website.

---

When running an eye-tracking study in RealEye, you can **redirect participants to an external survey (e.g., Qualtrics, Google Forms, SurveyMonkey, ...) after they complete the test**. This guide explains how to set up redirect links, pass participant IDs, and sync results.

**Note:** [RealEye panelists](https://support.realeye.io/realeye-panelists?hsLang=en) cannot be used with this setup - please use [Own participants](https://support.realeye.io/own-testers?hsLang=en).

**Note 2:** RealEye offers also a built-in [Survey Module](https://support.realeye.io/survey-module?hsLang=en).

 

![line\_RealEye\_long-1](https://support.realeye.io/hs-fs/hubfs/line_RealEye_long-1.png?width=670&height=1&name=line_RealEye_long-1.png)

 

### 1. Enable External Tool Integration

Within your Study, go to *Study Setup* and check the **Enable external tool integration** option.

![](https://support.realeye.io/hs-fs/hubfs/image-png-May-29-2025-03-37-07-3319-PM.png?width=670&height=277&name=image-png-May-29-2025-03-37-07-3319-PM.png)

### 2. Configure Redirect URLs

- In the **Finish URL** field, enter your survey’s URL (e.g., `https://mysurvey.com`).
  
  ![](https://support.realeye.io/hs-fs/hubfs/image-png-May-29-2025-03-40-53-4857-PM.png?width=670&height=415&name=image-png-May-29-2025-03-40-53-4857-PM.png)  
  ⚠️**Do not add any variables here!** RealEye will automatically append them for each participant after they finish the eye-tracking experiment.
- *(Optional)*  Configure additional redirect URLs: 
    - **Skip Test URL**: If participants click "*I don't want to participate*," they will be redirected here.
    - **Quota Full URL**: Redirects users when the study reaches its participant limit.
    - **Screen Out URL**: Redirects participants if they use an unsupported device.

### 3. Understand Parameters

#### **3.1. Automatically generated parameters**

If the "*Attach information about the participant to the Finish URL*" option is enabled, RealEye **automatically** adds the following parameters to your Finish URL:

- `realeye-tester-id`: unique anonymous identifier generated by RealEye for each participant
- `realeye-tester-quality_grade`: participant's test [quality score](https://support.realeye.io/participant-quality-stats-explained?hsLang=en) (1-6)

So **after** participant finishes the RealEye eye-tracking study, the automatically generated redirection link will look as follows:

`https://mysurvey.com?realeye-tester-id=id&realeye-tester-quality_grade=grade`

 

#### **3.2. Built-in parameters**

RealEye offers several **built-in parameters** that integrate directly with our system:

- `realeye-tester-external_id`: when redirecting participants, for example, from your external survey to RealEye, this parameter can be used to pass the participant's (External) ID. 
- `realeye-tester-age` & `realeye-tester-gender`: if you don't want to (or can't) use the RealEye built-in post-test demographic survey, you can provide age and gender directly through these parameters. They will automatically upload as the participant's demographic data.

To use these parameters, append them to your **Participation Link** (not the survey link!), using `?` for the first parameter and `&` for additional ones.

So **before** a user takes part in your study, the Participation Link that you send to your testers should look as follows:

`https://app.realeye.io/test/study_id/run?realeye-tester-external_id=external_id&realeye-tester-age=age&realeye-tester-gender=gender`

And **after** participant finishes the RealEye eye-tracking study, the automatically generated redirection link will look as follows:

`https://mysurvey.com?realeye-tester-id=id&realeye-tester-quality_grade=grade&realeye-tester-external_id=external_id&realeye-tester-age=age&realeye-tester-gender=gender`

In RealEye, the values collected through these parameters will appear as:

- **E****xternal ID** in the Participants list in Results
- **Age** and **Gender** in participant demographic data, available for filtering
- **External Data** next to other (built-in or custom) parameters

![](https://support.realeye.io/hs-fs/hubfs/image-png-Feb-10-2026-10-05-36-8940-AM.png?width=657&height=349&name=image-png-Feb-10-2026-10-05-36-8940-AM.png)  
 

#### **3.3. Custom parameters**

You can also add your own **custom parameters** to track additional participant information. These work alongside the automatic and built-in parameters and will also be included in your survey redirect.

Let's say you want to share your study with participants from different groups based on their `location` and `team_name`. Therefore, you can append these parameters to your **Participation Link** (not the survey link!), using `?` for the first parameter and `&` for additional one(s).

So **before** a user takes part in your study, the Participation Link you send to your testers should look as follows:

`https://app.realeye.io/test/study_id/run?location=location&team_name=team_name`

And **after** participant finishes the RealEye eye-tracking study, the automatically generated redirection link will look as follows:

`https://mysurvey.com?realeye-tester-id=id&realeye-tester-quality_grade=grade&location=location&team_name=team_name`

In RealEye, the values collected through these parameters will appear as **External Data** next to other (built-in or custom) parameters.

 

![line\_RealEye\_long-1](https://support.realeye.io/hs-fs/hubfs/line_RealEye_long-1.png?width=670&height=1&name=line_RealEye_long-1.png)

 

#### 👉 **See our [Qualtrics Integration Example](https://support.realeye.io/connecting-realeye-study-with-qualtrics-survey?hsLang=en) for a complete walk-through on connecting** **external surveys with RealEye studies. 👈**

 

![line\_RealEye\_long-1](https://support.realeye.io/hs-fs/hubfs/line_RealEye_long-1.png?width=670&height=1&name=line_RealEye_long-1.png)

 

### Preparing Instructions for Your Participants?

Here’s a template you can use right away - feel free to copy, paste, and customize!

| ### **We invite you to take part in an eye-tracking session using your webcam. Don't worry - NOTHING is being recorded!** #### **Please:** - Use a \<device\> \[e.g. Laptop / PC / Mac(book) / Smartphone / Tablet\] (if you're using a laptop, make sure it's plugged in) - Make sure you have a working webcam! - Make sure you're in good lighting conditions - Don't rush through the calibration process - Try to keep your head still during the whole test If something doesn't work for you, please return the study and send a message. **Your privacy is important to us. We do not store any images or sounds. The camera is solely used to calculate your eye position.** By proceeding, you consent to the use of your webcam for eye-tracking purposes and agree for RealEye's [Terms & Conditions](https://www.realeye.io/about/terms) and [Privacy Policy](https://www.realeye.io/about/privacy). |
| --- |

 

---

 

💌 If you have any further questions, feel free to reach out to our team at **support@realeye.io**

- [Getting started](http://support.realeye.io/getting-started?hsLang=en)
- [(Webcam) Eye-Tracking Basics](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#main-content)

    - [RealEye accuracy](http://support.realeye.io/webcam-eye-tracking-basics?hsLang=en#realeye-accuracy)
- [Licenses & Pricing](http://support.realeye.io/licenses-pricing?hsLang=en)
- [Account Settings](http://support.realeye.io/account-settings?hsLang=en)
- [Study Setup & Settings](http://support.realeye.io/study-setup-settings?hsLang=en#main-content)

    - [Study Types](http://support.realeye.io/study-setup-settings?hsLang=en#study-types)
- [Content Setup & Stimuli (Items) Settings](http://support.realeye.io/content-setup-stimuli-items-settings?hsLang=en)
- [Managing Participants](http://support.realeye.io/managing-participants?hsLang=en)
- [Analyzing Study Results](http://support.realeye.io/analyzing-study-results?hsLang=en)
- [Advanced Features & Integrations](http://support.realeye.io/advanced-features-integrations?hsLang=en)
- [Security & Privacy](http://support.realeye.io/security-privacy?hsLang=en)
- [Troubleshooting](http://support.realeye.io/troubleshooting?hsLang=en)
- [Ghost articles](http://support.realeye.io/ghost-articles?hsLang=en)

[![logotype](https://support.realeye.io/hs-fs/hubfs/logotype.png?width=140&height=57&name=logotype.png "logotype")](http://realeye.io)

RealEye sp. z o. o.  
Obornicka 330  
60-689 Poznań  
Tax: PL9721299175

<https://www.facebook.com/> [mailto:support@realeye.io](mailto:support@realeye.io)

Copyright © 2024, RealEye sp. z o. o.