What: The Microsoft Dynamics CRM connection allows you to synchronize visitor data between BlueConic and Microsoft Dynamics 365 online (back and forth) in real time.
About BlueConic: BlueConic is a Customer Data Platform that harnesses the data required to power the recognition of an individual at each interaction, and then synchronizes their intent across the marketing ecosystem. Learn more about the BlueConic platform.
Why: CRM data integrated into BlueConic is prime material for segmentation and personalization. BlueConic features a unique data collection engine that captures data at the customer level for known and anonymous users. For known users, or once a user becomes known, having this data in your CRM will arm your call center and other communication platforms with relevant details about your customers' explicit and implicit intents.
Microsoft Dynamics 365 online is required for this connection.
Getting the connection with Microsoft Dynamics 365 up and running is divided in two parts:
Preparing Dynamics and AzureAD
In order for BlueConic to connect with Dynamics, BlueConic needs to be registered in Azure Active Directory (Azure AD) and to have this registration data configured in the BlueConic connection. You'll need to follow the steps below and record some data along the way.
This guide tries to enable you to fully install this connection on your own, however BlueConic can not give support on the configuration of Azure AD. If you have a non-standard installation, this guide tries to provide you with a solution, but in the end BlueConic is limited to what tools Microsoft provides, and you may need to contact a Microsoft partner or representative.
This setup is probably best done by someone familiar with Azure and Azure AD.
- Full access to Azure and Azure AD
- Access to Dynamics CRM 365 online and the Dynamics CRM url (should look like "https://<companyname>.crm.dynamics.com")
- Access to BlueConic
- An installed Dynamics CRM BlueConic plugin
Setting up Azure Active Directory
Setting up Azure AD is a multi-step process, laid out below:
1. Open Azure AD
Within Azure, open up Azure AD (https://portal.azure.com/). You should be able to find it in the left sidebar or under "More services".
2. Select App Registrations
After opening AzureAD you will see the screen below. Select "App registrations":
3. Register new app
Within the new screen, select "New application registration".
Next, configure the required fields. You will have to set:
Choose a recognizable name, e.g. "BlueConic"
"Web app / API"
Your BlueConic login page, e.g. https://example.blueconic.net/login
After filling out the required fields, save the new app registration.
4. Select Application
Back on the "App registrations" page, select your new app.
Note the "Application ID". You will need this value later.
5. Add Required Permission
Next, the newly registered app needs permission to access Dynamics CRM. Select "Required permissions" and then "Add" a new permission.
Select "Select an API" and then select "Dynamics CRM online".
If Dynamics CRM online does not show up here, your account does not have access to Dynamics CRM online or Dynamics is not properly connected to your Azure instance.
Now use "Select Permissions" and under "Delegated Permissions" select "Access CRM Online as organization users" and save.
6. Verify Dynamics Permission
After saving, check your API Access Required Permissions to make sure Dynamics CRM Online is listed.
7. Create Key
Next create a secret key for your app registration. BlueConic use this key to secure the communication with Dynamics CRM. Set an understandable "Description" and select "In 2 years" for Expires. Then Save your changes.
After saving, make sure you store the key description and key value securely, as you will need these later. If you lose these values you will have to regenerate them.
8. Add Reply URL
All that remains is to add an oAuth Reply URL. Select "Reply URLs" and enter the following: https://oauth.blueconic.net/redir/
9. Obtain Directory ID
Navigate to the Dashboard > Active Directory > Manage Properties. Copy the "Directory ID".
Configuring the Microsoft Dynamics Connection
Set up and run
After following all the above steps, you should now have the following data:
- Application ID
- Directory ID
- Secret key
- Your Dynamics URL, e.g. https://swsmn.crm2.dynamics.com/. Make sure it ends in a "/".
With the information obtained in the steps above you can now set up the BlueConic Dynamics CRM connection. Open BlueConic and add a Microsoft Dynamics CRM connection on the Connections page.
Enter a name for connection at the top of the page, select whether to receive email notifications when the connection runs or fails to run, and save the connection.
Then press "Connect with Microsoft Dynamics CRM". A pop-up window should open and redirect you to a Microsoft Dynamics login page, where you fill in your Microsoft Dynamics CRM credentials and log in. After logging in you should be redirected to the BlueConic page. After a short while the words "Cannot connect to Microsoft Dynamics" disappear.
Data exchange shows the total number of unique profiles that have been imported or exported via the connection. Note that these are unique profiles. If the same profile is exported multiple times, it is counted as 1.
Now you are ready to set up your import and export goals.
Setting an import goal
Import data from Microsoft Dynamics 365 into BlueConic by running a batch connection. Click the Add goal button and choose Import goal. You can customize the name of the import goal at the top of the page.
- Choose the data you want to import from Dynamics: leads and / or contacts.
- Link identifiers for contacts or leads being imported from Dynamics.
- Map the Dynamics data you want to add to BlueConic profiles.
You can select how to import the data from the Set drop-down menu:
- Set if empty
- Add the data field to the list of existing values
- Sum a number with the existing values (if the data field is a number)
- Specify whether you want to allow new profiles to be created in BlueConic if no matching lead or contact is found for a Dynamics lead or contact.
Setting an export goal
Export data from BlueConic to Microsoft Dynamics 365 in real time. Click the Add goal button and choose Export goal. You can customize the name of the import goal at the top of the page.
- Select a BlueConic segment to export profile data from.
In the top right-hand corner, the number of profiles available for the export appears.
This number shows how many profiles meet the conditions for the selected segment (for example, they have an email address and gave required consent for an objective) and therefore are available for the export. BlueConic tries to export only the profiles that have changed since the last export. This number of profiles exported may be lower than the number displayed here.
- Specify whether you want to export data to leads and / or contacts.
- Link BlueConic profiles to Dynamics leads or contacts by linking identifiers from both systems.
- Map the BlueConic data you want to send to the corresponding Dynamics fields.
Select a BlueConic profile property by entering a search term and enter the Dynamics value it should populate.
Click the BlueConic icon to open a drop down menu where you can switch between the type of information you want to export. Pick one of:
- BlueConic profile identifier: The unique identifier for a profile
- Associated segments: All segments, or a selection of one or more specific segments that the profile is associated with
- Profile property: The value of a specific profile property
- All viewed interactions (all time): The interactions that the profile has seen
- Permission level: The permission level set in the profile
- Text value: Enter any static text
- Optional: Specify whether you want to allow the creation of new leads in Microsoft Dynamics if no matching lead or contact is found for a BlueConic profile. You can further specify whether to reopen leads formerly marked as disqualified. This step is optional.
You can restrict the leads that are created by selecting an optional segment. For example, if you selected "All Visitors" in step 1, select "Engagement: High" as an optional segment to only create leads in Dynamics if the visitors are part of both segments. If you choose a segment here, BlueConic shows the number of profiles that are in both this segment and the segment in step 1 and can potentially become leads in Microsoft Dynamics.
Connections can be added to Objectives, allowing for privacy management of the information that is being picked up. A connection will only process the profiles of visitors who have consented to at least one of the objectives that the connection is linked to.
If you get stuck on the Dynamics login page, take a screenshot of the entire page. Technical information is often stored in the bottom right corner and be sure to include this.
"Additional technical information:
Correlation ID: 122b6ac1-2076-4109-b0b2-1809708b1d44
Timestamp: 2022-06-08 11:07:54Z
AADSTS90002: Tenant 2c2b1d3f-d39f-4ffa-9f21-11d4d4bdf77 not found. This may happen if there are no active subscriptions for the tenant. Check with your subscription administrator."
When contacting BlueConic support, be sure to include as much information as possible.
Contact us for more information on the Microsoft Dynamics connection.