Microsoft Dynamics Connection

What: The Microsoft Dynamics 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. Click here to learn more.

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.

Prerequisites:

  • 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:

Name

Choose a recognizable name, e.g. "BlueConic"

Application type

"Web app / API"

Sign-on URL

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.

Picture6.png 

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 will use this to secure the communication with Dynamics CRM. Set a understandable "Description" and select "In 2 years" for Expires. Then Save.

 

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/

Picture13.png  

9. Obtain Directory ID

Navigate to the Dashboard > Active Directory > Manage Properties. Copy the "Directory ID".

Picture10.png

 

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 the information and save the connection. Then press "Connect with Microsoft Dynamics CRM". A popup 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" will disappear.

dynamics-crm.png 

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.

Microsoft_Dynamics_Data_Exchange.png

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.

  1. Choose the data you want to import from Dynamics: leads or contacts.
    import_dynamics_leads_contacts.png
  2. Link identifiers for contacts or leads being imported from Dynamics.
    link_import_identifiers.png
  3. Map the Dynamics data you want to add to BlueConic profiles. 
    link_import_identifiers.png
  4. 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.

  1. Select a BlueConic segment to export profile data from.

    In the top right-hand corner, the number of profiles available for the export appears.

    profiles.png

    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. 

  2. Specify whether you want to export data to leads or contacts
    export_dynamics_leads_contacts.png
  3. Link BlueConic profiles to Dynamics leads or contacts by linking identifiers from both systems. 
    dynamics_map.png
  4. Map the BlueConic data you want to send to the corresponding Dynamics fields.
  5. Specify whether you want to allow the creation of new leads in Dynamics 365 if no matching lead or contact is found for a BlueConic profile. 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 "Highly Engaged" as an optional segment to only create leads in Dynamics if the visitors are part of both segments.

Privacy management

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.

Troubleshooting

If you get stuck on the Dynamics login page, please take a screenshot of the entire page. Technical information is often stored in the bottom right corner and be sure to include this.

For example:


"Additional technical information:

Correlation ID: 122b6ac1-2076-4109-b0b2-1809708b1d44

Timestamp: 2017-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, please include as much information as possible.

 

Contact us for more information on the Microsoft Dynamics connection.