Engage Help Center
ENGAGE HELP CENTER
Response alerts
This guide will help you explore the options the response alert functionality provides.
What are the benefits of this feature?
- User-friendly designThe response alert builder has been technically upgraded to show dropdown menus of all of the Radiogroup, Dropdown and Checkbox question types and answers included in the activity to bring you only a couple of clicks away from creating the response alert setups you need.
- Create as many response alerts as necessaryThere is no limit to the number of response alerts that can be created for an activity. Design alerts for intricate combinations of responses to support the empirical observations of your project.
- Oversee the alerts in the list of submitted Participant responsesThe created alerts will light up in the list of all participant responses of the activity and will also show up in the export files of the activity responses.
Engage platform allows the administrators to set up in-platform alerts for participant activity responses containing one or multiple specific answers. It is possible to also send a notification about a new response alert to the administrator's e-mail address.
Simply access the section Response alerts available when selecting the three vertical dots on the activity card from the Activities view of your project and start setting up the alerts you need.
Simply access the section Response alerts available when selecting the three vertical dots on the activity card from the Activities view of your project and start setting up the alerts you need.
Supported question types
Response alerts can be set to Radiogroup, Checkbox, Dropdown and Single Input questions. Each question type has a set of operators available.
Radiogroup: answer equals, not equal to, in.
Checkbox: is within group, is not within group, contains any of, contains none of, contains all of.
Dropdown: answer equals, not equal to, in.
Single Input: answer equals, not equal to, in.
Response alerts can be set to Radiogroup, Checkbox, Dropdown and Single Input questions. Each question type has a set of operators available.
Radiogroup: answer equals, not equal to, in.
Checkbox: is within group, is not within group, contains any of, contains none of, contains all of.
Dropdown: answer equals, not equal to, in.
Single Input: answer equals, not equal to, in.
Create new Response alerts
The Select activity field will be pre-filled based on the activity card from which the Response alert function has been accessed.
Next, the section Mark response details can be populated with as many Conditional expression lines as necessary. Each Conditional expression line has three elements to fill:
1. Question: Select one of the activity questions from a dropdown menu;
2. Operator: Select the operator to govern the condition;
3. Response: Choose the response of the selected question that will trigger the Response alert.
The Select activity field will be pre-filled based on the activity card from which the Response alert function has been accessed.
Next, the section Mark response details can be populated with as many Conditional expression lines as necessary. Each Conditional expression line has three elements to fill:
1. Question: Select one of the activity questions from a dropdown menu;
2. Operator: Select the operator to govern the condition;
3. Response: Choose the response of the selected question that will trigger the Response alert.
Operators
answer equals - use to trigger the Response alert only if a specific answer of a Dropdown, Radiogroup or Single Input question is provided.
not equal to - use to trigger the Response alert only if a specific answer of a Dropdown, Radiogroup or Single Input question is not provided.
in - use to trigger the Response alert if the answer to a Dropdown, Radiogroup or Single Input question falls within the defined range of answers or group of answer choices of the question.
is within group - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question fall within the answer group defined in the condition.
is not within group - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question does not fall within the answer group defined in the condition.
contains any of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains any of the answers defined in the condition.
contains none of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains none of the answers defined in the condition.
contains all of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains all of the answers defined in the condition.
answer equals - use to trigger the Response alert only if a specific answer of a Dropdown, Radiogroup or Single Input question is provided.
not equal to - use to trigger the Response alert only if a specific answer of a Dropdown, Radiogroup or Single Input question is not provided.
in - use to trigger the Response alert if the answer to a Dropdown, Radiogroup or Single Input question falls within the defined range of answers or group of answer choices of the question.
is within group - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question fall within the answer group defined in the condition.
is not within group - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question does not fall within the answer group defined in the condition.
contains any of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains any of the answers defined in the condition.
contains none of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains none of the answers defined in the condition.
contains all of - use to trigger the Response alert only if the participant's selection of answers to a Checkbox question contains all of the answers defined in the condition.
To set up a Response alert for a Single Input question with the operator in, the answers that will trigger the alert have to be entered in a specific format.
The operator in will ensure the Response alert is triggered if the necessary values are separated by a comma without any spaces between them.
The operator in will ensure the Response alert is triggered if the necessary values are separated by a comma without any spaces between them.
4. Alert name: decide how to call the alert and choose the color of the tag for the alert.
5. Send email about alert: enable this boolean if you would like an email notification to be sent out each time a participant's activity submission triggers the alert. Add as many alert recipients as necessary. Design a simple message to be sent in the email notification or outline instructions and next steps to people responsible for addressing the red flag situation that the alert warns about.
6. Create alert: finally, save the details of the response alert.
5. Send email about alert: enable this boolean if you would like an email notification to be sent out each time a participant's activity submission triggers the alert. Add as many alert recipients as necessary. Design a simple message to be sent in the email notification or outline instructions and next steps to people responsible for addressing the red flag situation that the alert warns about.
6. Create alert: finally, save the details of the response alert.
The Activity card that will have at least one Response alert created, will have a flag icon displayed in the top-right corner of it with a number indicating how many different alerts have been set up.
Edit and delete Response alerts
All of the created Response alerts can be edited and deleted.
Edit a Response alert
Select the flag icon located in the top-right corner of the Activity card at hand for which the alert has to be altered. In the section Manage all of the created Response alerts will be displayed.
Choose the alert that needs to be edited and select the pencil icon located in the top-right corner of the specific alert.
All of the created Response alerts can be edited and deleted.
Edit a Response alert
Select the flag icon located in the top-right corner of the Activity card at hand for which the alert has to be altered. In the section Manage all of the created Response alerts will be displayed.
Choose the alert that needs to be edited and select the pencil icon located in the top-right corner of the specific alert.
Next, the editable window Edit response alert will be opened and it will be possible to make the necessary changes.
Delete a Response alert
From the Manage view of Response alerts choose the alert that needs to be deleted and select the recycle bin icon located in the top-right corner of the specific alert. Engage platform will request a confirmation that the alert should be permanently deleted.
From the Manage view of Response alerts choose the alert that needs to be deleted and select the recycle bin icon located in the top-right corner of the specific alert. Engage platform will request a confirmation that the alert should be permanently deleted.
Review Response alerts
The Response alerts will light up in the list of submitted Participant responses of the populated survey.
Review the Response alerts
To review the Response alerts among the Participant responses, click on the number of Participants on the Activity card for which the Response alert was set up.
The Response alerts will light up in the list of submitted Participant responses of the populated survey.
Review the Response alerts
To review the Response alerts among the Participant responses, click on the number of Participants on the Activity card for which the Response alert was set up.
The colored tag and the name of the Response alert will show up on the line of the specific participant response for which all of the Conditional expressions will have turned out true as set up for the Response alert.
Export the Response alert information
The Response alert information will be included in the Excel or JSON export files of the activity results, as well.
The Excel export file will have as many additional columns as Response alerts created and each line (i.e., each unique participant response) for which all of the the Response alert conditions will have fulfilled will have the respective column filled with TRUE.
The Response alert information will be included in the Excel or JSON export files of the activity results, as well.
The Excel export file will have as many additional columns as Response alerts created and each line (i.e., each unique participant response) for which all of the the Response alert conditions will have fulfilled will have the respective column filled with TRUE.
The JSON export file will have the element response_alert_Alert[x]":true added to the section records of the participant's response. The name of the Response alert will be indicated in this element.
{
"survey_title":"Survey 1",
"start_date":false,
"end_date":false,
"survey_slug":"jyozmu",
"survey_access":"all",
"survey_visibility":"displayed on project's page",
"utc_exported_at":"2022-02-22 12:09:27",
"records":[
{
"sex":{
"answer":"Female",
"answer_value":"female",
"question":"Please indicate your biological sex.",
"question_value":"sex",
"type":"dropdown"
},
"relative":{
"answer":"Yes",
"answer_value":"yes",
"question":"Does a first degree relative of yours have or have had a breast cancer diagnosis?",
"question_value":"relative",
"type":"radiogroup"
},
"diagnosis":{
"answer":"Yes",
"answer_value":"yes",
"question":"Do you have or have had a breast cancer diagnosis?",
"question_value":"diagnosis",
"type":"radiogroup"
},
"person":1056,
"created_at":"2022-02-22T08:26:35.215230Z",
"response_alert_Alert1":true
}
Please refer to the Engage Help Center pages Export data and Export data in JSON format for more details on how to extract and read the submitted responses in a processing-friendly format - Excel or JSON.
Our team is ready to provide you assistance in any of the steps and would gladly guide you through the process.
Do not hesitate to contact us via support@longenesis.com if you have any questions or any help is required.
Do not hesitate to contact us via support@longenesis.com if you have any questions or any help is required.