Qualtrics linking

From Solowiki
Jump to navigation Jump to search

Studies hosted on JATOS, Gorilla or Pavlovia can be integrated with Qualtrics in a way which allows information exchange in both directions: from the studies to Qualtrics, and vice versa. Both methods use [Query Strings https://en.wikipedia.org/wiki/Query_string] and typically involve redirecting participants to an online study after they have completed a Qualtrics survey; and/or redirecting participants to a Qualtrics survey after they have completed an online study.

Linking to Qualtrics

Under construction

Add variables to

  • Survey Flow
  • Add Embedded Data
  • Add a new field -> name of variable

OSWeb/JATOS Implementation

Under construction.

Step 1: OpenSesame

Assuming you already have a survey in Qualtrics, edit it and go to ‘Distributions’ and click ‘Get single reusable link’.

In OpenSesame, add a inline_javascript object:

todo: image Figure 1: The inline_javascript object. If you don’t have the OSWeb section in the OpenSesame toolbar, please upgrade your OpenSesame to the latest version.

Then, in the new object, copy the Qualtrics link and store it in a JavaScript variable:

1 var surveyUrl = 'https://leidenuniv.eu.qualtrics.com/jfe/form/SV_1SrURH8xI3jHbYV';

Now add the variables you want to send to the link:

1 vars.subjectNr = 1; vars.favoriteColor = 'blue'; surveyUrl += '?favoriteColor=' + vars.favoriteColor; // first argument starts with '?' 
2 surveyUrl += '&subjectNr=' + vars.subjectNr; // next arguments start with '&'

Note: It is also possible to send JATOS identifiers (e.g. studyId, workerId, batchId) to Qualtrics, see the example task for a demonstration.

Now instruct OpenSesame to open the link:

1 window.open(surveyUrl);

To save your experiment. Go to Tools -> OSWeb -> Export experiment as JATOS study

Step 2: JATOS

  1. Log in to JATOS.
  2. Go to Import Study.
  3. Import your experiment ZIP file (e.g. MyExperiment.osexp.zip).
  4. Go to your Study and then to ‘Worker & Batch Manager’ (green button).
  5. Assuming you want a unique link for each participant that is usable only once:
    1. ‘Get Worker Links’ -> Select ‘Personal Single’ -> ‘Next’ -> Specify the amount of links needed -> Next
    2. Save these links somewhere to give to your participants and for testing.

Note: You can also make multiple batches and you can use other types of workers (e.g. anonymous users, multiple runs per user, and so on.)

Step 3: Qualtrics

The final step in this process in receiving the data in Qualtrics. Data obtained from URLs is called ‘Embedded Data’ in Qualtrics. First you have to specify which information is in the URL:

  1. Edit your Survey
  2. Go to Survey Flow
  3. Add the names of the variables you send in the Url (e.g. subjectNr and favoriteColor in the example above). These names are case sensitive.
  4. Click options to specify the variable type (e.g. Number for subjectNr and Text for favoriteColor). Also see the image below.

todo: image Figure 2: Configuring embedded data in Qualtrics.

Now how can you use this information in your survey?

Information from embedded data can be used in survey questions. To make it easy to use this data in this way, Qualtrics has the ‘Piped Text’ feature. More information about Piped Text is explained in the documentation.

todo: image Figure 3: Example of using the piped text corresponding to the information we obtained from the OpenSesame demo task.

Step 4: Testing

Open one of the JATOS Worker Links and check the experiment, the redirection to Qualtrics, and the information exchange.

Linking from Qualtrics

Under construction.

OSWeb/JATOS Implementation

Under construction.