Difference between revisions of "Qualtrics linking"

From Solowiki
Jump to navigation Jump to search
Line 2: Line 2:
  
 
== Linking to Qualtrics ==
 
== Linking to Qualtrics ==
Under construction
 
  
Add variables to
+
=== OSWeb/JATOS Implementation ===
* Survey Flow
 
* Add Embedded Data
 
* Add a new field -> name of variable
 
  
 
+
Assuming you already have a survey in Qualtrics, edit it and go to ‘Distributions’ and click ‘Get single reusable link’.
=== OSWeb/JATOS Implementation ===
 
Under construction.
 
  
 
==== Step 1: OpenSesame ====
 
==== 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 (Figure 1) to end of your experiment. If you don’t have the OSWeb section in the OpenSesame toolbar, please upgrade your OpenSesame to the latest version.
+
In OpenSesame, add an inline_javascript object (Figure 1) to the end of your experiment. If you don’t have the OSWeb section in the OpenSesame toolbar, please upgrade your OpenSesame to the latest version.
  
 
[[File:Osweb extension2.png|thumb|right|Figure 1: The inline_javascript object.]]
 
[[File:Osweb extension2.png|thumb|right|Figure 1: The inline_javascript object.]]
 
 
  
 
In the inline_javascript object, paste the Qualtrics link and store it in a JavaScript variable:
 
In the inline_javascript object, paste the Qualtrics link and store it in a JavaScript variable:
Line 69: Line 60:
 
# Click options to specify the variable type (e.g. Number for subjectNr and Text for favoriteColor). Also see the image below.
 
# Click options to specify the variable type (e.g. Number for subjectNr and Text for favoriteColor). Also see the image below.
  
todo: image
+
[[File:Embedded data.png|thumb|center|Figure 2: Configuring embedded data in Qualtrics.]]
Figure 2: Configuring embedded data in Qualtrics.
+
 
  
 
''Now how can you use this information in your survey?''
 
''Now how can you use this information in your survey?''
Line 76: Line 67:
 
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 [https://www.qualtrics.com/support/survey-platform/survey-module/editing-questions/piped-text/piped-text-overview/ documentation].
 
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 [https://www.qualtrics.com/support/survey-platform/survey-module/editing-questions/piped-text/piped-text-overview/ documentation].
  
todo: image
+
[[File:Piped_text.png|thumb|center|Figure 3: Example of using the piped text corresponding to the information we obtained from the OpenSesame demo task.]]
Figure 3: Example of using the piped text corresponding to the information we obtained from the OpenSesame demo task.
 
  
 
==== Step 4: Testing ====
 
==== Step 4: Testing ====

Revision as of 15:17, 22 June 2020

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

OSWeb/JATOS Implementation

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

Step 1: OpenSesame

In OpenSesame, add an inline_javascript object (Figure 1) to the end of your experiment. If you don’t have the OSWeb section in the OpenSesame toolbar, please upgrade your OpenSesame to the latest version.

Figure 1: The inline_javascript object.

In the inline_javascript object, paste the Qualtrics link and store it in a JavaScript variable:

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

If you also want to send some variables from OpenSesame to Qualtrics you can add these to the link:

1 // example: sending variables to Qualtrics in Url
2 vars.favoriteColor = 'blue'; 
3 surveyUrl += '?favoriteColor=' + vars.favoriteColor; // first argument starts with '?' 
4 vars.subjectNr = 1; 
5 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.
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.

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.