Insight Study Creation Wiki
We recommend creating the study in order of the following steps:
Configure the Study Tab
Name your study by typing a name into the Study Name field. This name will appear at the top of the app home screen.
In the Status Field, select Development while the app is in development, or select Active when the app has been fully developed and you are ready to begin enrolling study participants.
If desired, in the Staff Phone field, type a phone number that participants can click in order to connect them with your research staff. If you use this feature, a Call Staff button will populate on the top right hand corner of the app home screen.
If desired, in the Counselor Phone field, type a phone number that participants use to connect them with a counselor/nurse/doctor/etc. If you use this feature, a Call Counselor button will populate on the Insight application home screen.
In Assessment Timeout Minutes, type the number of minutes that you would like participants to have to complete each assessment. The assessment will automatically end when time runs out. Insight will record the duration of each initiated assessment and this information will be saved in the dataset.
Select study features:
Create Groups
Allows researchers to provide different content/questions to participants based upon group membership (e.g., Assessment only vs. Assessment + Intervention).
Click the Groups tab.
Click the Add button.
Name the Group by typing inside the Name textbox field; a brief description of the group can be added in the Description textbox.
Select features for the new group.
Click the Save button.
Always click the save button after you make changes to your study. You will lose all work that you do not save.
Create Questions
Do not use spaces for variable names. If needed, use an underscore. For example, “Question 1” will not be acceptable for a field name. Instead use Question1 or Question_1.
Additionally, variable names are case-sensitive. [FOR_EXAMPLE], [For_Example], and [for_example] would be considered 3 different variables.
Question types and how to create them:
In the Questions tab, click the New Question Template button.
Type a variable name into the Field Name textbox. This will be a labeled column in your dataset.
Choose a Question Type (e.g., radio, slider, check all that apply, time, calendar, date, etc.).
Check the Required button if you would like this question to be answered before participants can move to the next question. If unchecked, participants will be allowed to skip the item.
Type your Question Text. This text will appear on the smartphone screen during the assessment.
Enter instructions on how to complete the question in the Description textbox (e.g., “Slide your finger from left to right to answer this question”). (Optional)
To adjust Font Color and Font Weight of the question, click the add button under Settings (if you do not change the font color or weight, Insight default settings will be used).
Under Responses, click Add for each desired answer response. For example, click Add 5 times for a 5-item Likert-Type scale (e.g., Strongly Agree, Agree, Neutral, Disagree, Strongly Disagree).
Type each answer into the Text field as it should appear on the smartphone screen (e.g., Strongly Agree).
Type a Value that corresponds to each answer response (e.g., “1” for Strongly Agree). These Values will appear in your dataset.
Hover the mouse over the Move ↕ button, click, hold, and move items up and down to reorder responses. The order of the responses here will set the response order in the app.
Click the Configure wheel next to each Response if you would like to change the Font Color and/or Font Weight for each answer response.
Click the Remove button to remove an answer response.
Click the Save button on the top right hand side of the screen, and always click the save button after you make changes to your study. You will lose all work that you do not save.
Insight allows you to clone Questions. This feature can save considerable amounts of time if your study contains similarly worded questions, or questions with similar/identical answer responses.
From the Questions dashboard, click the Clone button for a particular question.
Change the Field Name for this new item.
Change the Question Text.
Modify answer Responses and Settings as needed.
Save the new item.
To create a badge that appears within the Insight app that is a consecutive day counter, follow the steps below:
Select Response Summary under the Question Type dropdown box. Fill out the required fields (Field Name and Question Text). Use Question Text to describe the Response Summary of the Badge.
Automatically under Settings, look for the Response Summary setting type.
Under the Question Name dropdown box, select the question you want associated with this Response Summary.
Under Minimum Goal and Maximum Goal, enter the value(s) associated with the question responses that would trigger the Response Summary Badge streak.
For example, a question picked that asks the participant “if they slept before midnight”. The responses for this question are “Yes” for a value of 1 and “No” for a value of 0. In order to associate “Yes” to the Response Summary, 1 will be entered for both Minimum and Maximum Goal
Set additional Settings for the Response Summary. The “Goal Streak“ badge and Streak Count can be enabled or disabled to be shown during the Assessment. The “Goal Met Pie Chart“ with number of Met / Not-Met Responses can be enabled or disabled to be shown during the Assessment.
Setting the values for the associated Question to a Response Summary:
Settings for the Response Summary to be displayed. “Minimum Goal“ and “Maximum Goal“ values are included in the Goals Met for the Response Summary badge. “Show Goal Streak“ and “Show Goal Met Pie Chart“ can be toggled to be displayed or not during Response Summary Question. If the “Show Goal Met Pie Chart“ is enabled, each section of the Pie Chart will display the text entered as the Label Suffix which is input by the CMS user.
The “Streak” counter is a setting to show the Streak – how many times in a row that the requirements for the Response Summary have been met. Once the requirement value is out of the settings range, the Streak sets to 0.
The pie chart shows the total number of times that the Response Summary goal has been met or not met. The colors for the Pie Chart are not customizable at this time.
The Streak Goal and the Pie Chart can be independently shown or hidden from CMS settings.
Calculated fields are a question type that uses formula logic to create new values that can be used for data analysis and branching logic within assessments. To help with designing these formulas, a formula editor is included that allows for experimentation with different values to see how a formula will behave to enter the formula editor, click on the ‘Edit formula button’.
This will bring up the formula editor, which has a number of options. To begin, enter a formula in the top text box. Once one is entered, parse/extract the formula using one of the methods detailed below to test how the formula outcomes.
There are two ways to test formulas, ‘Quick’ and ‘Validated'. ‘Quick’ will allow for any formula fields to be subbed in without regard to what exists in the study and is useful for testing proof-of-concept formulas. ‘Validated’ will attempt to locate questions that are referenced within the formula and allows for testing the specific values associated with other questions as well as making sure that the questions are referenced correctly. An example of the ‘Quick’ evaluation is shown below:
In the CMS, the options for the LineChart appear as shown below.
The first option is to select a Question in the Study. The requirement for the LineChart is that the Responses from the Question have numeric values. If they do not, the Line Chart will show an empty graph.
Valid Question Types for showing Line Charts data: Radio with numerical Values, Dropdown with numerical Values, Slider, Continuous Slider, BT iCO Breath Sample
Question Types that are not for Line Charts: Checkbox, Text Field, Text Area
The default Line Chart for a Question uses all Responses for the Question over the course of the entire Study.
Other options are as follows:
Show Axis Labels - This is an Enable / Disable slider. Data Labels will be visible along the Y-axis at fixed increments.
Y-Axis Increment Label - A typed-in element of units (such as “Drinks“ or “ppm“) will be added to the Y-axis increments if “Show Axis Labels“ is enabled. Does not show if “show Axis Labels“ is Disabled.
Show Threshold - sets a second line on the graph at a fixed Y-value. Displays the graph data value overlaid the Threshold value. If the Threshold is significantly higher than the highest point of Data, the graph is stretched vertically to show both the data and the Threshold.
Threshold Value - If “Show Threshold“ is Enabled, this is a number input for the Threshold Value to be rendered against the data values from the selected Question.
Show Cumulative Sum - The Linear Chart is able to show a linear sum of Question Data over multiple days, as opposed to showing a linear plot of data. Each Response value is summed with the previous data point value, starting with just the first point and ending with the Response value from the last Response.
Number of Days - Line Charts can designate a number of days to use instead of all Responses over the course of the Study. Inputting a positive number of Days, the displayed Cumulative Sum Line Chart will show the Response Data for the last number of allocated Days. Leaving the Number of Days blank will show all of the Responses over the course of the Study.
Single Line Chart | Line Chart w/ Threshold line | Cumulative Sum Line Chart | Cumulative Sum Line Chart with Threshold Line |
|---|---|---|---|
| | | |
Examples and instructions for creating each question type are available here:
Checkbox - Response choices are shown in a list; multiple answers can be chosen.
Continuous Slider - Participants slide their finger from left to right to choose a continuous response (e.g., 1-10 visual analog scale).
Date - Participant uses a calendar to choose a date.
Dropdown - Participants click a box to select from a long list of potential answer responses.
Line Chart - This item type is used as a graphical representation of data collected.
Payment Log - This item type is used to display the number or percentage of surveys completed, requires HTML file. More information can be found here.
Radio - Response choices are shown in a list; only one answer can be chosen.
Rich Text - A block of text that can be used to provide messages or instructions in the app; rich text allows additional formatting that is not available with the Text Only item type. For example, this item type allows you to embed URL links, underlining, highlighting, and bolding into messages.
Do not copy-paste Question Text from a source that generates its own formatting. Rich-Text Question Text that is copy-pasted from a source with formatting provided (i.e. MS Word or MS Outlook) will include all of the hidden formatting.
Be sure to keep “Open in new window” UNCHECKED if embedding links in the Rich Text question.
Slider - Participant slides their finger from left to right to choose a categorical response.
Text Area - Participant uses their keyboard to type a longer response than the text field question type.
Text Field - Participant uses their keyboard to type a short answer.
Text Only - A block of text that can be used to provide messages or instructions in the app.
Time - Participant uses a clock to choose a time.
Timer - Participants see a configurable countdown timer.
Button List - This item type creates a menu of options/buttons. Each button can be linked with specific content (e.g., messages, message bins, videos, websites) set to other questions types (e.g. Core Web View, Video, Text Only) by using branching logic.
Calculated Field - Enables researchers to create formulas by adding / subtracting / multiplying / etc. participant answers to EMA questions (e.g., question 1 + question 2).
Core Web View - Enables the integration of webpages into Insight. When Insight is used to open a webpage, the platform quantifies the amount of time spent on each webpage.
This feature requires an active data plan or WiFi connection to access the internet.
Email - An encrypted email is generated when an established criterion is met (e.g., if question 1 > 3, then automatically email a study staff member that a participant has requested a medication refill).
This feature involves PHI and requires an active data plan or WiFi connection to access the internet.
Face Verification - Used to take a picture of participant, in conjunction with facial recognition.
This feature involves PHI.
Baseline Facial Recognition Photo - allows participants to take and submit a new or replacement Baseline Photo. Facial Recognition must be enabled on the Study and Group level; adding a Baseline Facial Recognition Photo to a Group that does not have the “Facial Recognition” setting enabled can cause the Insight app to crash if the participant attempts to upload the picture. This question type is able to be added to new or existing assessments. When a participant presses “Submit” during the Assessment, the new Baseline Photo is uploaded. The photo will be available to view in the Insight CMS once image processing and syncing are completed.
A Baseline Facial Recognition Photo is used as a basis to compare photos taken during BT iCO measurements that include a Face Verification question.
This means that a Baseline Facial Recognition Photo question should be used for the following situations ONLY:
at the start of the study,
in the event the Insight is deleted from the participant’s phone, or
in the event the participant has a new phone
It is strongly recommended that the Baseline Facial Recognition Photo question is in its own assessment for these situations for the exact purpose of ONLY sending a baseline photo.
Image Picker - Uploads any selected image from a device’s Gallery or Photos
This feature requires an active data plan or WiFi connection to upload.
Picture Preview - Allows participants to take a photo from the Insight app to get a preview of what the camera captures. Participants are allowed to take as many pictures as they like, and the image is not saved on the Insight app nor on the CMS. The image does not show on the app until the participant taps on the “Preview Photo” button to take a picture.
Do NOT select the “Required” checkbox for Picture Preview! Selecting “Required” will not allow the participant to move on to the next question in the assessment
Greenphire Payment – AUTOMATICALLY initiates a payment to a Greenphire Mastercard when a participant completes a specific survey.
This feature involves PHI and is currently only available for OUHSC researchers.
iCO - Pairs with the Bedfont iCO device to collect carbon monoxide samples. Requires purchase of specific third party devices.
Message Bin - Enables delivery of unique content when specific criteria are met. One message is delivered from the bin to the participant on each occasion.
Message Bin Repeating - Enables delivery of unique content when specific criteria are met. One message is delivered from the bin to the participant on each occasion. This type of bin resets to the first message after the last message in the bin is delivered.
Pedometer Summary - Shows summary of steps. Can set graphs to show progress, in conjunction with Android Wear.Coming soon.
Random Number Generator - Generates a random number based upon parameters set by the researcher.
Response Summary – Creates a summary button in the app to indicate if the participant has reached a study defined goal and/or the number of days they have met certain criteria; gamification elements.
Sensor Log - Schedules the frequency for Insight communication with Outsight to record data from Android Wear devices. Will present data from a sensor at specified intervals. For example, if steps are to be collected every 2 minutes the log will display number of steps every 2 minutes.
Video - Shows a video file saved within the Insight App.
Video Link Bin - Enables delivery of a video (using a URL) when specific criteria are met. One video is delivered from the bin to the participant on each occasion.
This feature requires an active data plan or Wifi connection to access the internet.
YouTube Video - Links YouTube URLs to play video content in the app.
This feature requires an active data plan or Wifi connection to access the internet.
Create Assessments
This section explains how to create assessments.
Click the Assessments tab.
Click Add to create a new Assessment.
Type a name for your assessment in the Assessment Name textbox.
We recommend that you use face value names to distinguish this assessment from other assessments (e.g., Morning Daily Diary - Intervention Group; Quit Date Morning Daily Diary - Control Group).
Assessment Timeout Minutes allows studies to customize how long a specific assessment can be; when using Add/Edit/Clone Assessment operations, the Assessment Timeout Minutes is defaulted from the Study Level timeout duration.
a. Change the assessment timeout to a preferred duration. (Optional)
i. The field is mandatory and must be greater than zero (0).
ii. An Event with multiple Assessments will be based on the timeout duration at the Study level, not the Assessment level.
Add questions to the assessment:
a. On the left side of the screen, you will find all questions that you have created for this study. On the right side of the screen are the questions that will be included in this particular assessment.
You can reuse questions for multiple assessments (e.g., there is no need to create an item – “I am hungry” more than once because the same item can be used in multiple assessments). However, if you would like to ask the same question twice in a single assessment, you should create two items to differentiate them in your dataset (e.g., “paintime1” and “paintime2”)
i. Use the Filter box as a quicker way to find your questions. Simply type in the variable name.
b. Click to add a question to the top of the assessment.
c. Click to add a question to the bottom of the assessment.
d. You can also drag and drop questions from the left side of the screen and place them in the desired order on the right side of the screen (this drag-and-drop feature can be used after at least 1 item has been added to the assessment using the chevron-up button).
Question Feature Buttons on the right hand side of the screen will enable you to customize your Assessment.
a. Move questions higher or lower in the assessment by hovering the mouse over the Move ↕ button. Then click, hold, and move the question higher or lower in the assessment.
b. Click the Open button to create branching logic and to review information about each question. Branching logic enables certain questions to be skipped or presented based upon responses to other questions. Click here to learn more about branching logic formulas and how to use them.
c. Click the Clone button to add a copy of this item to this assessment.
d. Click the Remove button to remove a question from the assessment.
Click the Save button.
Always click the save button after you make changes to your study. You will lose all work that you do not save.
Type in the formula for branching logic instead of copying and pasting formulas.
Copying and Pasting formulas have the potential to carry over hidden characters or HTML tags that are not seen in web browsers.
If it is a Rich Text question type the question text will be limited to displaying 50 characters.
Click Close to return to the Assessments tab where you will see your new assessment.
Create Stages
Insight conceptualizes Stages as periods of time. The Stage feature allows you to present different questions and intervention content and use different Insight features at different time points in your study. You can include as many stages as you like.
Stages are directly linear by default in each Study. Each Participant starts in the top-listed first Stage in the Study, and progresses through each Stage in a linear manner based on the conditions to complete each Stage.
The Stages listed in order in the CMS is the order of the Stages that will progress in the Study.
The additional Setting “Branching Logic → Branch-to-Stage“ is designed to allow Study Stages to progress in a non-linear (sometimes “circular stage“) manner.
Click the Events tab.
Click Add to create a new Stage.
Type a name for your stage in the Name textbox.
We recommend that you use face value names to distinguish stages (e.g., Stage 1; Study Days 1-14; Pre-Quit).
The Type dropdown box allows you to set how this stage will end.
a. Duration – Allows you to set how long (by number of days) a stage will last. The app will automatically move to the next stage (in order) when each stage ends. Type number of days for the stage in the Days Duration textbox.
i. Check the Ends at midnight checkbox if you would like a stage to advance to the next stage at midnight on the last day of the stage. If this box is not checked, the stage will advance at the same time of day as when the participant downloaded the app and started the study (this will result in some participants starting a new stage at 5:00 PM, and others at 8:00 AM). In most cases, the Ends at midnight checkbox should be checked for Duration Stages.
b. Formula – Allows you to end a stage when specific formula criteria are met (e.g., Participant indicates that they have not smoked in the past 7 days; Participant indicates exercising 3 or more days in the past week).