JAVASCRIPT Instructions
- Your Research Manager will supply the lines of JavaScript to be inserted at the point in the survey that the chat is to take place.
- Within the lines of JavaScript is the URL that will launch the QuantText application.
- These JavaScript lines should be on a page devoted to the chat.
- The data collection software must supply a CONTINUE or NEXT button on the bottom of this page.
- Within the link, the value of pre-identified variables from the quantitative survey will need to be added to populate the "User Snapshot". A list of variables to be used in the "User Snapshot" will be supplied by QuantText.
- EACH JAVASCRIPT STRING IS PROJECT SPECIFIC: DO NOT ATTEMPT TO USE THE EXAMPLE HTML BELOW OR OLD JAVASCRIPT FROM A PREVIOUS PROJECT.
EXAMPLE RAW SCRIPT
<script language="JavaScript" src="//www.quanttext.io/chatter?Respondent=&jISN=1000&Q1=&Q2=&Q3=&Q4=&GENDER=&AGE=&EDUCATION="></script>
The GREEN highlighted text represents the variables to be used in the "User Snapshot".
You will need to pipe the VALUE of each variable---this must be inserted after the equals sign =. Please do not put a space in between.
Respondent # will always be the first variable.
Open Ended Responses will be captured as free text.
Below is an example of what the above script that QuantText would send would look like when completed:
COMPLETED EXAMPLE
<script language="JavaScript" src="//www.quanttext.io/chatter?Respondent=${record}&jISN=1000&Q1=${Q1.val}&Q2=${Q2.val}&Q3=${Q3.val}&Q4=${Q4.val}&GENDER=${Qgender.val}&AGE=${Qage.val}&EDUCATION=${Qeducation.val}"></script
The above highlighted in green are the piping syntax for each question (obviously every system has a different piping syntax - the above is based on Decipher's system. And below is the source code of what that script would deliver with successful piping of the variables, highlighted in green:
SOURCE CODE EXAMPLE
<script language="JavaScript" src="//www.quanttext.io/chatter?Respondent=test01&jISN=1000&Q1=1&Q2=3&Q3=1,4,5&Q4=Not sure why I don't like this particular package. The colors do not look right to me&GENDER=1&AGE=3&EDUCATION=3"></script
Again:
EACH JAVASCRIPT STRING IS PROJECT SPECIFIC: DO NOT ATTEMPT TO USE THE EXAMPLE OR OLD STRINGS FROM A PREVIOUS PROJECT.
Overview of the Basic Process
Schlesinger Group's proprietary QuantText software allows researchers to incorporate real-time, one-on-one interview sessions into a quantitative online survey. QuantText works with any of today's leading online data collection tools.
How it Works
- The quantitative survey is programmed using an online data collection software tool.
- At the point in the survey that the one-on-one chat should take place, the data collection software tool should provide a blank page with a "NEXT" or "CONTINUE" button at the bottom of the screen.
- HTML instructions, provided by QuantText, will need to be inserted on that page. These instructions run an application in the middle of your survey page, which allows the respondent to chat with our interviewers. No downloads are required on the respondent side.
Below is an example of the respondent's screen as the interview session begins. The HTML code produces the the screen below . The data collection software tool provides the page, "CONTINUE" button and "PROGRESS" bar if applicable.
The above instructions allow variables to be passed from previously answered questions in the quantitative survey to the moderator. We call this the USER SNAPSHOT and this will be explained in greater detail.
If an Interviewer is not available or a quota has been filled
In the case that an Interviewer is not available or quota is filled, a segue message will appear on the screen asking the respondent to please hit the "NEXT" key to continue.
Below is an example of the respondent's screen if an Interviewer is not available or a quota has been filled. This text is customizable and can be edited to make applicable to any point in the survey, though we do recommend that QuantText be located at the end of the quantitative survey to not disrupt any quant data collection. (The client survey software system would provide the page with the "CONTINUE" button and the "PROGRESS" bar if applicable.)
Quotas
The QuantText software will keep counts and quotas on the number of completed chats by any of the variables that are passed into the USER SNAPSHOT. Chats count towards a quota after the interview is completed.
User Snapshot
The User Snapshot is a list of variables from the quantitative survey that will be passed through the JavaScript string into the QuantText platform. Your Research Manager will need to know the exact label and definition of each variable that will be included in the snapshot. An example of a snapshot with those definitions is:
Variable (must match exactly as programmed in survey), label (editable on QuantText’s side), values (must match exactly as programmed in survey)
Q1 Gender
1=Male
2=Female
Testing
Your Research Manager will work with you to test through the integration. They can either receive a test link of the programmed survey and test through the integration. Or, they can log into the QuantText system and intercept testers as an Interviewer would when the project is live.
The Research Manager is looking to make sure that the connection works, all variables pass through as they should, and only those who do qualify for the QuantText chat are routed to the QuantText page.