Qualtrics Integration

External survey / Qualtrics support

Several foraging experiments have included survey instruments during the sequence of rounds to measure participant sentiment after a specific treatment or set of treatments. You can embed a survey within a foraging round's instructions by adding the external-survey-enabled and survey-url parameters to a round configuration file.

Survey instructions will only be displayed when the Facilitator sends a Survey->Show survey instructions request. You should add the survey enabled boolean and URL parameters to the round where you wish to see the survey. So if you want a survey between round 4 and 5, place the survey configuration in the round 5 configuration and issue a Survey->Show survey instructions request from the facilitator after round 4 has ended and before you show the instructions for round 5.

example round configuration keys

<entry key='external-survey-enabled'>true</entry>
<entry key='survey-url'>
    <![CDATA[https://yourqualtricsurl.com/jfe/form/TA_iwMT8sajz?pid={participantId}]]>
</entry>

Replace the URL with your own custom qualtrics survey URL, but be sure to preserve the ?pid={participantId} query parameters in the URL. pid represents an anonymized participant ID and must be defined as embedded data in your Qualtrics survey to link a participant's foraging game data with their survey responses.

We chose the variable name pid but you can call it anything you want so long as the query parameter matches the embedded data field name. You must keep the ={participantId} part of the query string though, since that information will be interpolated by the foraging software to the given participant's anonymized participant ID.

what to do on Qualtrics

Create a pid (or whatever you named the query parameter in your round configuration) embedded data field in your Qualtrics survey. The foraging software will create a URL that captures the participant's anonymized participant ID and sends it to your Qualtrics survey when they click on the link from the experiment software screen.