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.

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:

Commerce Reference Store configures the component like this:

recommendationsScriptUrl=//static.atgsvcs.com/js/atgsvcs.js

retailerId=cfa93013

searchTermQueryArgs=Ntt
searchResultsPages=\
    /cartridges/PageSlot/PageSlot.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