Commerce Cloud Einstein Recommendation Validator

The Einstein Recommendation Validator is a Chrome extension that validates and debugs Commerce Cloud Einstein recommendations and sorting rules in your marketplace.

You can use it to verify site activity and recommendations and email recommendations and open pixels.

Install the Recommendation Validator

The Commerce Cloud Einstein Recommendation Validator extension is available only for the Google Chrome browser.

  1. In your Chrome browser, go to the Chrome Web Store extension page.
  2. Click Add To Chrome.
  3. To confirm the installation, click Add Extension.
    The extension icon appears to the right of the address bar.

Use the Validator

The Recommendation Validator begins running when it’s installed. When you navigate to a site using Commerce Cloud Einstein features, it instantly validates recommendation activities and sorting rules. When the validator recognizes an event, a numbered footnote appears within the icon pointing out the number of events it caught.

  1. Trigger activities by navigating through your storefront.
  2. To see the status of triggered activities, click the Validator icon (1) when footnotes appear.

    Recognized events (2) are displayed.

    Note: If recommendations or email personalization are enabled, those tabs populate with related information.
    See Also

    Recommenders

Validator Responses

The Recommendation Validator starts running immediately after installation. When you navigate to a site using Commerce Cloud Einstein features, it instantly validates recommendation activities and sorting rules.

When Validator recognizes an event, an icon appears with the number of events it has detected. Based on the activity, Validator shows a particular response.

We recommend that you test your storefront with the validator to ensure expected operation.

Event This event should fire...
viewProduct

Once on every product detail page. It enables recently viewed recommenders and recommenders that use the real time personalization strategy.

Note: Make sure that you add the isactivedatahead tag to the head tag.

viewRico Every time a shopper views page containing a recommendation.
clickRico Every time a shopper clicks recommendation.
addToCart Every time a shopper adds a product to a cart.
finishCheckout Every time a shopper places an order.
viewCategory Every time a shopper views a category grid page.
viewSearch Every time a shopper views the search results page with results.
clickCategory Every time a shopper clicks through from a category grid page to a product detail page.
clickSearch Every time a shopper clicks through from a search results page to a product detail page.

You need to ensure that anchors are properly populated with the context-object attribute, as follows.

Page Description Example
Product Details (PDP) Product ID should display in the Integration Validator beside 'anchors' on the Recommendations tab.

Example PDP slot tag:

<isslot id="pdp-you-may-like" description="PDP You May Like" context="global" context-object="${pdict.Product}"/>

Category Category ID should display in the Integration Validator beside 'anchors' on the Recommendations tab.

Example category slot tag:

<isslot id="recomm-category-anchor" description="Product page slot" context="global" context-object="${pdict.ProductSearchResult.category}"/>

Common Recommendation Validator Errors

Here are some of the common errors that sometimes occur, and how to fix them, when using the Recommendation Validator.

Common Data Errors

A common problem is that Availability allocation is defined as '0' on a master product in Business Manager. To fix this, remove inventory definitions if possible. This results in an allocation of 'N/A'. If the master ID allocation is required, define a valid amount of allocation such as '100'

Another common problem is not receiving weekly reports. Weekly reports depend on two events firing properly: viewReco and clickReco. When they'd don't fire properly, make sure that you are using the correct isobject statement.

Event Statement Where used
viewProduct <isobject object="${product}" view="detail"> Global product detail page template
viewReco <isobject object="${product}" view="recommendation"> Content slots

Common Storefront Errors

If you have this problem... Consider this...
viewProduct is not firing Make sure that you use <isobject object="${product}" view="detail"> on your global product detail page templates
viewReco is not firing Make sure that you use <isobject object="${product}" view="recommendation"> in your content slots
clickReco is not firing

Use the Validator to check for clickReco. If it's missing, check the page with the recommendations that you clicked for viewReco.

If viewReco is there, make sure that its product ID matches the product ID in the viewProduct activity on the page after you click. If they don't match, submit a support the developer to ensure the isobject tag is configured correctly.

Incorrect price displaying because of master product price definitions Fix the template API to call on variation price definitions instead of the master ID.
viewCategory or viewSearch is not firing The tracking of these happen automatically if you use an isobject tag when rendering each product tile. If they don't fire, check the product tile code.

See Also

The isactivedataheadtag