« September 2009 | Main

February 08, 2010

Pass data to a Qualtrics survey and use it in the survey and reports

Qualtricsis a versatile and sophisticated online survey application now available here at U-M. My department is currently using Qualtrics to create a feedback form that will be accessed through several hundred learning modules. This survey form needs to recognize from which learning module it's being accessed and it should be able to determine the author of the module and email them a copy of the user's feedback. Qualtrics has a feature called "embedded data" which allows you to pass any arbitrary arguments in the link to the survey. We'll use this to add metadata to the feedback.

There are three steps:

  1. Set up a link to the survey that passes "Embedded Data" values
  2. Set up the survey to access the Embedded Data
  3. Do something with the Embedded Data


1. Set up a special link to the Qualtrics survey that passes Embedded Data values:


  1. We need to pass the values of three properties of the learning module:
    1. The current page URL
    2. the TITLE of the learning module
    3. and the author's EMAIL address.
    If in your application these values never change, the embedded data values can be hard-coded at the end of the survey link, but in this example, every learning module has different values for these items, so we'll use javascript to generate the link. You could just as easily use a server-side language, but that is not an option for this particular application.
    The title, and author properties were already exposed in variables in the code for the modules, and the URL property is always available as "document.location":

    2010-02-05_14.57.55.jpeg 

  2. Here's an example of a javascript function that will append the required values (derived from properties that already exist on the learning module page) to the end of a Qualtrics survey link.


     2010-02-05_14.59.25.jpeg
  3. The printFeedbackLInk() function is called when the navbar for the module is built with Javascript:

    2010-02-05_14.59.51.jpeg

  4. This shows the path generated by the javascript - URL, title and email are all appended to the survey link.The added parameters are URL, TITLE and EMAIL.


    2010-02-05_15.07.29.jpeg


  5. 2. Set up the survey to access the Embedded Data

  6. Open and edit the survey in Qualtrics.
    2010-02-05_14.54.34.jpeg

  7. Click Survey Flow.
    2010-02-05_15.01.24.jpeg

  8. Click "Add Below" to add another step. Click Embedded Data. 
    2010-02-05_15.03.10.jpeg

  9. Add the parameter names used in your survey link. 

    2010-02-05_15.03.42.jpeg

  10. In this case I've added URL, TITLE, and EMAIL.

    2010-02-05_15.02.28.jpeg

  11. 3. Do things with the Embedded Data

    We'll do three things with the embedded data: we'll trigger an email to be send to the module author, display the title of the learning module in the survey to the user, and we'll report on the title and page number the user was on when they clicked the survey link.

    Set up the email trigger to email the feedback to the author of the learning module. Click the Advanced Options dropdown.

    2010-02-05_15.51.24.jpeg

  12. Select Email Triggers...


    2010-02-05_15.51.47.jpeg

  13. Set up a rule to send an email to the author. I've added a check that the value of EMAIL looks like an email address. 

    To do this select: "If Embedded Data [EMAIL] is Matches Regex and paste in this regular expression:

     [a-z0-9!#$%&'*+/=?^_`{|}~-]+(?:\.[a-z0-9!#$%&'*+/=?^_`{|}~-]+)*@(?:[a-z0-9](?:[a-z0-9-]*[a-z0-9])?\.)+[a-z0-9](?:[a-z0-9-]*[a-z0-9])?

    Note: additional, more sophisticated regex formulas for validating email addresses are available <a href="http://www.regular-expressions.info/email.html ">HERE</a>.

    Click Finish Editing and then Save Triggers.

    2010-02-05_16.04.33.jpeg

  14. Make the title of the learning module show up in the survey itself.
    Create a Descriptive Block type question, with Rich Text format.

    Picture 24.jpg


  15. In the toolbar of the editing window, click the {a} icon. Select Embeded Data Field and type the name of the field you want to display within the block of text. In this case it is TITLE.

    2010-02-05_15.05.27.jpeg

  16. Clicking Insert will drop some code into your question.

    2010-02-05_15.04.40.jpeg

  17. Close the editing window to save the change.

    2010-02-05_15.06.11.jpeg

    This is what the user will see 

    2010-02-05_15.09.12.jpeg

     

    Reporting:

    Reporting on the embedded data is simple. The values for the current module and page are displayed in the emailed feedback as well as in online reports. Here's a view of the question selectors in the Reporting window in Qualtrics. You can see the Embedded Data items have been added in the reporting area, so they can be used in conditional filters, in sorting, etc.

    Picture 26.jpg

Posted by emeiselm at 12:09 PM | Comments (0)