External Survey Integration
Learn how to connect an external survey with RealEye eye-tracking studies, pass custom variables, and ensure proper participant redirection.
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 cannot be used with this setup - please use Own participants.
Note 2: RealEye offers also a built-in Survey Module.
1. Enable External Tool Integration
Within your Study, go to Study Setup and check the Enable external tool integration option.
2. Configure Redirect URLs
- In the Finish URL field, enter your survey’s URL (e.g.,
https://mysurvey.com
).
⚠️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 participantrealeye-tester-quality_grade
: participant's test quality score (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:
- External 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
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.
👉 See our Qualtrics Integration Example for a complete walk-through on connecting
external surveys with RealEye studies. 👈
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:
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 and Privacy Policy. |
💌 If you have any further questions, feel free to reach out to our team at support@realeye.io