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.
Integrating
Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
Analytics for HCL Commerce
HCL Commerce provides a framework that you can configure to integrate your store with an external Web analytics solution. This framework includes a tag library that you can use in store page JSP files to provide appropriate analytics information to the external analytics system.
Analytics tag library for HCL Commerce
The basis for the HCL Commerce analytics framework is a JSP-based tag library. By adding HCL Commerce analytics tags to your store pages, you can communicate information about site usage to an external analytics system.
Generic tag
The generic tag is available for use as a pass-through tag to communicate additional information about site usage to an external analytics system. This tag can be used for customization, or to forward information to the vendor tags that are not currently supported in the tag library the vendor provides to support web analytics for HCL Commerce.
Using the generic tag with IBM Digital Analytics
If your site is integrated with IBM Digital Analytics, you can use the default implementation of the <cm:generic /> tag that HCL Commerce provides; however, this tag does not currently map to any IBM Digital Analytics data tags. The generic tag can be used for customization, or to forward information to IBM Digital Analytics that the existing IBM Digital Analytics data tags do not support.

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.
- Integrating
  Topics in the Integrating category highlight the tasks that are commonly performed for using HCL Commerce in combination with other products.
  - Order management system integration
    Integrate a distributed order management (DOM) system with your store to provide comprehensive coverage of the order lifecycle across channels, from capture to fulfillment.
  - Sterling Order Management integration
    The integration between HCL Commerce and Sterling Order Management combines the industry-leading front-end capabilities of HCL Commerce with the proven, back-end order and inventory management features of Sterling Order Management.
  - Inventory Management system integration
    Integrate an inventory management system with your store to ensure that inventory availability is constantly updated to reflect your store's current inventory levels.
  - Payments system integration
    Integrate a payments system with your store to process shopper payments for your site. You can also integrate with pricing and tax service providers to manage the pricing and tax calculations for your store.
  - Tax system integration
    You can integrate HCL Commerce with a third-party tax calculation system to provide tax calculations for your store. Integrating with a third-party tax service provider can help you to build and maintain a highly secure e-commerce site with a worldwide tax calculation process. Use the available HCL Commerce tax integration extension points to create any extensions that you need for integrating with your third-party tax calculation system. The tax integration xC extensions are a set of task commands that are called by the order component to communicate with the third-party tax calculation system when the tax integration feature is enabled.
  - Integrating with back-end systems and external applications
    External systems integration is a key feature of the HCL Commerce solution. In HCL Commerce business logic is enabled for integration and built-in adapters and interfaces are provided for common integration points. Additionally, the HCL Commerce integration solution leverages integration standards by using various IBM connectivity solutions.
  - IBM Watson Campaign Automation integration
    You can integrate IBM Watson Campaign Automation with HCL Commerce so that transactional emails are sent by IBM Watson Campaign Automation.
  - IBM MQ
    HCL Commerce provides a listener for IBM MQ for inbound requests, and an adapter for IBM MQ for outbound requests, to integrate back-end, and external systems with HCL Commerce.
  - Content management integration
    You can integrate HCL Commerce with an external content management system through a punch-out window from Management Center and through the web feed utility. You can integrate HCL Commerce with IBM Web Content Manager to provide Management Center users the ability to associate IBM Web Content Manager content with HCL Commerce objects.
  - Analytics for HCL Commerce
    HCL Commerce provides a framework that you can configure to integrate your store with an external Web analytics solution. This framework includes a tag library that you can use in store page JSP files to provide appropriate analytics information to the external analytics system.
    - Analytics tag library for HCL Commerce
      The basis for the HCL Commerce analytics framework is a JSP-based tag library. By adding HCL Commerce analytics tags to your store pages, you can communicate information about site usage to an external analytics system.
      - Page view tag
        The HCL Commerce page view tag collects information about store pages that a customer viewed.
      - Order tag
        The HCL Commerce order tag collects information about a customer's order. The order tag creates two data sets: one for the shopping cart contents at the time of the order and the other for the order summary information.
      - Shopping cart tag
        The HCL Commerce shopping cart tag collects details about the items a customer has in the shopping cart.
      - Product tag
        The HCL Commerce product tag collects details about the products a customer has viewed.
      - Registration tag
        The HCL Commerce registration tag collects registration data for a customer that is logged in to the store.
      - Campaign tag
        The HCL Commerce campaign tag tracks impressions and clickthrough for web and email marketing campaign activities that use e-Marketing Spots.
      - Conversion event tag
        The HCL Commerce conversion event tag collects information about events that are not directly related to product purchases. These events might include using a store locator, using a product comparison tool, adding items to a wish list, signing up for a gift registry, downloading documents, visiting the contact us page, and more.
      - Element tag
        The HCL Commerce element tag tracks customer interactions with content within a page, or page elements. In HCL Commerce starter stores, these elements include the product fast finder, and the faceted navigation on category and search result pages. Other examples of elements include search and news portlets, video plays, and Ajax detail hovers for products or customer reviews.
      - Generic tag
        The generic tag is available for use as a pass-through tag to communicate additional information about site usage to an external analytics system. This tag can be used for customization, or to forward information to the vendor tags that are not currently supported in the tag library the vendor provides to support web analytics for HCL Commerce.
        Using the generic tag with IBM Digital Analytics
        If your site is integrated with IBM Digital Analytics, you can use the default implementation of the <cm:generic /> tag that HCL Commerce provides; however, this tag does not currently map to any IBM Digital Analytics data tags. The generic tag can be used for customization, or to forward information to IBM Digital Analytics that the existing IBM Digital Analytics data tags do not support.
      - Passing extra data to IBM Digital Analytics with the extraparms parameter
        You might want to pass more data to IBM Digital Analytics that is not collected automatically by the HCL Commerce analytics tags. For example, you might want to pass information about the brand of the products customers view for a IBM Digital Analytics explore report, or pass specific registration data for a custom report in IBM Digital Analytics. If so, use the extraparms parameter in the HCL Commerce analytics tag when you place the tag in your store page.
      - Syntax for passing JavaScript variables as extra parameters
        You can pass a JavaScript variable as an extra parameter to any of the tags for IBM Digital Analytics.
      - Comparison of extra parameters for IBM Digital Analytics tags
        The HCL Commerce order tag (<cm:order />) and shopping cart tag (<cm:cart />) support multiple parameters that you can use to pass additional data to IBM Digital Analytics. Those parameters are extraparms, extraparmsMap, and orderExtraparms (orderExtraparms is applicable only to the order tag). It is important to understand which parameter to choose so that you get the results that you expect in the generated IBM Digital Analytics data tags.
    - Integrating a store with IBM Digital Analytics for HCL Commerce
      HCL Commerce provides a framework and tools to simplify the process of setting up your site to use . IBM Digital Analytics is an industry leading hosted web analytics solution. The framework is implemented as a tag library designed to act as an intermediary layer between HCL Commerce and IBM Digital Analytics. The tools include an auto tagging utility to place analytics tags in your store pages. The tools also include a utility to generate a file that contains your catalog hierarchy for IBM Digital Analytics. This solution can significantly reduce the time that is required to deploy web analytics
    - Integrating a store with an external analytics system (other than IBM Digital Analytics)
      To meet your analytics requirements, you can integrate an HCL Commerce store with any web-based analytics system that uses a JavaScript based tagging mechanism. For this purpose, HCL Commerce provides an extensible JSP-based tag library framework for analytics.
    - Integrating a store with multiple analytics providers
      HCL Commerce provides you with the option to use multiple analytics providers for one store, allowing for greater data collection and accuracy of shopper activity. As a result, you can compare and analyze multiple sets of data from different analytics providers.
  - IBM Product Recommendations and HCL Commerce
    IBM Product Recommendations is an IBM Digital Analytics solution that you can subscribe to that automatically generates personalized product recommendations on the storefront. The recommendations are based on the browsing, shopping, and purchasing behavior of individual customers. If your site is integrated with IBM Digital Analytics, you can display recommendations from IBM Product Recommendations on your store pages.
  - IBM Enterprise Marketing Management integration
    You can integrate HCL Commerce with IBM Enterprise Marketing Management.
  - IBM Dynamic Pricing
    Dynamic Pricing is a cloud-based pricing system that analyzes real-time market data to provide suggestions on how merchandisers can react to competitor pricing and shifts in market conditions. Data can be fed to Dynamic Pricing from multiple sources, including HCL Commerce. You can configure HCL Commerce to export pricing data to Dynamic Pricing for pricing analysis and adjustment. The adjusted pricing data can then be imported from Dynamic Pricing to HCL Commerce, so the prices can be propagated to your live store front.
  - IBM WebSphere eXtreme Scale
    You can integrate HCL Commerce version 9.0.0.7 or later with IBM WebSphere eXtreme Scale version 8.6.1.2 or later. The WebSphere eXtreme Scale licensed program is an elastic, scalable, in-memory data grid that you can use as an advanced cache for HCL Commerce. Integrating with WebSphere eXtreme Scale can provide significant performance benefits for high volume HCL Commerce customers.
  - Apple Pay on the Web integration
    Apple Pay on the Web integration with HCL Commerce provides you with an easy and secure way to accept and process payments. Apple Pay on the Web enables customers to purchase products in the Aurora starter store with a single touch in Safari on Mac, iPhone, and iPad.
  - Configuring directory services (LDAP) with HCL Commerce
    HCL Commerce can be configured to use one or more LDAP servers as the master user repository instead of the HCL Commerce database. This is typically done when multiple applications need to share a common user repository.
  - Sterling Omni-Configurator integration
    The Sterling Omni-Configurator integration for HCL Commerce enables your storefront to sell complex, configurable products, otherwise know as dynamic kits.
  - OAuth 2.0 framework for social login
    When you integrate with the OAuth 2.0 framework, your shoppers can authenticate to your storefront with their social networking accounts, like Google, Facebook, and Twitter.
- 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.

Using the generic tag with IBM Digital Analytics

If your site is integrated with IBM Digital Analytics, you can use the default implementation of the <cm:generic /> tag that HCL Commerce provides; however, this tag does not currently map to any IBM Digital Analytics data tags. The generic tag can be used for customization, or to forward information to IBM Digital Analytics that the existing IBM Digital Analytics data tags do not support.

Tag placement in store pages

Include the <cm:generic /> tag in the store page. In the page, place the <cm:generic /> tag before the <cm:pageview /> tag.

To use the <cm:generic /> tag, you must also include the tag library in the JSP page before the main page content. Use the following code to include the tag library:


<%@ taglib uri="http://commerce.ibm.com/coremetrics" prefix="cm" %>

Examples of tag usage

Include the generic tag in your store page with the following code:

<cm:generic tag="cmCustomTag(\"param1\", \"param2\");" />