External Survey Integration

---

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 participant
• realeye-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!

 

---