Walkthrough: Installing SFMC Behavioral Data Exchange on-prem
SFMC connectors do not support running via Remote SDK.
This walkthrough describes how to:
- Install SFMC Behavioral Data Exchange on-prem
- Add an API integration package to your SFMC installation
- Add an SFMC connection string to your Sitecore installation
Install SFMC Behavioral Data Exchange on-prem
To install Sitecore Connect for Salesforce Marketing Cloud - Behavioral Data Exchange (SFMC-BDE):
- Download the Sitecore Connect for Salesforce Marketing Cloud - Behavioral Data Exchange package.
- On the Sitecore Launchpad, click Control Panel.
- In the Control Panel, in the Administration section, click Install a package to open the Installation Wizard.
- Click Upload package and follow the steps to upload the module package to Sitecore.
- Click Next and follow the steps to install the package.
- Before you close the wizard, select Restart the Sitecore Client.
To check that you have installed SFMC-BDE successfully:
- In the Content Editor, go to
/sitecore/system/Data Exchange. - Check that the Connect for SFMC Tenant insert option is present.
Add an API integration package to your SFMC installation
To add an API integration package to your SFMC installation:
-
Open your Marketing Cloud site.
-
In top right corner, click your account, then click Setup.
-
In the left navigation bar, in the Platform Tools section, click Apps, then click Installed Packages.
-
In the top right corner, click New. In the New Package Details window, in the Name field, enter a name for your package. You can name it anything, for example, sitecore-def.
-
Click Add Component, and click API Integration. Click Next.
-
Select the Server-to-Server integration type, and then click Next.
-
Add the required rights for your connection. xConnect to SFMC integrations require the following rights:
DATA Data Extensions - Read
- Write
-
Click Ok.
Add an SFMC connection string to your Sitecore installation
To add an SFMC connection string to your Sitecore installation:
-
In the Components area of the component you created, make a note of the following values:
- Client Id
- Client Secret
- Authentication Base URI
- REST Base URI
- SOAP Base URI
-
Use the values to construct a connection string with this format:
-
Add the connection string to the
App_config\connectionstrings.configfile on your Sitecore instance. -
In the
App_config\connectionstrings.configfile, ensure that the following connection strings are present:xconnect.collectionxconnect.collection.certificate