Add Contacts to Mobile Push Sendout Group

Goal​

Automatically add contacts to a group used for mobile push notifications in Mapp Engage.

Procedures

1 Event-Based Whiteboard (recommended)

Use this procedure to add contacts to a mobile push sendout group when they interact with your mobile app.

Prerequisites

• A mobile app integrated with Mapp Engage

• The mobile app must track app events (e.g., Open App, App Promo)

• The group used for push messages must already be created

Procedure

1. Navigate to Automations > Whiteboards > Create New Whiteboard.

2. Drag and drop the App Event module onto the canvas.

3. Configure the App Event:

   • Mobile App: Select the relevant app.

   • App Event: Select the event that triggers contact addition (e.g., Open App).

4. Add a Job module and connect it to the App Event.

5. Configure the Job module:

   • Job: Select Add to / Remove from Group

   • Group: Choose the mobile push group

   • Method: Select “Add to Group”

6. Save and activate the Whiteboard.

2 Automation with Profile Data Changed Event (obsolete)

This legacy method uses profile-based automation. It’s still supported but not recommended for new implementations.

Prerequisites

• A group for mobile push notifications must be created

• A specific app profile field must be available

Procedure

1. Navigate to Automation > Create New Automation.

2. Configure the Event Module:

   • Event: Profile Data Changed (New) (C)

   • Profile Change: Specific

   • Select by Profile Value:

     • Click Add more

     • Parameter 1: Select the app name or display name

3. Configure the Event-based Job Module:

   • Job: Add Contact to Group (C)

   • Contact: Check Use Event Parameter

   • Group Name: Select the push notification group

   • Add Contacts: Select Without Notification

   • Selection: Leave empty

4. Save and activate the automation.

Best Practices

• Use the App Event method for cleaner tracking and more flexible automation across devices

• Assign descriptive names to Whiteboards and groups for easy identification

• Avoid combining mobile push and email channels in the same group

Next Steps

• Monitor app event triggers to validate contact flow into the group

• Use segmentation to analyze push engagement by group membership