To view campaign data and use the connector, users must be mapped between Microsoft Dynamics and Dotdigital, and assigned at least one email-related security role. This is in addition to the usual security roles of Microsoft Dynamics (for example, Sales Representative or Marketing Manager).
Before you start
Things you need to know:
To use the Dotdigital for Dynamics connector, all your users must be existing users in both your Microsoft Dynamics and Dotdigital accounts.
Learn how to add users to Dotdigital in Add a user.
No Dotdigital app tile?
If a user or users don't see the Dotdigital (Engagement Cloud) tile in the Published Apps section of Dynamics, then an admin user can assign the required roles to the tile.
To do this:
Select the three dots menu icon on the Dotdigital (Engagement Cloud) tile.
Select MANAGE ROLES.
Select the user roles that should have access to the tile.
Select Save.
New email-related security roles
Installing the Dotdigital for Dynamics connector adds four email-related security roles in Microsoft Dynamics:
Role | Description |
Email Marketing Manager | Can manage campaigns, send campaigns, and synchronise marketing lists between your CRM and Dotdigital account. |
Email Marketing Professional | Can manage campaigns and synchronise marketing lists between your CRM and Dotdigital account. |
Email Marketing Viewer | Can view campaigns that have been synced to Dynamics, as well as all associated data, but they can't send or manage campaigns. |
Email Campaign Connector Service (System use only) | A system-use-only role that allows the account to access and update all of the entities used by the integration. |
Add security roles to users
Select the Settings icon in the top-right corner and then select Advanced Settings.
In the left-side menu, select Security under the System heading.
Select Users to open the Enabled Users list.
Select the checkbox next to each user you want to add roles for, and then select MANAGE ROLES.
Under Manage User Roles, select the checkbox next to each email-related security role you want to add to the user.
Select OK to apply the roles.
Map your users
All Dynamics users who have the appropriate Security Role(s) and are existing users within your Dotdigital account should be mapped. Mapping these users allows them to use the Single Sign-On functionality by selecting Dotdigital from the Access section of the left-hand menu, saving you time when you need to use both platforms at once.
Users who attempt to access Dotdigital through Single Sign On without being mapped will receive an error message.
To map users:
Go to Email Accounts under Settings.
This loads the Active Email Accounts page.
Select the email account you want to map users for.
Select User Mapping.
Dotdigital account users are listed on the left side of the page, and Dynamics users are listed on the right-hand side. Expand the drop-down menu under the Dynamics User column and map the Dynamics users to the corresponding Dotdigital account user.
Select Save.