Emarsys Integration

​

Requirements

• An API user name and secret
• A dedicated push campaign with personalization tokens and an external event

​

Set Up API Permissions

​

Create an API User and Secret

1. Login to the Emarsys application
2. Go to Admin > Security Settings
3. Press on Create API user
4. Copy the resulting User name and Secret (note that the secret will no longer be available for copying once you leave this screen)

​

Set Up API Permissions for the Newly Created User

1. Go to Management > Security Settings > API Users
2. Click on the edit button (in the form of a pencil)
3. You will reach a menu with toggles with all the possible Emarsys API permissions
4. Find and toggle the externalevent.trigger permission
5. Click on Edit at the bottom of the page to apply the permission modifications

​

Create a Dedicated Campaign for Aampe

​

Step 1: Create Personalization Tokens

1. Go to Content > Personalization
2. Click on Create Token
3. Select External Data in the Choose Personalization Capability window
4. Enter “Aampe Title” under Name and “Aampe” under Category. Create “Aampe” category by clicking Create Category
5. Click on New in the JSON object section
6. Enter “aampe” under Name
7. Copy/paste the following JSON snippet into the code editor:
   Copy

   { "aampe": { "title": "Push notification title", "body": "Push notification body" } }
   
   

8. Press on Modify
9. Select event.aampe.title in the Field section
10. Click Save
11. Click on Create Token again selecting External Data in the Choose Personalization Capability window
12. This time, enter “Aampe Body” under Name and “Aampe” Category for this token.
13. Select the “aampe” JSON object that you just created
14. Select event.aampe.body in the Field section
15. Click Save

​

Step 2: Create Push Campaign

1. Go to Channels > Mobile Engage
2. Select the Push Messages tab
3. Click Create Push campaign
4. In the campaign wizard, enter “Aampe” in Message name, select your mobile app and set Recipient Source to “Automation Center”
5. Drag the Aampe Title and Aampe Body personalization tokens respectively to the title and body sections of the notification in the preview pane.
6. Click Ready to Launch

​

Step 3: Set Up an External Event

1. Go to Management > External Events
2. Click on Create External Event
3. Enter “Aampe push trigger” under External event name
4. Click on Create
5. Copy the external event ID number, it will be needed later when setting up the integration in the Aampe composer

​

Step 4: Create an Interactions Program

1. Go to Automation > Automation
2. Click on Create Program
3. Select Behavior-focused journeys (Interactions)
4. Select External event as the trigger
5. Double click on the External event node
6. Select the external event created in Step 3
7. Click OK
8. Click on the Decision node to add it to the program
9. Double click on the new Decision node that you just added
10. Add the segment with all of your users
11. Click OK
12. Click on the Mobile Engagement push message channel to add it to the program
13. Double click on the Mobile Engagement push message node
14. Select the “Aampe” push campaign that you created in Step 2 using the dropdown menu
15. Click OK
16. Click Activate

​

Set Up the Integration in the Aampe Composer

1. Go to https://compose.aampe.com and login using your Aampe credentials
2. Navigate to Configure > Push Provider
3. Toggle the Emarsys integration
4. Input your API User name, Secret, and External Event ID you generated during this setup tutorial