Survey Link and Survey-Based Value Variable

What is a survey link variable? 

A survey link variable is a link that can be used for a certain survey in a logic set. A survey link variable can be created for all surveys in Way to Health and will give you the ability to send the SURVEY_LINK in a message reminder to participants. Currently, you can only send the survey link in the initial message that goes out when the survey event opens, now you can send a reminder to participants who have not completed the survey with the link to the survey imbedded in the message. 

"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 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.  

Additionally, this variable type can be used during enrollment! You don't have to wait for a participant to start to inform them of their selected goal. 

How do I set up a Survey-Based Value variable?

  1. Navigate to Manage Study --> Variables 

  2. Click '+ New Variable'. 



  3. Give the variable a friendly name.  
    1. :light_bulb_on: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. :light_bulb_on: 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 participant data variable. 


  6. Once you select participant data value, additional fields will display. 

  7. In the 'Data Sources' drop-down, all available device for that arm will display. Select the Goal Selection Survey.  
    1. :question_mark: 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. 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 


:yellow_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.