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 design
    The 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 necessary
    There 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 responses
    The 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 response alerts, a function designed to make it easier to follow the flow of the incoming responses from the participants.

Now, it is possible to set up in-platform alerts for activity responses containing one or multiple answers pre-defined when setting up the alert! Simply access the option Response alerts available when selecting the three vertical dots on the Activity activity card from the Activities view of your project and start setting up the alerts you need. After selecting Manage conditions on the Activity card of your choice, a pop-up window will appear.
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.

Insert the Alert name and choose the color the tag of this specific alert will have in the Engage platform.
Finally, when all the necessary response combinations have been set, select Create alert.
Operators
answer equals - use to trigger the Response alert only if a specific answer of a Dropdown or Radiogroup question is selected.
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.
As many different Response alerts as necessary can be created for the same survey. When trying to create a new alert, select the option New and set up the conditions for the new alert as needed.

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.
Next, the editable window Edit response alert will be opened and all the necessary changes will be possible to be made.
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.
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 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 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.