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.

Response Trigger
addToCart A shopper adds an item to a cart. If click stream tracking is configured correctly, you see “addToCart is Okay” when clicking Validator.
beginCheckout A shopper clicks Checkout. If click stream tracking is configured correctly, you see “beginCheckout is Okay” when clicking Validator.
clickReco A shopper clicks a recommended product. If click stream tracking is configured correctly, you see “clickReco is Okay” when clicking Validator.
finishCheckout A shopper finishes checkout. If click stream tracking is configured correctly, you see “finishCheckout is Okay” when clicking Validator.
viewCategory A shopper clicks a category. If click stream tracking is configured correctly, you see “viewCategory is Okay” when clicking Validator.
viewReco A shopper views a page on which recommendations are enabled. If recommendations are working correctly, you see “viewReco is Okay” in Validator. To view individual recommendation information, click the Recommendation tab.
viewProduct A shopper clicks a product. If click stream tracking is configured correctly, you see “viewProduct is Okay” when clicking Validator.
viewSearch When search results display.

QA Commerce Cloud Recommendation Validator

QA test your installation of Commerce Cloud Recommendation Validator to ensure the smooth operation of Einstein Product Recommendations.

Use the Commerce Cloud Recommendation Validator tool to ensure your Commerce Cloud Einstein Product Recommendations implementation runs the way you expect.

Once you download the Recommendation Validator, you can validate the events and ensure anchors are properly populated to the context-object attribute.

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 you add the isactivedatahead tag to the head tag.

viewRico Every time a shopper views page containing a recommendations.
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 Data Errors

Let's take a look at some common data errors and how to fix them.

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 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

Let's take a look at some common storefront errors and how to fix them.

If you have this problem... Consider this...
viewProduct is not firing Make sure you use <isobject object="${product}" view="detail"> on your global product detail page templates
viewReco is not firing Make sure 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 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 happens 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