Create the necessary Personalization tokens:

• Confirm sections of the messages that are to be dynamically updated using Personalization.
• Make the Personalization tokens available for campaigns.

Create the Push campaign message:

• Link to the correct app.
• Add Push campaign content, linked to personalization.

Create the External event:

• Add the external events to be used to trigger the campaign

Create the necessary Mobile Segment:

• Segment should be linked to the correct app.

Create the Interactions program:

• Design the contact journey.

1. To create a Personalization token, go to Content > Personalization.
2. Click Create Token.
3. Select External Data for the Personalization Capability.

4. Enter a Name and choose a Category. If the Category is not available, create a new one by clicking Create Category.

4. Click on New in the JSON object section and enter the JSON payload details, an example is below:

5. In the Field section, select the field the Personalization token will display/update in the campaign.

6. Click Save.

1. To create an Push campaign, go to Channels > Mobile Engage > Push Messages tab, and click Create Push campaign to launch the campaign wizard.

2. Fill in the general settings, giving the Push campaign a name, linking it to the app, and selecting the Recipient source as ‘Automation Center’.

3. Type your message content in the preview pane and drag in any relevant personalization tokens or add images for rich push.

4. Once complete, click Ready to Launch and the Push Notification will be able to be selected from the relevant Interactions Program

1. To create an external event, go to Management > External Event.

2. Click on Create External Event.

3. Give the event a name and click Create.

1. To create a segment to be used in the Interactions program, go to Contacts > Segment.

2. Click on Create Segment.

3. Select Contact, Email behaviour, Geo, Smart Insight segment

Enter the segment criteria and click Save & Apply.

1. To create an Interactions program, go to Automation > Automation.

2. Click on Create Program and select Behavior-focused journeys (Interactions).

3. Select External event as the trigger.

4. Double click on the External event node.

5. Select the external event created for the campaign using the drop down menu and click OK.

6. Click on the Decision node to add it to the program. Double click on the new Decision node in the program, add the segment created previously and click OK.

7. Click on the channel Mobile Engage push message, to add the node to the program.

8. Double click on the Mobile Engage push message node.

9. Select the push campaign created for the campaign using the drop down menu and click OK.

10. Click Activate to make the program live.

To test the campaign using an API call, Emarsys has provided an online tool to trigger events. First, an API user needs to be created if one is not available already. Only Account Owners have the ability to create API Users. The option to create the API details is in the Management > Security Settings section of the account.

1. Once the API Username and the Secret token are available, go to the Emarsys API test tool and open the Triggering an External Event section.

2. Enter the External Event ID that was previously created.
3. Enter the Key ID, which is the field ID used for the contact identification. For example "3" is the ID for the email field. If email is not to be used for identification, go to the Management > Field Editor to retrieve the appropriate field ID.
4. Enter the Key Value, which is the contact ID being used. For example if 3 (the email address) is the Key ID provided in the previous step, enter the email address of the test user in this section.
5. In the Data section, enter the JSON payload to be sent in the API call.
6. Click Trigger to fire the API call. On the right of the screen, the Request Body and HTTP status is displayed to confirm if the request was successful.