With this step, you are integrating with Salesforce in Demandbase One for Marketing using the Access Token method.
Important:
- Salesforce does not support username-password authentication for External Client Apps. You must integrate using the Access Token method. See Salesforce's article Connected App to External Client App Migration.
- You can also include Pardot (also referred to as Marketing Cloud Account Engagement) when integrating with Salesforce. See Integrate Pardot (Marketing Cloud Account Engagement) and Demandbase.
Prerequisites to Add Salesforce Integration in Demandbase For Marketing
- You must have Admin privileges or be assigned to a permission set with the required Demandbase settings access.
- Integration user must have at least the bare minimum permissions in Salesforce.
- Install the latest Demandbase App Package. See Step 1: Add Demandbase App Package in Salesforce.
- Know your Salesforce consumer key and secret from Step 2: Obtain Salesforce Credentials.
Step 1: Authenticate
- Completely log out of Salesforce from every window and tab.
- Log in to Demandbase One for Marketing (https://web.demandbase.com.)
- From the left navigation bar, go to
Settings > Integrated Systems > Integrations.
-
Click New Integration and click Salesforce.
- Go to Step 1: Authenticate tab.
-
Select Salesforce.
Tip: To set up a Salesforce Lite integration, see Set Up Salesforce Lite with Optional Pardot (Marketing Cloud Account Engagement) Integration. -
Enter the following:
- OAuth Type: Select Access Token.
- Consumer Key: Enter the Salesforce Consumer Key obtained in Step 2: Obtain Salesforce Credentials.
- Consumer Secret: Enter the Salesforce Consumer Secret obtained in Step 2: Obtain Salesforce Credentials.
-
(Optional) Custom Domain: If your Salesforce tenant uses a custom domain, click Edit, enter the domain, and click Save. See Salesforce's article Enhanced Domains.
Tip:- For a Salesforce URL such as
mycompany.my.salesforce.com, entermycompany. - For a Salesforce Sandbox URL such as
dev1.sandbox.my.salesforce.com, enterdev1.sandbox.
- For a Salesforce URL such as
- (Optional) Pardot Business Unit ID: To configure Pardot (Marketing Cloud Account Engagement) with Salesforce, enter your Pardot Business Unit ID. See Integrate Pardot (Marketing Cloud Account Engagement) and Demandbase.
-
Proof key for code exchange (PKCE): Toggle on if PKCE is enabled in your Salesforce External Client App (ECA). Otherwise, leave it disabled. The PKCE settings in Demandbase and Salesforce must match to prevent authentication failures. See Salesforce's article Enabling PKCE for OAuth for Salesforce External Client and Connected Apps.
Important: Once PKCE is enabled in a Salesforce ECA, it cannot be disabled for that app. To disable PKCE, you must create a new ECA. - Active: Toggle on to activate the Salesforce integration.
-
Click Next.
- In the Salesforce permission window, click Allow.
- Complete the steps in Step 2: Permissions (Confirm Salesforce Permissions).
Step 2: Permissions (Confirm Salesforce Permissions)
- Go to Step 2: Permissions tab.
-
Click the Refresh button.
Important: After successful authentication, Demandbase starts verifying permissions for required and optional Salesforce Objects. If permission for a required object cannot be verified, check the permissions of the corresponding Salesforce instance. For more information on permissions, see Best Practices for Salesforce Object Permissions. -
Click Next.
- Complete the steps in Step 3: Field Selection (Select Salesforce Fields).
Step 3: Field Selection (Select Salesforce Fields)
- Go to Step 3: Field Selection tab.
- (Optional) Go to the Account Fields, Contact Fields, Lead Fields, and Opportunity Fields tab and select the Salesforce fields you want to sync with Demandbase. See Field Ingestion Control for Salesforce.
- Click Next.
- Complete the steps in Step 4: Account Filters (Select Salesforce Accounts).
Step 4: Account Filters (Select Salesforce Accounts)
- Go to Step 4: Account Filters tab.
- (Optional) Use selectors to filter specific Accounts from syncing with Demandbase. See Account Ingestion Control for Salesforce.
- Click Next.
- Complete the steps in Step 5: Field Mapping (Map Salesforce Fields).
Step 5: Field Mappings (Map Salesforce Fields)
- Go to Step 5: Field Mappings tab.
- (Optional) Map Demandbase fields to Salesforce fields. See Manage Demandbase One for Marketing Field Mapping to Salesforce.
- Click Submit.
(Optional) Manage Additional Salesforce Integration Settings
- From the left navigation bar, go to
Settings > Integrated Systems > Integrations.
- Click Salesforce.
- Go to Settings tab.
-
Go to the desired section and click Edit. You can edit the following settings:
-
General Settings:
- To enable or disable the integration, toggle or untoggle the Active button.
-
If your Salesforce has a custom domain, click Edit and in the Custom Domain box, enter your Salesforce custom domain, and click Save. See the Salesforce article Enhanced Domains.
Tips:- For example, if your Salesforce URL is demandbase.my.salesforce.com, enter demandbase.
- If integrating with Sandbox, enter your Salesforce Sandbox Custom Domain. For example, if your Salesforce Sandbox URL is demandbase--demandbasetest.sandbox.my.salesforce.com, enter demandbase--demandbasetest
- To disable syncing currency specific data, click Edit, toggle off Sync Currency Fields, and click Save. The option is enabled by default and syncs currency data to support Analytics and Opportunities driven features.
- To export records from Demandbase One for Sales using the integration-user profile, toggle on Enable DB1S Export and Sync. See Configure Individual User Salesforce Integration.
- OAuth Settings: You can update integration user credentials. See Step 1: Authenticate.
- Filtering Rules: Filter accounts syncing with Demandbase. See Step 4: Account Filters (Select Salesforce Accounts).
-
General Settings:
-
Click Save.
Next Steps after Adding Salesforce Integration in Demandbase For Marketing
After successfully completing these steps, the Salesforce integration is set up and data starts syncing into Demandbase. Data is available according to the schedules described in Understanding Demandbase Data Availability.
Follow the instructions in Step 4: Add Demandbase Fields to Salesforce.