All Collections
Integrations
Salesforce Commerce Cloud
Setup
Install and set up the Salesforce Commerce Cloud connector
Install and set up the Salesforce Commerce Cloud connector

Install and set up the Salesforce Commerce Cloud connector.

Gareth Burroughes avatar
Written by Gareth Burroughes
Updated over a week ago

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 enrol 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

  1. Log in to your Demandware account management console, API Client section: https://account.demandware.com/dw/account/APIAdmin

  2. Select Add API Client

  3. Give your API client a display name and a password, whilst leaving the JWT and OpenID Connect fields as they are in their default state (with 'Default Scopes' set as 'mail'), and save them

    Demandware_add_API_client.png

  4. Once created, copy the generated API client ID and given password and go to the next step below


3. Connect your store in Dotdigital

  1. Log in to your Dotdigital account (if you haven't done so already)

  2. Enter your store URL.

    From April 2022, Salesforce Commerce Cloud are introducing changes which mean hyphenated host names will no longer be supported.

  3. 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).

  4. Enter the API client ID and password and select NEXT to authorise the connection.

    auth-connection.png

Finally, you need to set the API permissions at Shop and Data level in your store's Business Manager.

To do this:

  1. 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.

  2. 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.

  3. Select Authorise.


Enable subscriber synchronisation

To enable subscriber synchronisation, you need to create the 'Accepts Marketing' field in Salesforce Commerce Cloud.

  1. Go to Business Manager > Administration > Site Development > System Object Types > Profile > Attribute Definitions > New

  2. Set:

    • the ID as acceptsMarketing

    • set the display name as Accepts Marketing

    • set the value type as Boolean

  3. then select Apply.

  4. In the Attribute Grouping tab, set both the ID and name as Marketing and select Add.

  5. Select Edit next to your newly created grouping

  6. Set the ID as acceptsMarketing and select Add


Next steps

Did this answer your question?