How to Set Up Redirect Links and External Parameters
Introduction
It is usual practice in survey distribution and panel administration to use third-party providers for email invites and reward processing. Typically, these external services include a link that takes recipients to their own server. When panelists click this link, they are sent to the EyeQuestion server, where further information such as language, panelist ID, and project ID are transmitted. To enable continuous communication and status updates, EyeQuestion must redirect back to the external server, reporting success along with the panelist and project IDs. This article will explain you how to set up redirect links and external parameters in EyeQuestion utilizing the URL Redirect and URL Call functionalities, allowing for seamless connection with external systems.
External Parameters
The first step is to run a test with external parameters. After you've deployed a test, use the anonymous R1 link in the Distribution page.
This is the base link from which you will work. Make sure have access to EyeQuestion using the same server name as a panelist.
That means the link should look something like this:
Your external party can use this link and add their own specific parameters, like this :
To summarize, the link is built up on 2 components separated by a question mark. The first component is your anonymous test link and the second component are the parameters of your external party:
<anonymous link to EQ questionnaire> ? <parameter1>=<value1> & <parameter2>=<value2>
Calling this URL will start the test on EyeQuestion and store the parameters together with the panelist's session. These "external parameters" can be used in conditions and can be passed on during a redirect back to an external system.
Redirect Back to the External System
On every screen of your questionnaire you can set a redirect to an external system or a background call in de screen settings. Go to the advanced settings and choose URL Call or URL Redirect in the Action field. Then the field for the URL will appear. A redirect results in a browser in redirecting to the given Url. The URL Call will call the given Url on server level (in the background) and the test will continue. In case of a redirect to an external system, use action URL Redirect.
Suppose you want to redirect to your external party and pass on information like panelist ID, project ID and status. The external party requires a URL with a format that is something like :
To build up the correct URL you will need to call the given "external parameters" again. You can do this by using the following placeholder: $externalparameter:<name>$ . Using the example given, the actual URL that you should enter in the Url field would be :
The following will happen during the test: as soon as the panelist hits this page, the page will not be shown, but the browser will redirect to the URL.
Make sure that you also set Close Session to YES. This will save the panelists data before continuing on the server of the external party. Otherwise the panelists session will remain an "open" session.
Storing the External Parameter
If you want to store the given panelistid together with the data for future reference, you will need to add an extra question to one of the screens in your questionnaire (preferably the first one). First open the first screen of your questionnaire and add a TEXT question. Give it a name and set the FORMAT to Hidden in the Advanced settings.
Secondly, set the DEFAULT value to $$externalparameter:<parameter>$$ in the Standard settings, in this example that would be $$externalparameter:panelistid$$.
During the test this question will not be shown, but the given external parameter is will be stored as the default value.
Related Articles
External Preference Mapping
Purpose External preference mapping (EPM) is a way of combining sensory, or analytical data on a set of products with consumer liking measured on the same products. The aim is to form a product map based solely on the sensory/analytical data, and ...How to Set up and Monitor Quotas in EyeQuestion
In this article, we will discuss what quotas are, how to set up a simple quota in EyeQuestion, and how to monitor the status of the quota. What is a quota? A quota is a pre-defined target or limit for the number of respondents who can answer a ...How to Set Up a VR Project
Introduction In the following article we will outline the basics to start designing a virtual reality (VR) project. The immersive projects and questions are available depending on your license type, please reach out to our support team or your sales ...How Can I Set Up a Wait Screen
Introduction A waiting screen can be utilized when you want panellists to pause between products or take a break before continuing with the test. Set Up a Waiting Screen If you want to add a wait screen to have panellists wait, this can be done by ...How Can I Set Up, Run, and Analyze a Best Worst / Max Diff Test
Introduction Best Worst scaling is an approach for obtaining preference/importance scores for multiple items, such as brand preferences, brand images, product features, advertising claims, etc. Best Worst scaling is also known as Max Diff. Setting up ...