Work with Campaign and Microsoft Dynamics 365 crm-ms-dynamics
Activate your CRM data on cross-channel communication: learn how to pass on contacts from Microsoft Dynamics 365 to Adobe Campaign, and share campaign performance data (sends, opens, clicks, and bounces) back from Adobe Campaign to Microsoft Dynamics 365.
Once configuration is done, data synchronization between systems is carried out via a dedicated workflow activity. Learn more.
Follow the steps below to configure a dedicated external account to import and export Microsoft Dynamics 365 data into Adobe Campaign.
For each system, these steps need to be performed by an administrator.
Configure Microsoft Dynamics 365 config-crm-microsoft
To connect Microsoft Dynamics 365 to work with Adobe Campaign via Web API, log on to Microsoft Azure Directory using a Global administrator credential, and follow the steps below:
- Get your Dynamics 365 Application (client) ID. Learn more
- Generate Microsoft Dynamics Certificate key identifier and Key ID. Learn more
- Configure permissions. Learn more
- Create an App User. Learn more
- Encode the private key. Learn more
Get Dynamics 365 Client ID get-client-id-microsoft
To get the Application (client) ID, you need to register an App in Azure Active Directory.
- Browse to Azure Active Directory > App Registrations, and select New Registration.
- Enter a unique name which can help identify an instance, such as adobecampaign
<instance identifier>
.
Once you save, Microsoft Azure Directory assigns a unique Application (client) ID to your app. You will need this ID later on in configuring Dynamics 365 in Adobe Campaign.
Learn more in Microsoft Dynamics 365 documentation.
Generate Microsoft Dynamics Certificate key identifier and Key ID config-certificate-key-id
To get the Certificate key identifier (customKeyIdentifier) and the Key ID (keyId), you must upload a certificate. Certificates can be used as secrets to prove the application’s identity when requesting a token. Also can be referred to as public keys.
Follow the steps below:
- Browse to Azure Active Directory > App Registrations and select the Application which was created earlier.
- Select on Certificates & Secret.
- From the Certificates tab, click on Upload certificate
- Upload your public certificate.
- Browse to the Manifest link to get the Certificate key identifier (customKeyIdentifier) and the Key ID (keyId).
The Certificate key identifier (customKeyIdentifier) and the Key ID (keyId) are needed in Campaign to configure your Microsoft Dynamics 365 CRM external account using the Certificate CRM O-Auth type.
To generate the certificate, you can use openssl.
For example:
code language-none |
---|
|
note note |
---|
NOTE |
You can change the number of days, here -days 365 , in the code sample for a longer certificate validity period. |
You must then encode the certificate in base64. To do so, you can use the help of a Base64 encoder or use the command line base64 -w0 private.key
for Linux.
Configure permissions config-permissions-microsoft
Step 1: Configure the Required Permissions for the app that was created.
- Navigate to Azure Active Directory > App Registrations and select the Application which was created earlier.
- Click Settings on the top left.
- On Required Permissions, click Add and Select an API > Dynamics CRM Online.
- Click Select, enable Access Dynamics 365 as organization users checkbox and click Select.
- Then, from your app, select the Manifest under the Manage menu.
- From the Manifest editor, set the
allowPublicClient
property fromnull
totrue
and click Save.
Step 2: Grant admin consent
- Navigate to Azure Active Directory > Enterprise applications.
- Select the application to which you want to grant tenant-wide admin consent.
- From the left pane menu, select Permissions under Security.
- Click Grant admin consent.
For more information on this, refer to Azure documentation.
Create an App User create-app-user-microsoft
The App user is the user that the application registered above will use. Any changes made to Microsoft Dynamics using the App registered above will be done via this user.
Step 1: Create a non-interactive user on azure active directory
- Click Azure Active Directory > Users and click New User.
- Give a proper name that you want use and the username should be an email format.
- Choose Dynamics 365 Administrator in the Directory Role.
Step 2: Assign a proper license to the created user
- From Microsoft Azure, click on Admin app.
- Go to Users > Active Users and click on the newly created user.
- Click on Edit product licenses and select the Dynamics 365 Customer Engagement Plan.
- Click Close.
Step 3: Create an application user on Dynamics CRM
- From Microsoft Azure, navigate to Settings > Security > Users.
- Click on drop-down, select Application users, and click New.
- Use the same username as the user created on active directory above.
- Assign the Application ID for the application you created earlier.
- Click on Manage Roles and choose the System administrator role to the user.
Configure Campaign configure-acc-for-microsoft
Create the connection new-ms-dyn-external-account
First, you must create the Microsoft Dynamics 365 external account.
-
Browse the Administration > Platform > External accounts node of the Campaign explorer and create an external account.
-
Select Microsoft Dynamics CRM external account in the Type section.
-
Select the authentication method in the CRM O-Auth type drop-down list.
-
To configure the Microsoft Dynamics CRM external account to connect with Adobe Campaign with Password Credentials, provide the following details:
- Server: URL of your Microsoft CRM server. To find your Microsoft CRM Server URL, access your Microsoft Dynamics CRM account then click Dynamics 365 and select your app. You can then find your Server URL in the address bar of your browser, e.g. https://myserver.crm.dynamics.com/.
- Account: Account used to sign in to Microsoft CRM.
- Password: Account used to sign in to Microsoft CRM.
- Client identifier: Application (client) ID which can be found from Microsoft Azure management portal in the Update your code category, Client ID field.
- CRM version: Choose Dynamics CRM 365 CRM version.
-
To configure the Microsoft Dynamics CRM external account to connect with Adobe Campaign with a Certificate, provide the following details:
- Server: URL of your Microsoft CRM server. To find your Microsoft CRM Server URL, access your Microsoft Dynamics CRM account then click Dynamics 365 and select your app. You can then find your Server URL in the address bar of your browser, e.g. https://myserver.crm.dynamics.com/.
- Private key: Copy/Paste the private key, encoded base64 as explained in this section.
- Key ID: Key available in the Manifest tab of your application, as explained in this section.
- Custom Key identifier: Identifier available in the Manifest tab of your application, as explained in this section.
- Client identifier: Application (client) ID which can be found from Microsoft Azure management portal as explained in this section.
- CRM version: Choose Dynamics CRM 365 CRM version.
-
-
Select the Enable option to activate the account in Campaign.
Select tables to synchronize ms-dyn-create-tables
You can now configure tables to synchronize.
- Click the Microsoft CRM configuration wizard….
- Select the tables to synchronize and start the process.
- Check the schema generated in Adobe Campaign in the Administration > Configuration > Data schemas node.
login.microsoftonline.com
. To perform this, contact your Adobe representative.Synchronize enumerations sfdc-enum-sync
Once the schema is created, you can synchronize enumerations automatically from Dynamics 365 to Adobe Campaign.
- Open the assistant from the Synchronizing enumerations… link.
- Select the Adobe Campaign enumeration that matches the Dynamics 365 enumeration.
You can replace all values of an Adobe Campaign enumeration with those of the CRM: to do this, select Yes in the Replace column. - Click Next and then Start to start importing the enumerations.
- Browse the Administration > Platform > Enumerations node to check imported values.
Adobe Campaign and Microsoft Dynamics 365 are now connected. You can set up data synchronization between the two systems.
To synchronize data between Adobe Campaign data and Microsoft CRM, create a workflow and use the CRM connector activity.
Learn more about data synchronization in this page.
Supported field data types ms-dyn-supported-types
For Microsoft Dynamics 365 supported/unsupported attribute types are listed below: