Configuring the Oracle Recommendations Integration

To use Commerce Reference Store with Oracle Recommendations, include the Store.Recommendations module in your storefront EAR file. (For internationalized sites, include the Store.Recommendations.International module.) For example, the command to assemble the storefront EAR file might be:

runAssembler ATGStore.ear –m Store.Storefront Store.Recommendations
  Fullfillment

To access Oracle Recommendations, you need an account. You use this account to configure rules that control what recommendations are produced, and to upload an XML file containing your product catalog repository data to Oracle Recommendations.

Commerce Reference Store includes a sample read-only account that is preconfigured to work with the Commerce Reference Store sites to demonstrate Oracle Recommendations functionality. The Commerce Reference Store product catalog has already been uploaded to this account. Note that if you build your own site based on Commerce Reference Store and want to use Oracle Recommendations, you need to obtain an account and use it to configure the rules for your site.

The Commerce Reference Store integration with Oracle Recommendations is configured through the /atg/store/recommendations/StoreRecommendationsConfiguration component. Key properties of this component include:

retailerId
A unique string that identifies the Oracle Recommendations account. By default, this is set to the Commerce Reference Store demo account.

recommendationsScriptUrl
The URL of the Oracle Recommendations JavaScript library.

cartChangeJMSTypes
The list of JMS event types that trigger inclusion of shopping cart content in the clickstream tracking code.

Commerce Reference Store configures the component like this:

recommendationsScriptUrl=//static.atgsvcs.com/js/atgsvcs.js
retailerId=fb4a7379
searchTermQueryArgs=q
searchResultsPages=\
    /*/searchResults.jsp

searchResultsPagesCache=/atg/store/recommendations/SearchResultsPagesCache
priceListManager=/atg/commerce/pricing/priceLists/PriceListManager
catalogNavHistoryPath=/atg/commerce/catalog/CatalogNavHistory

cartChangeJMSTypes=\
  atg.commerce.order.ItemAddedToOrder,\
  atg.commerce.order.ItemQuantityChanged,\
  atg.commerce.order.ItemRemovedFromOrder,\
  atg.commerce.fulfillment.SubmitOrder,\
  atg.commerce.promotion.ScenarioAddedItemToOrder,\
  atg.dps.Login,\
  atg.dps.StartSession,\
  atg.commerce.pricing.PriceChanged,\
  atg.multisite.SiteChanged

includeRootCategory=true