Salesforce Commerce Cloud

The Salesforce Commerce Cloud (SFCC) integration allows you to sync your data, engage customers at key moments, and personalize your messages.

  • Sync your customer, product, and behavioral data to Attentive with our best-in-class native integration with Salesforce Commerce Cloud.
  • Send automated high-performing SMS messages such as back-in-stock, low inventory, price drop, and more.
  • Segment customers based on past purchasing and browsing activity using product data such as name, category, tag, price, and other attributes.
  • Branch SMS messaging journeys using product attributes or inventory. For example, only send a back-in-stock message if the product is available.

Note: To learn more about how you can use product data in Attentive, see Use your product data in Attentive.

With this integration, you can:

  • Sync product catalog data from SFCC to Attentive at a frequency of your choosing.
  • Sync historical orders (also referred to as “past purchases”) from SFCC to Attentive.
  • Sync the following customer attributes to use for segmentation:
    • birthday
    • customerId
    • email
    • firstName
    • gender
    • lastName
    • phoneBusiness
    • phoneHome
    • phoneMobile
    • preferredLocale
    • primaryAddress
    • salutation
    • secondName
    • Suffix
    • Last logged in timestamp
    • Custom attributes
  • Take advantage of high-performing journeys:
    • Back in stock trigger
    • Low inventory trigger
    • Price drop trigger

This integration can also ensure the following events are tracked and can be used to trigger journeys or segment your customers:

  • Product view
  • Add to cart
  • Purchase

Prerequisites

Ensure that you meet the following requirements in order to set up this integration:

  • A Salesforce Commerce Cloud account

Limitations

  • You can only integrate with one SFCC storefront.
  • Your SFCC account must be on one of these versions: 19.10, 21.2, 22.7, or 22.10.
  • Your storefront can only integrate with one Attentive account.
  • If you use a single storefront for different domains instead of separate storefront sites for each of the domains, your product and image links won’t work. In this case you’ll need to make a change to your cartridge code in attentiveCatalogueDataSync.js to set the variant and image links according to whatever values you have set.
  • You can only import variants for products with images.

Now, complete the following steps to set up the integration for Salesforce Commerce Cloud and Attentive.

Step 1. Retrieve the Attentive LINK cartridge

Download the latest cartridge zip file here. This file contains the following cartridges, which are required for full functionality:

  • int_attentivemobile – Implements the core storefront functionality
  • bm_attentivemobile – Implements the Attentive Mobile Business Manager module for OAuth code
  • int_attentivemobile_sfra – Implements the storefront functionality with SFRA code
  • int_attentivemobile_controllers – Implements the storefront functionality with Site Genesis code

Note: Site Genesis and SFRA support is broken out into two separate cartridges, so your site only requires one of these: int_attentivemobile_sfra or int_attentivemobile_controllers. In the following procedures, we show the installation using int_attentivemobile_sfra. If your storefront uses Site Genesis, replace int_attentivemobile_sfra with int_attentivemobile_controllers.

Step 2. Add the cartridge to the Cartridges path

  1. Log in to your Salesforce Commerce Cloud Business Manager.
  2. Navigate to Administration > Sites > Manage Sites.
  3. Click the name of the site you want to integrate with Attentive.
  4. Select the Settings tab.
  5. Add int_attentivemobile_sfra:int_attentivemobile:app_storefront_base to the Cartridges path.
  6. Click Apply.
    sfcc1.png

Step 3. Add the cartridge to the Business Manager Cartridges path

  1. Navigate to Administration > Sites > Manage Sites.
  2. Click Manage the Business Manager site.
  3. Add bm_attentivemobile:int_attentivemobile to the Cartridges path.
    sfcc2.png

Step 4. Upload and import metadata

The Attentive cartridge contains the following defined jobs, services, and site preferences .xml files that you need to upload and import:

  • metadata/site-template/jobs.xml
  • metadata/site-template/services.xml
  • metadata/site-template/meta/custom-objecttype-extensions.xml
  • metadata/site-template/meta/system-objecttype-extensions.xml
  1. Import the operations metadata:
    1. Navigate to Administration > Operations > Import & Export.
    2. Under Import & Export Files, click Upload.
    3. Upload the jobs.xml and service.xml files listed above.
    4. Under Jobs, import the jobs.xml file.
    5. Under Services, import the services.xml file.
      sfcc3.png
  2. Import the site development metadata:
    1. Navigate to Administration > Site Development > Import & Export.
    2. Under Import & Export Files, click Upload.
    3. Upload the system-objecttype-extensions.xml and custom-objecttype-extensions.xml files listed above.
    4. Under Meta Data, import the system-objecttype-extensions.xml and custom-objecttype-extensions.xml files.
      sfcc4.png

Step 5. Configure your site’s Attentive preferences

  1. Navigate to your Business Manager home.
  2. Select the desired site from the tabs across the top of the page.
  3. Navigate to Merchant Tools > Site Preferences > Custom Preferences > AttentiveMobile.
  4. Fill out the settings, as shown in the table below.
  5. Click Save at the top of the page.
Setting Description Notes
Attentive Mobile Access Token Attentive Mobile access token that will be used for authentication on the storefront to transmit data to Attentive This will be filled in during the authentication flow.
Enable Attentive Mobile To enable/disable the Attentive cartridge Set to Yes
Enable Product View Event Collection To enable/disable product view collection from your website If you already have behavioral events (product view, add to cart, purchase) coming through your Attentive tag, set to no. Otherwise, set to yes.
Enable Purchase Event Collection To enable/disable purchase collection from your website If you already have behavioral events (product view, add to cart, purchase) coming through your Attentive tag, set to no. Otherwise, set to yes.
Enable Add To Cart Event Collection To enable/disable add to cart collection from your website If you already have behavioral events (product view, add to cart, purchase) coming through your Attentive tag, set to no. Otherwise, set to yes.
Attentive Mobile Client ID To store the Attentive Mobile app client id Set to: af21590a196b4b25b8083c518efcdb6b
Attentive Mobile Client Secret To store the Attentive Mobile client secret Set to: NRAXTBen613aLH1OoUaJnnBmSvy6Dj80
Attentive Mobile Alert Email Address To store the email address to which we are sending alerts in case of errors and also used for sending status of catalog upload Leave empty (This is a pretty noisy alert.)
Attentive Mobile Product Custom Attributes To Sync List of product custom attributes to sync in catalog upload through AttentiveMobile-CatalogueDataSync job Your discretion
Attentive Mobile Customer Custom Attributes To Sync List of customer custom attributes to sync Your discretion
Attentive Mobile Sync Customers Since How far the customers sync goes back Your discretion
Attentive Mobile Sync Orders Until If it is not blank, then filter any orders that are after that date This value should be set to when your tag went live on your site.
Attentive Mobile Sync Orders Since How far the historical orders sync goes back Your discretion. We recommend 1/1/2000.
Attentive Mobile Product Catalogue UploadID To store the product catalogue upload Id Leave blank. The product Data job will set this.
Attentive Mobile Master Catalog ID To store the master catalog Id that we want to upload through AttentiveMobile-CatalogueDataSync Job Set to your master catalog id.
Attentive Mobile Tag SDK URL Stores the Attentive Mobile tag SDK URL for frontend js script. If the tag is already installed on your site, leave this blank.
Only Validate Product Data Only Validate Product Data when AttentiveMobile-CatalogueDataSync job is executed When you’re testing product data, set this value to Yes. When you want to send all product data, set this value to No.

Step 6. Set service credentials

  1. In Business Manager, navigate to Administration > Operations > Services.
  2. Select the Credentials tab.
  3. Click New.
  4. Add the following new credential:
    • Name: AttentiveMobile.http.default.credentials
    • URL: https://api.attentivemobile.com/v1
  5. Click Apply.
    sfcc5.png

Step 7. Add the Business Manager module

  1. Navigate to Administration > Organization > Roles & Permission.
  2. Click Administrator.
  3. Select the Business Manager Modules tab.
  4. Select the site to which you want to add the module.
  5. Click Apply.
    sfcc6.png
  6. Search for the Attentive Mobile OAuth row.
  7. Check the Write column for that row.
  8. Click Update.
  9. Navigate to Merchants Tools > Products & Catalogs Section.
  10. Click Attentive Mobile OAuth.
  11. Click Install.
  12. Enter your Attentive username and password.
  13. Authorize permission by clicking Authorize.
    A confirmation message appears, and a new OAuth token is added to the site preference Attentive Mobile Access Token.
    sfcc7.png

Step 8. Schedule jobs

  1. Navigate to Administration > Operations > Jobs.
  2. Click the first Attentive job. (The Attentive jobs should all start with AttentiveMobile-.)
    sfcc8.png
  3. Select the Job Steps tab.
  4. Click the token next to Scope.
  5. Select the sites to which you want to assign this job and click Assign.
  6. Select the Schedule and History tab, and schedule the jobs as follows:
    • Schedule the CatalogDataSync, CatalogueIngestionStatusCheck, and CustomDataSync jobs to run at least once a day.
    • Schedule the OrderDataSync job to run every 15 minutes. The job will send 1,000 orders to Attentive per execution, or about 96,000 orders per day, until all orders between Attentive Mobile Sync Orders Since and Attentive Mobile Sync Orders Until have been downloaded into Attentive.
  7. Repeat this procedure for all four Attentive jobs.
    Your Salesforce Commerce Cloud account is now connected and configured to send data to Attentive.

Questions?

We’re here to help! Contact whiteglove@attentivemobile.com to ask about the Attentive + Salesforce Commerce Cloud integration.

Articles in this section

Was this article helpful?
0 out of 1 found this helpful