APPENDIX

Qualtrics
Use embedded data defined in survey flow

If you have defined/set embedded data in your Qualtrics survey flow and the embedded data variable name is myVariableX, you can access this embedded data variable in JavaScript with the following code: "${e://Field/myVariableX}"

If you want to modify/update an embedded data value with JavaScript, we recommend naming your embedded data in a specific format that is recommended by Qualtrics. See section below on how to modify/update embedded data values.

Collect and save text entry input

Copy the JavaScript code below and add it to your text-input question. If the question name is Q123, modify line 5 below to the following: let questionName = "Q123";

Modify embedded data values with JavaScript

If you want to modify embedded data values in Qualtrics using JavaScript, your embedded data variable names must begin with __js_ when you define/set them in the survey flow. See Qualtrics JavaScript API documentation.

For example, if you have an embedded data variable named textResponse, the embedded data must be named __js_textResponse in your survey flow.

Save conversation data with the response ID

By default, Vegapunk does not save your conversation data. To save it, pass the Qualtrics response ID to the ResponseID option in the study object. ResponseID is a field Qualtrics provides for every response, so you do not need to define it in your survey flow — just reference it with "${e://Field/ResponseID}".

Each conversation is then saved to the database and linked to that response ID, so you can join it to the rest of your Qualtrics data. Saved conversations are automatically deleted 180 days after they are saved, so download your data before then. Leave ResponseID out (or set it to an empty string) to keep saving disabled.

Before you save conversations, make sure your Institutional Review Board (or equivalent ethics board) protocol and consent form cover collecting and storing them.