Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

"Hey, Aaron, you didn't complete your pain management survey yesterday, please click SURVEY_LINK to complete the survey and share your pain data with us." 

...

How can I make a survey-based

...

value variable?

...

Use a participant data variable or a text based variable!  

A participant data variable or a text based variable can be used to create a survey based variable. These are custom variable types that allows you to evaluate a participant's survey response.  With the Survey-Based Value participant data variable, you can set targets based on the Goal Selection Survey choice, create ramp up periods, modify the target in event logic or send a notification to the participant about their selected goal.

You can also use a text based variable to extract a participants survey responses and use them in their individual messaging. 

...

What's so great about this? Well, as shown in the example below, you can remind the participant about their selected step goal.  

...

  1. Navigate to Manage Study --> Variables 

  2. Click '+ New Variable'. 



  3. Give the variable a friendly name.  
    1. (lightbulb)Tip! Choose something that you will remember when you are building the variable into target modifications or participant messaging and incidents. 



  4. Select the arm.  Typically the default for this variable type is 'All Arms' 
    1. (lightbulb) Tip! If you want to use this variable prior to randomization, you must select 'All Arm's 



  5. Next select the variable type.  For this example, we want to select Survey-Based Valueparticipant data variable
    Image RemovedImage Added

  6. Once you select Survey-Based Valueparticipant data value, additional fields will display. 
    Image Removed

  7. In the 'Data Sources' drop-down, all available device for that arm will display. Select the Goal Selection Survey.  
    1. (question) Don't see the Goal Selection Survey listed? First you will need to add it from the Data Sources page. 


  8. Finally, select the 'goal_value' for the 'Data Field' drop-down. 



  9. Click 'Save Variable'

  10. Your new variable will be listed on the Variables overview page. 

  11. You are now ready to use your newly created Survey-Based Value variable! The messaging options are endless! 


If you want to create a text based variable from a survey response to be used in messaging for a participant: 

  1. Create a survey asking participants questions with responses that you would like to create text based variables 
  2. Create a variable for the specific survey response
    1. example: provider name- Dr. Brown 
      1. Image Added
        1. Name your variable
        2. Describe the variable
        3. Choose which arm you will use the variable for 
        4. Choose the type of variable: text based
        5. Initial value is optional
          1. example: most participants in the intervention have Dr. brown as their PCP, so that will be the default value if they do not complete the survey question asking the name of their PCP
  3. Create logic that assigns a participants survey response to the corresponding variable 
    1. Image Added


(star) Want to create a ramp up period to ease participants into their selected goal? See the Participant Goal Variable page for detailed instructions on how to set up a ramp up period.