Emarsys Integration

Step-by-step guide for brands to complete the Duel x Emarsys integration.

 

Step 1: Create an API user & secret

Open Emarsys and navigate to Management > Security Settings:

 

From here, navigate to API users, and create a new API user:

 

You will need to enter your Emarsys password in order to create a new API user:

 

 

Once the new API user has been created, you will be given a User name & Secret API key:

 

Step 2: Add new API user & secret to Duel

Open the Duel app and head to Settings in the top right, followed by Emarsys. You will then need to open up the Settings sub-tab. From here, you can paste your API user username and API user secret keys into the relevant fields.

 

Step 3: Edit required permissions list

Within Duel’s Emarsys settings, you will notice there is a list of required permissions. This will need to be edited in Emarsys.

Head back to Emarsys, within Security Settings - API users (where you left off).

Click the Edit button on the very right of your newest API user.

 

You will then need to scroll through the API user settings and toggle ON all of the required permissions that were listed in Duel and hit Edit at the very bottom, once done.

 

Head back to the Duel app and click save on your settings.

Step 4: Enable Duel’s events & properties

Within the Emarsys section of the Duel app, head to “Events/Properties” and switch on all elements that you’d like sent over to Emarsys. We recommend enabling all, so as to capture as much data as possible.

 

 

Step 5: Sync test member

Within the Emarsys section of the Duel app, head to “Member sync”, type in the email address of one of your test members & press “Sync test member”. After a very short wait, you will notice the member’s information display as below:

 

Head back into Emarsys, and search for the email address of your test member using the search scope: Contacts by Email.

Using the search result for your test member, you can create a new contact list by clicking “Save Contact List” in the top right. Give your new contact list a name e.g. “Duel members”.

 

Step 6: Linking new contact list to Duel

Within the URL of your new list, you will see an ID number. It will look like this:

list_id=2007258642

Highlight the list ID and Ctrl/Command + C to copy.

 

And paste it within Duel’s Emarsys settings before clicking SAVE.

Step 7: Sync all members

Take a look at the contact details for your test member via your new contact list in Emarsys, you will see that all of the synced Duel events & properties will be displayed under “Other”.

 

If the test member & information has synced correctly, you can head back to Duel and click “Sync all members” under “Member Sync”.

 

Step 8: All done! You are now integrated with Emarsys

Now it's time to set up some epic flows to help really build that community!