Our integration with Salesforce Commerce Cloud includes two components that work together:
A Dotdigital connector to sync all the commerce data powering our Commerce intelligence (using OCAPI).
An officially certified SFCC cartridge that pre-installs the Dotdigital tracking and transactional email capability.
This integration allows you to synchronise your store customers' information and purchase data as well as your product catalogue. You can choose which of your Commerce Cloud data fields get mapped to your Dotdigital contact data fields, allowing you to utilise their order information for better campaign targeting. You can also enroll new customer accounts and first-time buyers into your programs.
Install the Salesforce Commerce Cloud connector
1. Install the cartridge
To start your installation, select the guide you need to use:
2. Create a Demandware API client
Log in to your Demandware account management console, API Client section: https://account.demandware.com/dw/account/APIAdmin.
Select Add API Client.
Give your API client a display name and a password.
Leave the JWT and OpenID Connect fields as they are in their default state (with Default Scopes set as
mail), and save them.
Once created, copy the generated API client ID and given password and go to the next step.
3. Connect your store in Dotdigital
Log in to your Dotdigital account (if you haven't done so already).
Enter your store URL.
From April 2022, Salesforce Commerce Cloud are introducing changes which mean hyphenated host names will no longer be supported.
Enter your site ID. To find your site ID, go to Administration > Sites > Manage Sites and copy the ID of the site you wish to connect to.
If connecting multiple storefronts to the same Dotdigital account you'll need to append the Site ID to the Store URL (https://www.example.com/s/site_id_here).
Enter the API client ID and password and select NEXT to authorise the connection.
Finally, you need to set the API permissions at Shop and Data level in your store's Business Manager.
To do this:
Copy the JSON for the Shop permission and paste it into your instance's Business Manager under Administration > Site development > Open Commerce API settings. Select type Shop and set the context to Global.
Copy the JSON for the Data permission and paste it into your instance's Business Manager under Administration > Site development > Open Commerce API settings. Select type Data and set the context to Global.
Select Authorise.
Enable subscriber synchronisation
To enable subscriber synchronization, create the acceptsMarketing field in Salesforce Commerce Cloud. This field checks if a contact is included in mapped lists, such as subscriber or customer lists, to determine if they are subscribed.
Go to Business Manager > Administration > Site Development > System Object Types > Profile > Attribute Definitions > New.
Set:
the ID as
acceptsMarketingset the display name as
Accepts Marketingset the value type as Boolean
Select Apply.
In the Attribute Grouping tab, set both the ID and name as Marketing and select Add.
Select Edit next to your newly created grouping.
Set the ID as acceptsMarketing and select Add.
Next steps