Skip to main content
All CollectionsIntegrationsSalesforce Commerce CloudSetup
Install the Salesforce Commerce Cloud cartridge for SFRA
Install the Salesforce Commerce Cloud cartridge for SFRA

Use the Dotdigital cartridge to integrate your Salesforce Commerce Cloud cartridge for SFRA.

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

Our certified cartridge for Salesforce Commerce Cloud is developed and integrated with Storefront Reference Architecture (SFRA). Use the cartridge to:

  • Save email addresses for sending newsletters
    Available on your website footer, checkout, and user registration.

  • Send transactional emails
    With transactional emails, you can send different email types. For example:

    • Registration

    • Profile updated

    • Password change request and confirmation

    • Order creation

    • Order shipment

  • Track abandoned carts
    Track the content of a cart and identify your customers by email address.

  • ROI and site tracking
    Track the journey of your contacts who access your storefront from marketing campaign links.

  • ROI value tracking
    Track customers when they pass orders from a campaign.

    Learn more about site ROI tracking in Using site ROI tracking.

Salesforce Commerce Cloud cartridge for SiteGenesis

Learn about our integration for Salesforce Commerce Cloud cartridge for SiteGenesis in Install the Salesforce Commerce Cloud cartridge for SiteGenesis.


Before you start

Things you need to know:

  • Cartridge limitations
    The cartridge integration is based on the SFRA demo store (v5.0.1) provided by Salesforce Commerce Cloud and works with compatibility mode 19.10. There are no locale limitations to this cartridge.

Important

To use the cartridge, you must have an active Dotdigital account.


1. Download the cartridge

  1. Select DOWNLOAD INTEGRATION to download to your local computer.

  2. Unzip the Dotdigital for Salesforce zip file.


2. Install the cartridge

Import the cartridge

  1. Import the int_dotdigital_sfra into the UXStudio workspace.

  2. Open UXStudio in Eclipse IDE.

  3. Select File > Import > General > Existing projects.

  4. Browse to your directory where the cartridge int_dotdigital_sfra is downloaded.

  5. Select Finish and then OK.

  6. Repeat the above steps for and import int_dotdigital_core.

Import metadata

  1. Find the folder site-template in the install package.

  2. Archive the folder to site-template.zip.

  3. Import the file by using Site Import & Export.

Configure the cartridge

  1. Modify the site path by going to Business Manager > Administration > Manage Sites.

  2. Add the cartridge name at the end of the path.

Configuration options

Terminology change

The table below references Address books. In Dotdigital, these have been renamed to Lists. To view your lists in Dotdigital, go to Audience > Lists.

Setting

Details

API Username

To find this information in Dotdigital, expand the User menu and go to Settings > Access > API Users.

API Password

To find this information in Dotdigital, expand the User menu and go to Settings > Access > API Users.

API Endpoint

To find this information in Dotdigital, expand the User menu and go to Settings > Access > API Users.

Account Region

Select the region for the Dotdigital account.

Address book for Registered User

The address book ID for capturing the registered user email ID.

Address book for Guest User

The address book ID for capturing guest user email IDs.

Enable ROI Tracking

Enable ROI tracking.

Enable Abandoned Cart

Enable an abandoned cart.

Tracking Profile ID

The web behaviour tracking profile ID.

Program ID

The ID of the Dotdigital program that sends out the abandoned cart email.

Cart Delay

The time (in minutes) that is set to delay sending an email.

Account Creation Campaign ID

The email template that's used to send an account creation email.

Account Edited Campaign ID

The account profile edited email campaign ID.

Password Change Request Campaign ID

The email template for sending password change request emails.

Password Changed Campaign ID

The email template for sending password change request emails.

Order Confirmation Campaign ID

The order confirmation campaign email ID.

Shipping Confirmation Campaign ID

The shipping confirmation campaign email ID.


3. Test your installation

Use this checklist to test your installation is set up correctly:

  • As a logged-in customer in your Salesforce Commerce Cloud storefront, check that the local storage DOTDIGITAL_AB_TRACKING exists.

  • Add or remove items from your cart and check that the local storage data is updated accordingly.


Disable the Dotdigital cartridge

There is no custom preference value available for disabling the Dotdigital integration. To disable the integration, remove the cartridges, int_dotdigital_sfra and int_dotdigital_core from the cartridge path.


Did this answer your question?