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
- 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 functionalitybm_attentivemobile
– Implements the Attentive Mobile Business Manager module for OAuth codeint_attentivemobile_sfra
– Implements the storefront functionality with SFRA codeint_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
- Log in to your Salesforce Commerce Cloud Business Manager.
- Navigate to Administration > Sites > Manage Sites.
- Click the name of the site you want to integrate with Attentive.
- Select the Settings tab.
- Add
int_attentivemobile_sfra:int_attentivemobile:app_storefront_base
to the Cartridges path. - Click Apply.
Step 3. Add the cartridge to the Business Manager Cartridges path
- Navigate to Administration > Sites > Manage Sites.
- Click Manage the Business Manager site.
- Add
bm_attentivemobile:int_attentivemobile
to the Cartridges path.
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
- Import the operations metadata:
- Navigate to Administration > Operations > Import & Export.
- Under Import & Export Files, click Upload.
- Upload the
jobs.xml
andservice.xml
files listed above. - Under Jobs, import the
jobs.xml
file. - Under Services, import the
services.xml
file.
- Import the site development metadata:
- Navigate to Administration > Site Development > Import & Export.
- Under Import & Export Files, click Upload.
- Upload the
system-objecttype-extensions.xml
andcustom-objecttype-extensions.xml
files listed above. - Under Meta Data, import the
system-objecttype-extensions.xml
andcustom-objecttype-extensions.xml
files.
Step 5. Configure your site’s Attentive preferences
- Navigate to your Business Manager home.
- Select the desired site from the tabs across the top of the page.
- Navigate to Merchant Tools > Site Preferences > Custom Preferences > AttentiveMobile.
- Fill out the settings, as shown in the table below.
- 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
- In Business Manager, navigate to Administration > Operations > Services.
- Select the Credentials tab.
- Click New.
- Add the following new credential:
- Name: AttentiveMobile.http.default.credentials
- URL: https://api.attentivemobile.com/v1
- Click Apply.
Step 7. Add the Business Manager module
- Navigate to Administration > Organization > Roles & Permission.
- Click Administrator.
- Select the Business Manager Modules tab.
- Select the site to which you want to add the module.
- Click Apply.
- Search for the Attentive Mobile OAuth row.
- Check the Write column for that row.
- Click Update.
- Navigate to Merchants Tools > Products & Catalogs Section.
- Click Attentive Mobile OAuth.
- Click Install.
- Enter your Attentive username and password.
- Authorize permission by clicking Authorize.
A confirmation message appears, and a new OAuth token is added to the site preference Attentive Mobile Access Token.
Step 8. Schedule jobs
- Navigate to Administration > Operations > Jobs.
- Click the first Attentive job. (The Attentive jobs should all start with
AttentiveMobile-
.) - Select the Job Steps tab.
- Click the token next to Scope.
- Select the sites to which you want to assign this job and click Assign.
- Select the Schedule and History tab, and schedule the jobs as follows:
- Schedule the
CatalogDataSync
,CatalogueIngestionStatusCheck
, andCustomDataSync
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.
- Schedule the
- Repeat this procedure for all four Attentive jobs.
Your Salesforce Commerce Cloud account is now connected and configured to send data to Attentive.
Step 9 (optional): Collect email marketing subscribers at checkout
If you want to collect email marketing subscribers at checkout, follow these steps to enable this feature in SFCC:
- In the Enable OptIn subscription checkbox in checkout dropdown, select Yes.
- Work with your CSM to get a new integration sign-up unit created.
- Paste the sign-up unit ID in the Attentive Signup Source Id field.
Questions?
We’re here to help! Contact whiteglove@attentivemobile.com to ask about the Attentive + Salesforce Commerce Cloud integration.