Home
Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
Operating
Topics in the Operating category highlight tasks that are typically performed by business users, customer support representatives, to complete their day-to-day tasks in the operation of the HCL Commerce site.
Management Center for HCL Commerce
The Management Center for HCL Commerce, is a suite of tools to support store management, merchandising, and marketing tasks for business users (Sellers, Marketing Managers, Product Managers, Catalog Managers, and others).
Marketing tool
Use the Marketing tool in Management Center to create and manage marketing campaigns and other store content, excluding catalog content. You can use the extensive precision marketing features in the tool to deliver targeted marketing messages to customers.
Managing web and dialog activities
Web and dialog activities are used to deliver brand or promotional messages to customers through a variety of methods.
Activity building blocks: triggers, targets, and actions
When you build a marketing activity by using the Activity Builder, your building blocks are triggers, targets, and actions. These building blocks are represented as icons, or elements, in the palette. You select elements from the palette and place them in a precise order along a flow that represents the marketing activity.
Targets in marketing activities
Use a target to personalize a web or dialog activity so that the activity applies only to certain customers. To include a target in an activity, drag the target from the palette into the activity flow in the Activity Builder. Place the target to the left of the action element that you want to target.
Target: Cookie Contents
Use this target in web activities to target customers whose current session has a cookie from your site that contains certain values. You can personalize content in an e-Marketing Spot according to the customer's cookie values.
Enabling the Cookie Contents target
In order to use the Cookie Contents target in marketing Web activities, modify the front end storefront code to process the required cookies and pass them to the marketing engine. This additional code retrieves the specified cookie name and value for each customer who views the page and passes these parameters to the marketing services. The marketing services will display the targeted marketing content to the customer if the cookie name and value matches the criteria set for the target in the Web activity.
… in JSP-based stores
In order to use the Cookie Contents target in web activities, you must modify the JavaServer Page (.JSP) file for the e-Marketing Spot widget.

Documentation
HCL Commerce is a high-availability, highly scalable and customizable e-commerce platform. Able to support hundreds of thousands of transactions per day, HCL Commerce allows you to do business with consumers (B2C) or directly with businesses (B2B). HCL Commerce uses cloud friendly technology to make deployment and operation both easy and efficient. It provides easy-to-use tools for business users to centrally manage a cross-channel strategy. Business users can create and manage precision marketing campaigns, promotions, catalog, and merchandising across all sales channels. Business users can also use AI enabled content management capabilities.
- Getting started
  HCL Commerce has different advantages for business users, administrators and developers. HCL Commerce targets each of these roles with a tailored set of offerings so that each of your users can get maximum benefit.
- Installing and deploying
  Learn how to install and deploy HCL Commerce development environments and HCL Commerce production environments.
- Migrating
  Before you migrate to HCL Commerce Version 9, review this information to help plan and execute your migration.
- Operating
  Topics in the Operating category highlight tasks that are typically performed by business users, customer support representatives, to complete their day-to-day tasks in the operation of the HCL Commerce site.
  - Management Center for HCL Commerce
    The Management Center for HCL Commerce, is a suite of tools to support store management, merchandising, and marketing tasks for business users (Sellers, Marketing Managers, Product Managers, Catalog Managers, and others).
    - Management Center keyboard shortcuts
      Use the Management Center keyboard shortcuts to access user interface functions or complete tasks, using a single key or combination of keys.
    - Working in extended site stores in Management Center
      If your company operates an extended site, you can perform certain tasks directly from your extended site store within Management Center.
    - Manage content externally for use in Management Center
      If content management capabilities other than the functionality that is provided by default with HCL Commerce is required, HCL Commerce can be integrated with IBM Web Content Manager. If HCL Commerce is integrated with IBM Web Content Manager, you can use content from IBM Web Content Manager content libraries with Management Center objects.
    - Management Center user interface
      The Management Center user interface provides a usable, intuitive, and efficient way to complete your business tasks.
    - Using the Management Center
      The starting point for all Management Center tasks is to open the tooling. Afterward, you can use several methods to complete a task: by selecting menu options, by clicking toolbar buttons, by right-clicking and selecting menus, or by keyboard shortcuts.
    - Catalogs tool
      Use the Catalogs tool in Management Center to manage catalogs, categories, catalog entries, merchandising associations, product attributes, and attachments in your store. The Catalogs tool lets business users create, and manage online catalogs. Catalogs provide a way of organizing the products that you want to sell. You define catalog data in groups of categories and products. Catalog data contains descriptions and pricing information for products and services.
    - Marketing tool
      Use the Marketing tool in Management Center to create and manage marketing campaigns and other store content, excluding catalog content. You can use the extensive precision marketing features in the tool to deliver targeted marketing messages to customers.
      - Managing web and dialog activities
        Web and dialog activities are used to deliver brand or promotional messages to customers through a variety of methods.
        Web activities
        Create web activities to schedule and control the information that displays in e-Marketing Spots or Commerce Composer widgets on your store pages. When a customer views a store page, the web activity determines what to show the customer. You can target specific sets of customers with personalized and relevant content.
        Dialog activities
        Create dialog activities when you want to automate marketing actions based on the specific behavior of your customers. Think of a dialog activity as an interactive dialog with a customer: you wait for the customer to do something, and then you respond with an email or a coupon, or some other planned marketing action. This dialog can be ongoing as the customer's behavior on your site changes over time.
        Creating a web activity
        Create a web activity to display marketing information in an e-Marketing Spot on a store page. You can also define targets in web activities to personalize the marketing information. Creating web activities ensures that brand and promotional messages are seen by the right customers.
        Creating a web activity that displays catalog entries
        You can create a web activity that displays one or more catalog entries (products, SKUs, bundles, or kits) in an e-Marketing Spot on a store page. For example, you can display featured products, cross-sells, up-sells, best-selling or top-browsed products, or a list of a customer's recently viewed products.
        Creating a web activity that displays categories
        You can create a web activity that displays one or more categories in an e-Marketing Spot on a store page. For example, you can display featured categories or a list of a customer's recently viewed categories.
        Creating a web activity that displays content
        You can create a web activity that displays images, text, or static HTML in an e-Marketing Spot on a store page. For example, you can display an ad for a store promotion, or some information about an upcoming store event.
        Creating a web activity that displays IBM Product Recommendations
        If your company subscribes to , you can create a web activity that displays the product recommendations that are generated by IBM Product Recommendations.
        Creating a dialog activity
        Create dialog activities to market to customers when they do something specific or when an event occurs. First, you define a trigger for the dialog activity, for example, when a customer registers or places an order. You then define the action to take, for example, sending an email to the customer or adding the customer to a customer segment. You can also define targets in dialog activities to limit the marketing actions to specific customers.
        Activity building blocks: triggers, targets, and actions
        When you build a marketing activity by using the Activity Builder, your building blocks are triggers, targets, and actions. These building blocks are represented as icons, or elements, in the palette. You select elements from the palette and place them in a precise order along a flow that represents the marketing activity.
        Triggers in dialog activities
        Triggers define the event that causes your dialog activity to start or continue. Use triggers to wait for a customer to do something, for an event to occur, or for time to elapse. To include a trigger in a dialog activity, drag the trigger from the palette into the activity flow in the Activity Builder.
        Targets in marketing activities
        Use a target to personalize a web or dialog activity so that the activity applies only to certain customers. To include a target in an activity, drag the target from the palette into the activity flow in the Activity Builder. Place the target to the left of the action element that you want to target.
        Target: Customer Segment
        Use this target in web and dialog activities, and in search rules, to target customers who belong to specific customer segments. By using the Customer Segment target, you can personalize marketing activities and search rules so that they are more relevant to the target audience.
        Target: Shopping Cart
        Use this target in web and dialog activities, and in search rules, to target customers whose current shopping cart contents meets certain criteria. You can specify more criteria that are related to the quantity and value of the catalog entries, and the time frame during which they were placed in the cart.
        Target: Purchase History
        Use this target in web and dialog activities, and in search rules, to target customers whose purchase history with your site meets certain criteria. You can build purchase history scenarios around the orders a customer placed or the items a customer purchased. You can specify more criteria related to quantities purchased, money spent, and the time frame for the purchases.
        Target: Current Page
        Use this target in web activities to target customers who are currently viewing a specific page of your store. For example, the page can be a display page for a specific part of your catalog or a search results page for a specific keyword search. You can then use the e-Marketing Spots on that page to display something relevant to the customer. In this way, you can personalize the marketing content that customers see according to their specific interests.
        Target: Catalog Browsing Behavior
        Use this target in web and dialog activities, and in search rules, to target customers who browsed specific parts of your store catalog while shopping on your site over time. For example, if a customer repeatedly browsed certain categories, that customer is a prime target for advertisements or promotions for those categories.
        Target: Online Behavior
        Use this target in web and dialog activities, and in search rules, to target customers whose recorded behavior while shopping on your site over time meets certain criteria. The recorded behavior of your customers can provide you with important clues about their interests. You can use these clues to personalize marketing messages.
        Target: External Site Referral
        Use this target in web activities and search rules to target customers who entered your site from a link on a specific external site.
        Target: Cookie Contents
        Use this target in web activities to target customers whose current session has a cookie from your site that contains certain values. You can personalize content in an e-Marketing Spot according to the customer's cookie values.
        Enabling the Cookie Contents target
        In order to use the Cookie Contents target in marketing Web activities, modify the front end storefront code to process the required cookies and pass them to the marketing engine. This additional code retrieves the specified cookie name and value for each customer who views the page and passes these parameters to the marketing services. The marketing services will display the targeted marketing content to the customer if the cookie name and value matches the criteria set for the target in the Web activity.
        … in JSP-based stores
        In order to use the Cookie Contents target in web activities, you must modify the JavaServer Page (.JSP) file for the e-Marketing Spot widget.
        ***
        Target: Social Commerce Participation
        Use this target in Web and Dialog activities and search rules to target customers who participated in social commerce on your site a specified number of times.
        Target: Social Commerce Participation
        Use this target in web and dialog activities to target customers who have participated in social commerce on your site a specified number of times. You can target specific types of social commerce activity, such as creating a product review or uploading a photo. You can also apply activity filters to further define the social commerce activity, for example, by the star rating or category.
        Target: Day and Time
        Use this target in web and dialog activities, and in search rules, to specify the days of the week and times of day that an activity is active. For example, if you want to display an ad only on Fridays between 9 and 11 AM, you can add this target to the Web activity and set the schedule accordingly.
        Target: Promotion Checker
        Use this target in web activities to check whether a catalog entry that a customer is currently viewing qualifies for a promotion you specify. If the catalog entry does qualify, you can display an ad for the promotion in an e-Marketing Spot associated with the catalog entry. This is a great way to visually connect a promotion to a specific catalog entry on your storefront.
        Target: Search Criteria and Result
        Use this target in web activities and search rules to target customers whose search results include specific catalog entries, or who have searched using specific search filters on their search results.
        Actions in marketing activities
        Actions define what to do, based on the previous sequence of triggers and, optionally, targets in the activity flow. To include an action in a marketing activity, drag the action from the palette into the work area of the Activity Builder.
        Using the branch element in web and dialog activities
        Add the branch element to a web or dialog activity if you want to split a single path in the activity into multiple paths. Each path can then contain different triggers, targets, and actions within the same activity. You can also add more paths, delete branch elements, and nest branch elements within existing branch elements.
        Activating or deactivating an activity
        Activities can exist in the store in two states; active or inactive. You must activate an activity to make it perform its function for your store. For example, you must activate a web activity to make it display content in e-Marketing Spots on your store pages. You can edit inactive activities only.
        Testing web and dialog activities
        Test web and dialog activities on a testing server to ensure they produce the right result before moving the activities to the production environment.
        Browsing for activities using lists and calendars
        You can browse for activities in the Management Center using several methods.
        Changing a web activity
        You can update your Web activities to correct errors, raise or lower the priority relative to other activities, or to realign dates.
        Changing the priority of a Web activity
        You can change the priority of a Web activity relative to other Web activities. When multiple activities are scheduled for the same e-Marketing Spot, the Web activity with the higher priority is displayed first.
        Viewing the web activities scheduled for an e-Marketing Spot
        You can view all of the web activities currently scheduled to display in a selected e-Marketing Spot in a list or calendar view. Use these views to resolve conflicts when multiple activities are scheduled to an e-Marketing Spot concurrently.
        Changing a dialog activity
        Change your dialog activities to correct errors, change the priority relative to other activities, or to realign dates.
        Deleting activities
        Deleting your activities removes completed or inactive activities from the Management Center.
        Comparison of web activities and dialog activities
        You can use the Activity Builder in the Marketing tool to build both web activities and dialog activities. To decide which type of activity you need, consider the purpose of your activity.
        Activity Builder
        The Activity Builder presents a graphical interface where you can create web and dialog activities.
        Branches in marketing activities
        A branch element is an element you can add to a web or dialog activity to split a single path into two or more paths. When a customer experiencing the activity reaches the branch element, the customer proceeds down one or more of those paths based on criteria that you define. As a result, a single activity can have multiple outcomes, and you can target each outcome to a different set of customers.
        Differences between the branch element and the experiment element
        The palette in the Activity Builder contains two elements in the Branching section: the branch element and the experiment element. These two elements are similar in that you can add them to marketing activities to split a single path into multiple paths; however, these two elements have different uses and they offer different features.
        Best practices for web and dialog activities
        Review these best practices for creating web and dialog activities so that you can learn ways to manage activities more easily and reduce storefront performance impacts.
      - Managing email activities
        Email activities are managed by Marketing Managers to keep a site's targeted marketing efforts organized.
      - Managing marketing experiments
        Marketing experiments are managed by Marketing Managers. They are used to test the effectiveness of brand or promotional messages on the web.
      - Managing custom activity templates
        To save time, create custom activity templates to use as a starting point for creating web and dialog activities.
      - Managing activity statistics
        The Marketing tool gathers and displays various types of statistical data about your web, dialog, and email activities.
      - Managing marketing content
        Marketing content is managed by marketing managers. It is used to deliver marketing messages to customers, as part of campaign activities.
      - Managing customer segments
        Marketing Managers create customer segments to use as targets for marketing campaigns and promotions.
      - Managing e-Marketing Spots
        Marketing Managers create and manage e-Marketing Spots, to ensure that store pages are filled with relevant and compelling images and information.
      - Managing feeds for e-Marketing Spots
        For e-Marketing Spots, feeds provide a means to syndicate marketing information for display in feed readers.
      - Managing email templates
        Email templates, managed by Marketing Managers, are the basis of email activities delivered to customers.
      - Working with campaigns
        Campaigns are managed by Marketing Managers, in order to keep a store's marketing activities organized.
      - Managing search rules
        Search rules provide a means to deliver customized search results and ordering when customers search the storefront.
      - Managing search rule experiments
        Search rule experiments are managed by Marketing Managers. They are used to test the effectiveness of search rules.
      - Organizing marketing objects with folders
        You can use the Management Center Marketing tool to create and manage folders for organizing your marketing content, customer segments, activities, and e-Marketing Spots. By using marketing folders to group and organize your marketing objects you can simplify browsing for and managing your marketing objects.
      - Frequently asked questions (FAQ)
        Find answers to some frequently asked questions about using key features of the Marketing tool and completing tasks.
      - Troubleshooting
        If you encounter issues while you are using the Marketing tool, review troubleshooting information to solve common problems.
    - Promotions tool
      Use the Promotions tool in Management Center to create and manage promotions that support the marketing campaigns for your site.
    - Attachments tool
      As a Product Manager, Marketing Manager, or Category Manager, you can use the Attachments tool to manage URLs that point to marketing image files, catalog image files, PDF documents, and multimedia files that you use in marketing campaigns.
    - Catalog Filter and Pricing tool
      Use the Catalog Filter and Pricing tool in Management Center to create and manage catalog filters, price lists, and price rules. Sellers, Sales Managers, and Account Representatives can use the tool's flexible features to implement catalog filtering and pricing strategies that meet the site's business needs over time.
    - Installments tool
      Use the Installments tool in Management Center to create and manage installment rules that support the payment methods for your site.
    - Commerce Composer tool
      Create pages and build layouts for your store directly in Management Center without involving IT by using the Commerce Composer tool. Take advantage of the tool's page design and management functions to improve your productivity and give you more control over the customer experience.
    - Store Management tool
      As a Seller, Site Administrator, or Channel Manager, you can use the Store Management tool in Management Center to manage your stores. The Store Management tool in Management Center replaces all of the store management features in HCL Commerce Accelerator, except store creation and the ability to suspend and resume stores.
    - Workspace Management tool
      The Workspace Management tool is a graphical user interface tool that is used to manage workspaces and workspace-related activities. It provides a single view across all workspaces and all tasks in the workspaces where managers can see how work is progressing.
    - Previewing a store
      Preview your store to ensure that changes made in Management Center show up in your store as expected. You can use store preview in production, authoring, and staging environments.You can use store preview within the authoring instances for any of your environments. Do not use store preview within the live instance of your HCL Commerce on Cloud environments.
    - Management Center frequently asked questions (FAQ)
      Find answers to some of the most frequently asked questions about the Management Center.
    - Management Center Troubleshooting
      If you encounter issues with the Management Center that are not related to any specific tool, review this troubleshooting topic to solve common problems.
  - HCL Commerce Accelerator
    Use the HCL Commerce Accelerator to maintain online stores.
  - HCL Customer Service for HCL Commerce JSP stores
    HCL Customer Service for HCL Commerce provides customer service enhancements that enable a customer service representative (CSR) to resolve common issues and capture orders. These capabilities are built into the HCL Commerce Aurora storefront and enable a CSR to complete key tasks on behalf of a guest and registered customers for both B2B and B2C stores. Customer Service for HCL Commerce is offered for both Professional and Enterprise editions.
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
- Administering
  Topics in the Administering category highlight tasks that are typically performed by the Site Administrator, to support daily operations of the HCL Commerce site.
- Customizing
  The topics in the Customizing section describe tasks performed by an application developer to customize HCL Commerce.
- Tutorials
  HCL Commerce provides many tutorials to help you customize and understand your HCL Commerce instance and stores.
- Samples
  Topics in the Samples category highlight the various samples that are provided with HCL Commerce.
- Compliance
  The following section describes how you can leverage HCL Commerce features and functionality to help your site be compliant with different privacy and security standards.
- Securing
  These topics describe the security features of HCL Commerce and how to configure these features.
- Performance
  Topics in the Performance section describe the means by which to plan, implement, test, and re-visit the optimization of HCL Commerce site performance.
- Troubleshooting
  Topics in the Troubleshooting section highlight common issues that are encountered with HCL Commerce, and how they can be addressed or mitigated.
- Reference
  Topics in the Reference section contain all of the HCL Commerce reference documentation.

Enabling the Cookie Contents target in JSP-based stores

In order to use the Cookie Contents target in web activities, you must modify the JavaServer Page (.JSP) file for the e-Marketing Spot widget.

Procedure

Find the name and location of the JSP file for the e-Marketing Spot used in the web activity.
Note:
- For espots that use the Commerce Composer widgets, the espot widget code itself can be modified as follows:
```
crs-web\WebContent\Widgets_801\com.ibm.commerce.store.widgets.EMarketingSpot\EMarketingSpot_Data.jspf
```
- While this default code can be customized for testing purposes, it is advised to follow the process for customizing an existing widget as mentioned in Customizing an existing widget.
- For espots that use the webservice based WebServiceeMarketingSpotDisplay.jsp file, refer to Adding an e-Marketing Spot to a JSP store page
Open the JSP file for the e-Marketing Spot in which you plan to display the targeted marketing content in any editor tool.
Locate the </wcf:getData> or </wcf:rest> tag.
Add a line of code to the e-Marketing Spot JSP file to pass the cookie name and value to the marketing services within the tag.
For example, if the name of the cookie is ZIPCODE, then the line of code will be:
```
<wcf:param name="ZIPCODE" value="${cookie.ZIPCODE.value}" />
```
Alternatively, you can add lines of code to the JSP file to pass all cookie names and values to the marketing services; however, this is not the preferred method because a large amount of unnecessary data is passed. For this method, the lines of code to add to the e-Marketing Spot JSP file look like this:
```
<c:forEach var="cookieEntry" items="${cookie}">
    <wcf:param name="${cookieEntry.key}" 
		        value="${cookieEntry.value.value}" />		
</c:forEach>
```
Save and close the JSP file.

Results

You can now use the Cookie Contents target in web activities for the JSP-based store.