SalesForce Commerce Cloud


Dengage's recent integration with Salesforce Commerce Cloud, a leading eCommerce platform, facilitates smooth communication and data exchange between SFCC's eCommerce features and Dengage's advanced engagement tools. This integration allows you to synchronize the following data from your SFCC account to CDMP:

  • Contacts
  • Orders
  • Products
  • Events (shopping cart, page view, wishlist, cart, order)

📘

The plugin is supported with Salesforce Storefront Architecture (SFRA)

Settings

SettingRequiredDescription
Dengage EnabledYesThis determines if any actions (backend events, frontend events, SDK injection, or cron jobs) will be run by the module or not.
This setting is there to be able to easily enable / disable the plugin for testing or other purposes. Turning this off will disable the integration and no events / data will be sent to the Dengage platform
Dengage Account IDYesThe Dengage Account ID - this is used to sync events from the backend to the Dengage platform
Dengage App GUIDYesThe Dengage App GUID - this is used to inject the SDK script on the frontend. Without this, the SDK script will not be loaded properly.
Dengage API UsernameYesThe username for the Dengage API User - should have permissions to read and write for Data Space and Transactional Push.
Dengage API PasswordYesThe password for the Dengage API User - should have permissions to read and write for Data Space and Transactional Push.
Dengage SDK ScriptYesThe Dengage SDK script to be added to the frontend for reporting events to the Dengage platform. The exact code that is pasted here is added to the frontend as it is (including the
Dengage Service Worker SnippetYesThe Dengage Service Worker to be added for enabling the service worker and web push functionality.

Installation

  1. Install the cartridges from the zipped file: “dengage_sfcc.zip” and add it to the cartridge path.

  2. Install the metadata from the zipped file: “dengage_metadata.zip”. This can be done by navigating to Administration > Site Development > Site Import & Export under the Business Manager.

  3. Add an alias for the worker file. This can be done by navigating to Merchant Tools > SEO > Aliases under the Business Manager. Add the following alias (change “your-host” to the domain that you are using):

    {
    "__version": "1",
      "your-host": [
        {
          "if-site-path": "/dengage-webpush-sw.js",
          "pipeline": "DengageServiceWorker-GetFile"
        }
      ]
    }
    
    
  4. Add the following line of code in the footer (typically pageFooter.isml) and on the checkout page (typically checkout.isml):

    <isinclude template="dengage/dengage_snippets" />
    
  5. Navigate to Merchant Tools > Site Preferences > Custom Preferences. Scroll down and open the preferences for dengage. Edit the values as per preferences and Dengage settings. Refer to the Settings Explained section in this document to understand what each setting is for. These steps need to be performed for each site that you want to enable Dengage for.

  6. Make sure that the IP addresses for your Salesforce server / instance are whitelisted in the Dengage CDMP platform.

  7. Run the following jobs once (for historical data sync) and once they succeed, enable the jobs to run as per the defined schedule:

    1. Dengage Products Export
    2. Dengage Customers Export
    3. Dengage Orders Export