'Add Logic' Event
What is an 'Add Logic' event?
An event that looks at previous event's completion and/or compliance, survey response, point balance/level, and then runs logic based on the defined logic. This logic can include messaging to a participant/partner/project staff, crediting a participant, adding/subtracting to or from a point balance, moving a game level, etc. What's so cool about 'Add Logic'?! Well you can look at multiple previous events completion/compliance and define criteria!
Just want to send a message to a participant based on a previous event? You can use the 'Send a Conditional Message' event! Otherwise, this functionally can also be done using 'Add Logic' event types. Use whichever event is more intuitive to you when configuring participant feedback messaging!
What are some 'Add Logic' use cases?
- Run gamification to change points/levels
- Credit a participant for completing a survey and syncing their device
How do I set up an 'Add Logic' event?
- Typically, you should build the event that the 'Add Logic' event is going to look at prior to building the 'Add Logic'.
- Example 1: if you want to credit the participant for completing their survey and syncing their device, first build the 'Daily Step Count' and 'End of survey' events.
- Example 2: if you want to change a point balance based on step count goal met/not met, first build the 'Daily Step Count' event.
- In Manage Study tab, select 'Study Arms' from the drop-down list. Then select 'Manage Event Schedule' for the arm where you want to add the 'Add Logic' event.
- Click the blue 'Add New Event' button and select 'Add Logic' type.
- Name the event.
- Indicate when the event should begin and any repeats.
- You can choose for the event to begin:
- Immediately at participant start
- Same day as participant starts
- After participant start (day 7)
- After participant start by day of the week (2nd Monday)
- You can choose for the event to begin:
- Click the blue 'Define Logic' button to set up the logic criteria.
'Add Logic' Use Case Examples:
Example 1: Run gamification to change level based on points.
- If you have not already, you will need to build the 'Achievements', i.e. points and levels, on the arm and set up the point credits on the Step Count event. Unsure how to do this? See Gamification and Achievements for help!
- For this example, the participant will earn 1 point if they walked over 7,000 steps that day.
- For this example, the participant will earn 1 point if they walked over 7,000 steps that day.
- Once you define the 'Add Logic' event scheduling, you are ready to define logic to change a participant's medal level! See above for help.
- We want to change the participant's medal level to move up or down. If they have 5 or more points at the end of the week, then move up a level. If they have less than 5 points at the end of the week, then move down a level. We can set this up in the logic screen so click 'Define Logic'.
- Name the first logic set (e.g. 5 or more points)
- Set up the condition by selecting 'Achievements'
- For points > or = 5, move the participant up a level
- Select 'Adherence Points Balance' and define the operator.
- Set up the 'Then' criteria. This will move the participant up a level for meeting their goal for at least 5 of 7 days.
- Next you want to 'reset the point balance' so that the participant starts again fresh for the next week.
- Finally, set up the 'Otherwise' criteria for when the participant has less than 5 points to move them down a level and reset the point balance.
- Select 'Adherence Points Balance' and define the operator.
- Tip! You can also include messaging to the participant to tell them what their current level is and if they moved up or down.
- Click 'Save Feedback'.
Example 2: Credit a participant for syncing at least 25/30 days and completing the end of study survey
- First you will need to build the Daily Step Count and End of Study Events. Once that is done, you can build the 'Add Logic' event to credit the participant for doing both!
- Once you define the 'Add Logic' event scheduling, you are ready to define logic to credit the participant! See above for step by step help.
- In the logic page, set up the logic to credit the participant for completing both actions. To do this select 'All'.
- Then set up the Daily Step Count by selecting 'Previous Event's completion'. The participant needs to have synced at least 25 of the last 30 days in order to be eligible.
- The participant also needs to have completed the End of Study survey
- If the participant completed both the syncing and survey requirements, 'Then' credit $50. You can also set up a message to notify the participant about their earning!
- Click 'Save Logic'.