Link To TurkPrime

How to run successful experiments and get the most out of Amazon's Mechanical Turk

Friday, May 8, 2015

Qualtrics (and other platforms) Mechanical Turk Integration With TurkPrime

Run Qualtrics Surveys on MTurk using TurkPrime

Running Qualtrics surveys on TurkPrime streamlines two major pain-points that Requesters have dealt with:

  1. Dynamic secret key that Workers must enter to verify completion of the survey where the code is unique per user and, therefore, un-shareable.
  2. Auto approval and rejection of worker assignments based on the dynamic secret key
  3. Passing the Mechanical Turk WorkerId and AssignmentId into Qualtrics so that Workers can be uniquely identified and matched up with MTurk.
The following describes these basic features and how to use them.


The TurkPrime Design Survey Form is intuitive and similar to the MTurk Requester HIT Design form except that it adds many useful features like exclude Workers, target specific workers and much more. Below is a portion of the TurkPrime Design Survey form where you specify the Survey Hyperlink.


Qualtrics Surveys With Workers Specific Secret Keys on MTurk using TurkPrime

Now, you can also run Qualtrics surveys with TurkPrime Worker Specific Secret Keys. That means that each worker will be assigned a unique secret key to demonstrate that they completed the linked Qualtrics survey. There is no possibility that workers are sharing a secret key and not completing the linked survey.

Other Platform Integration


The Dynamic Secret Completion Code can be easily integrated (and has been by many researchers) into other non-Qualtrics systems, as well. TurkPrime calculates the Secret Code based on query string parameters that TurkPrime adds to the url of your survey. These parameters are named:
  • a
  • b
  • c

As long as your survey platform ensures that those query string values are preserved in the url when a participant reaches the last page of your survey that contains the TurkPrime iframe, then a completion code should get displayed. 

This can be achieved by capturing the parameters within your study. Nearly all platforms support this functionality. Please contact us if you have questions..

Furthermore, you have the option to manually approve each assignment or have TurkPrime auto-approve the assignment based on the secret key. (If for any reason, a worker is rejected in error by either you or the system, you can reverse the rejection within TurkPrime)

Setup in TurkPrime is very simple and involves a few simple instructions to add a page at the end of your Qualtrics study as follows:



Setup for Qualtrics
  1. Create or Edit a Survey
  2. Click on "Survey Options" 
  3. In the Survey Termination Section: Click on Custom end of survey message...
  4. If you have a Secret Key option that you previously created Select it and you are done/
    Otherwise, Click New Message
  5. Enter Secret Key in the Description field. (Next time you can select this message.)
  6. Click the Source button
  7. Paste the following text exactly into the window as shown 

    <iframe src='https://www.turkprime.com/TurkPrime/TakeLaunchedSurvey/DynamicKey' width='100%' height='200'></iframe>
  8. Click Save
Passing Mechanical Turk WorkerId and AssignmentId to Qualtrics

TurkPrime automatically adds the following query string parameters to your URL so you can take advantage of them in your data collection. The parameters are: workerIdassignmentId, andhitId.
  • workerId-The worker's MTurk id
  • assignmentId-A unique id that Amazon generates for a worker taking your HIT
  • hitId-The id of your HIT
This eliminates the need to add JavaScript code snippets into your surveys or other solutions.that Requesters have developed. It just is added to your URL automatically.

See here for how to integrate these parameters into your Qualtrics survey
For TurkPrime integration with Google Forms see here.