Connect SAP Commerce Cloud to Intelligent Selling Services (ISS)


Abstract

Intelligent Selling Services for SAP Commerce Cloud (also known as ISS) is a cloud-native system that can capture and analyze contextual and behavioural data across customer journey with SAP Commerce Cloud systems, then provides real-time customer experience merchandising and personalization. A brief introduction to ISS can be found here.

In this blog post, I will walk you through the necessary steps to connect a SAP Commerce Cloud instance to an Intelligent Selling Services (for SAP Commerce Cloud, aka ISS) tenant.

Prerequisite

you should have:

  1. a provisioned ISS tenant with admin role access.
  2. a SAP Commerce Cloud running instant with a storefront (In this blog post, we use the standard accelerator as an example).

Set up a site

Please log into your provisioned ISS tenant and navigate to Administration | Site Management. (Please note, Admin role is required to perform this step)

navigate%20to%20Site%20Management

navigate to Site Management

Click on the “Create Site” button to create a new site. Fill in the necessary information according to the requirement.

Create%20a%20Site%20Wizard

Create a Site Wizard

Hit Create and the site is now created and being initialized (displayed as “Initializing…”). Wait until the initialization is done and the site’s status displays as “Active” like the other sites (if any). This usually takes 1-2 minutes, you can refresh the page to see the status change.

Site%20created%20and%20being%20initialized

Site created and being initialized

Connect a SAP Commerce Cloud instance

In the Administration | Site Management workspace, on the row of the created site, click on “SAP Commerce Cloud Configuration”.

ready%20to%20configure%20SAP%20Commerce%20Cloud

ready to configure SAP Commerce Cloud

Now you should be switched over to the SAP Commerce Cloud Configuration workspace, where 4 steps are required for the configuration:

4%20steps%20to%20configure%20the%20SAP%20Commerce%20Cloud%20Connection

4 steps to configure the SAP Commerce Cloud Connection

Step 1: checking the SAP Commerce Cloud required modules.

You will need 2 modules to be installed on your SAP Commerce Cloud:

There are 2 ways to install the required modules

  1. either install the standard cx recipe (recipe introduction here, and simple how-to install: here), it already contains the 2 modules’ extensions.
  2. or manually install the following extensions:required%20extensions%20for%20ISSdon’t forget to install the 2 listed addons: profiletagaddon and merchandisingaddon to your storefront.

Step 2: Create Integration Client

step%202%3A%20create%20integration%20client

step 2: create integration client

We’ll navigate to Clients workspace, and click on the Create Client button on the top right, and fill in the necessary information:

Create%20an%20Integration%20Client

Create an Integration Client

  • ID: unique client identifier without empty space, will be used later for configuration settings.
  • Name: descriptive name for the integration client.

After clicking on Add, a window is popped up and contains very important information:

Please%20note%20down%20the%20client%20ID%20and%20Secret

Please note down the client ID and Secret

As indicated by the message, please copy the value of the client id and client secret, this will be used as authentication data by SAP Commerce Cloud later in step 4. Especially the secret cannot be accessed again if the window is closed.

After creating the client, navigate back to the SAP Commerce Cloud Configuration workspace and continue with the step 3.

Step 3: Profile Tag configuration

tenant%20specific%20profiletag

tenant specific profiletag

The profile tag is tenant specific, therefore, please copy the value for use in the step 4 in the SAP Commerce Cloud Configuration workspace.

Please note:

  • the value only works for accelerator storefront.
  • for Spartacus, the configuration is a bit different and will be described in a different blog post or a microlearning video later.
  • for custom storefront, please make sure to read here and here, to configure your storefront to push appropriate objects to the Intelligent Selling Services event layer.

Step 4: Configure SAP Commerce Cloud

Step%204%3A%20Configuration%20SAP%20Commerce%20Cloud

Step 4: Configuration SAP Commerce Cloud

Click the “Click here to expand the ImpEx template” to see an automatically generated ImpEx template. We will need to adjust it to contain the specific values of your ISS tenant as well as the SAP Commerce Cloud instance.

Within the ImpEx, the parts that need to be adjusted are usually the macro definitions as shown below:

ImpEx%20Template%20to%20be%20adjusted

ImpEx Template to be adjusted

where:

After adjusting the ImpEx, go to your SAP Commerce cloud instance:

  1. import the adjusted ImpEx, e.g. in hac
  2. synchronize your product catalog and content catalog (the ones you specified in your ImpEx script)

Validate the events being collected

to check whether the connection is established, please following the steps below:

  1. open the storefront in your browser, grant the ISS tracking consent:Accept%20ISS%20Consent
  2. open the developer tool of your browser (e.g. in Firefox | Tools | Browser Tools | Web developer Tools), switch to Network tab:Open%20Web%20Developer%20Tool%20on%20FireFox
  3. perform any action that triggers sending data to ISS, e.g. click on a product to load the product detail page. Look for the POST request with the file name “clickstreamEvents”, and you should see the 201 created response, i.e. the data is successfully sent to ISS tenant.ISS%20event%20posted%20successfully

Last but not least

The blog post introduces how to connect SAP Commerce Cloud to Intelligent Selling Services, so that data can be sent from your SAP Commerce Cloud storefront to your ISS tenant.

Further blog posts will be conducted to describe how to use the collected data and configure the various recommendation possibilities on ISS as well as SAP Commerce Cloud.

If you want to know more?

Please take a look at the portal page of ISS:

https://help.sap.com/viewer/product/INTELLIGENT_SELLING_SERVICES/ 

Also pay attention to the up-coming blog post (e.g to follow me on SAP Community) and planned live session on SAP Learning Hub about ISS.

That’s it and thanks for reading 😉