...
Terracotta was designed as a tool for experimental education research. To integrate a Qualtrics survey in Terracotta, you will first need to create an experiment in Terracotta. When creating an experiment, you will be able to create different experimental conditions and to set up an informed consent process. However, if you are not interested in these options, it’s possible to set up an experiment with only one treatment condition, where all students are assumed to be participants.
⚠️ Terracotta does not share students’ names with your Qualtrics survey. Instead, Terracotta assumes that your Qualtrics survey is anonymous, and sends an anonymous identifier to Qualtrics that can be used to connect Qualtrics responses to additional details about the student in Terracotta. If students will be asked to provide their name or any other personally identifiable in your Qualtrics survey, make sure you have permission from your school.
...
Note: Instructions on how to obtain the URL to your Qualtrics survey, and how to embed data fields are in the A Minimal Examplesection ,below.
...
Responsibilities of the Qualtrics
...
Survey
When a Qualtrics survey is integrated in Terracotta as a LMS assignment, your activity is responsible for supporting student learning, honoring the assignment settings set by the teacher, and reliably returning students’ outcome scores back the LMS.
Launch
...
Parameters
The following variables are automatically provided to the Qualtrics survey as URL parameters:
launch_token: A single-use token for launch validation and score return return. The launch token is in UUIDv4 format.
anonymous_id: Anonymized student identifier. This ID matches Terracotta’s participant_id, however, depending on the configuration in Terracotta, students who access an custom web activity may not be consenting participants. Thus, we use the label anonymous_id to refer to students accessing Qualtrics surveyscustom web activities.
assignment_id: Unique identifier for the Canvas assignment
submission_id: Unique identifier for the current submission attempt
condition_name: Experimental condition name due_at: Assignment due date and time
experiment_id: Unique identifier for the experiment (specific to the course)
due_at: Assignment due date and time
remaining_attempts: Number of remaining submission attempts submission_id: Unique identifier for the current submission attempt attempts. If there are unlimited attempts available to the student, remaining_attempts = u.
Return to Terracotta
Terracotta expects that when a student completes the activitysurvey, they will be redirected to the URL:
https://app.terracotta.education/integrations?launch_token=${e://Field/launch_token}&score=${e://Field/score}
If “score” is omitted, Terracotta will assume that the submission will receive the maximum score.
Terracotta will not accept a score for a launch token that has already been used, nor will Terracotta accept a score for an activity that has 0 remaining attempts.
Best practices
Check if the Launch Token has Previously Been Used: When configuring a Qualtrics survey in Terracotta, there is a checkbox: Survey allows students to view past submissions. If this box is checked, Terracotta will assume that the survey is able to display a past submission to a student. In this situation, if the Qualtrics survey receives a launch token that has previously been used, this indicates that a student is attempting to review their responses from a past submission. Check if the launch token has previously been used, and that the anonymous_id and assignment_id of the current launch matches the anonymous_id and assignment_id of the past submission associated with the launch_token. If so, the Qualtrics survey external page should display the data from the past submission associated with the provided launch token, but with no interactivity.
NOTE: There is one reserved launch_token:
"0000000-
0000-
4000-
a000-
000000000000". This launch token is issued by Terracotta when previewing external integrations.
Communicate When There are No Available Limited Remaining Attempts: When remaining_attempts is 0, the external webpage should still display the activity, but Terracotta will accept no submissions. In this situation, to avoid misleading students about whether they can make another submission, the external webpage should disable submission functionalitythe teacher has placed restrictions on the number of attempts that a student may submit in response to an assignment, it may be helpful for the Qualtrics survey to communicate this to the student (e.g., if there is only 1 attempt remaining). If there are unlimited attempts available to the student, remaining_attempts = u. A Qualtrics survey will never need to handle a situation where remaining_attempts = 0, because in this situation, Terracotta will not generate a launch_token and will not launch the student into the survey.
Respect Due Dates: Consider warning users when they are accessing the webpage after the due date. Submissions made after the due date will be flagged in Canvasdelivered into Canvas, but will be flagged as late.
Score Calculation: The custom web activity Qualtrics survey is responsible for determining the student’s score on the activity, which should be returned to Terracotta as a URL parameter value an embedded data field with the name “score.”
A Minimal Example
...