Supercharge Your Qualitative Research Toolbox with Video Surveys Using Pipe Video Recorder and Qualtrics XM

Alessio -

Updated May 2022

In a data-driven world, it's necessary to remember the importance of qualitative research. While analyzing large sets of data can help us explain the "What" behind a particular phenomenon, very rarely will that data also explain "Why" that phenomenon happens in the first place, which is where qualitative research shines.

Surveys are still one of the best ways to gather all the information from your target audience, and you can use many tools to implement them in the format that best fits your needs.

One of the problems with these tools is that it's not always easy to gather video answers, which are becoming more and more the go-to format for qualitative research.

This article will show you how to add multiple questions which require a video (or audio) answer to your Qualtrics XM survey and save the video answers along with the rest of your survey's response data.

Table of Contents

  1. Requirements
  2. Build your 1st Qualtrics survey that includes a video answer
  3. Use Qualtrics’ Embedded Data to collect the URLs of the video answers
  4. Using Pipe’s payload option to send the ResponseID to Pipe
  5. BONUS: Capture Audio Only Recordings in your Qualtrics Survey

Requirements

To follow this guide you will need an account with:

Although Qualtrics provides a free account and a free 30 days trial of DesignXM, to follow this guide and add a Pipe video recorder to your survey, you will need a paid Qualtrics account which includes the ability to add custom code/JavaScript. Adding JavaScript to your Qualtrics survey is a paid Qualtrics feature and it is required to add the Pipe recording client to a survey.

So if you have a paid Qualtrics account, keep reading. Otherwise, visit our integrations page for the complete list of alternative tools. We have written guides for several other surveys & forms tools.

Build your 1st Qualtrics survey that includes a video answer

Create a new survey

To start, from your Projects page, click on the Create New Project button at the right and select Survey. After choosing the name of your survey, click on Get Started, and you will be sent to the survey's editor. I will use a blank form for this tutorial but feel free to use a template if that is better for you.

Prepare the survey to accept video inputs through the Pipe recording client

Now that we have our survey, we'll need to add the Pipe JavaScript library and CSS stylesheet to it.

In your survey's editor, click on the Look and Feel button, go to General, and edit the Header. In the popup that will appear, click on the Source button/icon and add the following line:

<script type="text/javascript" src="//cdn.addpipe.com/2.0/pipe.js"></script>

Back in the Look and Feel modal go to the Style section and add the following link in the External CSS field: https://cdn.addpipe.com/2.0/pipe.css.  

Note: the General and Style sections under Look & Feel are not accessible with a free Qualtrics account. You'll need a DesignXM trial or a paid account.

Add the 1st question that requires a qualitative video answer

Now we can go back to the survey builder and start adding our 1st question for which we need an answer using video (or audio).

So, back in the survey builder, click on Add new question and add a Text / Graphic block. After typing your question switch to HTML View and add the following HTML code:

<div id="question0"></div>

This is the HTML div element that we’ll replace later on, through JavaScript, with the actual rectangular audio or video recording client.

Here’s my HTML View:

Next, let’s add the JavaScript. Click on the question and then on the JavaScript button at the bottom left under Question behavior.

In the modal that shows up, in the addOnReady function paste the following code:

var pipeParams = {
  size: {
    width: 640,
    height: 390
  },
  qualityurl: "avq/360p.xml",
  accountHash: "ACCOUNT_HASH",
  eid: "ENVIRONMENT_ID",
  mrt: 120
};
PipeSDK.insert("DIV_QUESTION_ID", pipeParams, function(recorderObject) {});

Now in the code above you need to replace 3 parts:

  1. ACCOUNT_HASH with the account hash found in your account page
  2. ENVIRONMENT_ID with the alphanumeric environment id found at in your environments page
  3. DIV_QUESTION_ID with the <div> id used before (question0)

Once you’re done with the replacements click on Save.

Here’s how my code looked:

You should now see the recording client in your survey preview. All recordings (audio or video) made with it will show up in the Pipe account dashboard’s Recordings section.

Add two more questions which require video answers to the survey

To add more questions to which you require a video or audio answer you will have to repeat what we did in the previous section. For our survey, we'll add 2 more Text / Graphic questions. In each question add the actual question text, switch to HTML View and add the HTML DIV element to be replaced with the recording client. I have added the following: 

<p>Tell us a bit more about you</p>
<div id="question1"></div>
<p>Tell us a bit more about a project that made you grow</p>
<div id="question2"></div>

With the questions’ up you’ll have to add the JS code we used before and place it inside each questions’ JS field.

Don’t forget to replace the  ACCOUNT_HASH,  ENVIRONMENT_ID  and DIV_QUESTION_ID with the proper values in the JS code. Our DIV question ids this time are question1 and question2.

Use Qualtrics’ Embedded Data to collect the URLs of the video answers

In the Survey flow section, you can add objects known as Embedded Data, then assign them values using JS code. We will use these objects to store the URLs of the video answers and save them along with all the other survey's responses.

So click on Survey Flow and add a new Embedded Data element by clicking on the Add a New Element Here or Add Below. Give it a name to identify it in your survey responses.

I’ve named mine “question0_video_url”.

Do not set a value for it as we’ll set one dynamically. You can go ahead and add one Embedded Data element for each recorder in the survey. Should you need additional info about Embedded Data elements you can find the official Qualtrics documentation at this link. With your new element added, click Apply in the bottom right.

Adding Embedded Data elements to our Qualtrics survey

Now let’s add the JS code that populates our new Embedded Data element with a value. Back in the Survey Builder, click on the JS/code icon for your 1st question, you should see your previously added JS code.

Qualtrics.SurveyEngine.addOnReady(function() {
  /* Place your JavaScript here to run when the page is fully displayed */
  var pipeParams = {
    size: {
      width: 640,
      height: 390
    },
    qualityurl: "avq/360p.xml",
    accountHash: "ACCOUNT_HASH",
    eid: "ENVIRONMENT_ID",
    mrt: 120
  };
  PipeSDK.insert("question0", pipeParams, function(recorderObject) {});
});

In the JS code: replace the line

PipeSDK.insert("question0",pipeParams,function(recorderObject){});

with

PipeSDK.insert("question0",pipeParams,function(recorderObject){
    recorderObject.onSaveOk = function(recorderId, streamName, streamDuration, cameraName, micName, audioCodec, videoCodec, fileType, videoId, audioOnly, location){
        //onSaveOK is part of the desktop recorder's JS events API (recording from camera or screen)
        var args = Array.prototype.slice.call(arguments);
        console.log("onSaveOk("+args.join(', ')+")");
        Qualtrics.SurveyEngine.setEmbeddedData("question0_video_url", "https://"+location+"/ACCOUNT_HASH/"+streamName+".mp4");
    };
    recorderObject.onVideoUploadSuccess = function(recorderId, filename,filetype,videoId,audioOnly,location){
        //onVideoUploadSuccess is part of the native mobile recorder's JS events API (upload new or existing recording)
        var args = Array.prototype.slice.call(arguments);
        console.log("onVideoUploadSuccess("+args.join(', ')+")");
        Qualtrics.SurveyEngine.setEmbeddedData("question0_video_url", "https://"+location+"/ACCOUNT_HASH/"+filename+".mp4");
    };
    recorderObject.onDesktopVideoUploadSuccess = function(recorderId, filename, filetype, videoId, audioOnly, location){
        //onDesktopVideoUploadSuccess is part of the desktop recorder's JS events API (upload existing file from desktop) 
        var args = Array.prototype.slice.call(arguments);
        console.log("onDesktopVideoUploadSuccess("+args.join(', ')+")");
        Qualtrics.SurveyEngine.setEmbeddedData("question0_video_url", "https://"+location+"/ACCOUNT_HASH/"+filename+".mp4");
    };
});

The above code makes use of Pipe’s JS Events API. It is quite hefty because it covers all 3 possible scenarios:

  1. record through the desktop recorer (onSaveOk)
  2. upload through the desktop recorder (onDesktopVideoUploadSuccess)
  3. upload through the mobile recorder (onVideoUploadSuccess)

In each scenario/function, we populate the Embedded Data element with the final URL to the newly recorded/uploaded recording.

In the above code, you need to replace:

  1. The ACCOUNT_HASH with the correct value for your account, you'll find it in the account section of your account dashboard.
  2. If you’ve used a different name for your Embedded Data element, replace  question0_video_url in the code above with the name you chose.

The Embedded Data values will show up in your Qualtrics survey results and in the exported results data. Here's the Qualtrics Results section showing the 3 clickable URLs to the 3 video answers made by the 3 responders to this demo survey.

The above recording URLs point to the final processed .mp4 recordings as stored by us. If you're using your own storage, the URL will be different and you need to adapt the URL.

Also, it takes time to process recordings and push them to our and your storage, so keep in mind that the final, processed .mp4 recording will not be available on our or your storage immediately after recording/uploading. Bigger recordings are slower to process.

Making the video answer mandatory

Now that the recorder is shown in the survey and the recording URL will be present in the survey results, you may want to make the video answer mandatory.

You can do that by hiding the NEXT button to prevent the user from moving to the next survey section until he completes one video answer.

Let's start by hiding the NEXT button. Adding these 2 lines of code below immediately after the Qualtrics.SurveyEngine.addOnReady(function() { line will do the job.

var qobj = this;
qobj.hideNextButton(); //hides the NEXT button by default

With the NEXT button hidden we now have to activate it when a recording is made. In the JS code of the question that you want to trigger the activation of the NEXT button add the following line:

qobj.showNextButton();

before the closing curly bracket of the following functions:

  • recorderObject.onSaveOk
  • recorderObject.onVideoUploadSuccess
  • recorderObject.onDesktopVideoUploadSuccess

With the changes above, the NEXT button is activated under all 3 scenarios (desktop recording, desktop upload, mobile upload).

Using Pipe’s payload option to send the ResponseID to Pipe

Now that we have the final recording URLs in the Qualtrics backend, there's still one thing we can do. Pipe offers an account dashboard where you can view all recordings. Pipe also offers webhook and REST APIs that make further integrations possible. We can attach some data - like the Qualtrics ResponseID - to each recording so that in the Pipe dashboard or through the Pipe APIs, we can distinguish between recordings coming from different survey questions.

To attach the ResponseID to each recording we’ll have to edit a bit the JS code we used before. Namely, you’ll have to edit the pipeParams object:

var pipeParams = {
  size: {
    width: 640,
    height: 390
  },
  qualityurl: "avq/360p.xml",
  accountHash: "ACCOUNT_HASH",
  eid: "ENVIRONMENT_ID",
  mrt: 120
};

And add the payload property and give it the value of ${e://Field/ResponseID}. Here’s my code after adding it:

var pipeParams = {
  size: {
    width: 640,
    height: 390
  },
  qualityurl: "avq/360p.xml",
  accountHash: "ACCOUNT_HASH",
  eid: "ENVIRONMENT_ID",
  mrt: 120,
  payload: "${e://Field/ResponseID}"
};

Here’s the ResponseID shown in the Pipe account area’s list of recordings:

BONUS: Capture Audio Only Recordings in your Qualtrics Survey

We have covered how to use the Pipe Recording Client to capture video in a Qualtrics survey, but did you know that you can also capture audio-only recordings with Pipe? Audio recordings are an excellent addition to your survey toolbox, especially if you are concerned about the privacy of your interviewees or if video is not an option/not needed and you want to get only audio recordings.

To add an audio recorder to your Qualtrics survey, you have to follow the same process as described in the "Build your 1st Qualtrics survey that includes a video answer" but with an extra line for the pipeParams object. When editing the JS code, add a comma and an ao key with a value of 1 to the pipeParams object (as shown in the image below), and you will turn the video recorder into an audio only recorder.

adding audio only recorder on a Qualtrics survey


We are done!

Please let us know what you think about the Pipe x Qualtrics integration and if you have any questions don’t hesitate to drop us an email at contact@addpipe.com or contact us through the messenger option available in the Pipe account dashboard. We’ll be happy to help you!