Omnichannel Experiences

Omnichannel Recommendations Action Requests

When selecting recommendation strategies for this type of action, be aware of the following conditions related to the recommendation algorithm configured as part of the recommendation strategy:

The following table contains guidance for which context events you must include in the request when the recommendation strategy uses a collaborative recommendation algorithm, based on the option selected from Base Recommendation on in the strategy configuration.

Base Recommendation on

Event Required

Item(s) viewed on current page

First item viewed on current page

Last item viewed in any session

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Item(s) viewed in past sessions

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Item(s) currently in the cart

Abandoned cart items in past sessions

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Last item carted in any session

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Item(s) purchased in current session

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Item(s) purchased in previous sessions

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Last item purchased in any session

No additional events required so long as the customer's unique identifier is associated with a previous completed purchase

Item group ID(s) in custom variable

See User Identity Persistence in Requests for more information about passing unique identifiers for customers in Engine API requests.

Request Examples for Noncollaborative Standard Algorithms

This request example is for an Omnichannel recommendations action configured with recommendation strategies that use the Most Viewed (Product Detail Page), Top Selling by Purchase Count, or Top Selling by Gross Revenue recommendation algorithm.

Example Request for Omnichannel Recs Action Using a Noncollaborative Algorithm


Request Examples for Collaborative Algorithms

This example is for recommendation strategies that use a collaborative recommendation algorithm with recommendations based on First item viewed on the current page or Item(s) viewed on current page. It includes the monetate:context:ProductDetailView event.

Example Request for Omnichannel Recs Action Using ProductDetailView Event


Like the previous example, this one is also for recommendation strategies that use a collaborative recommendation algorithm with recommendations based on First item viewed on the current page or Item(s) viewed on current page. This one, however, includes the monetate:context:ProductThumbnailView event.

Example Request for Omnichannel Recs Action Using ProductThumbnailView Event


This example is for recommendation strategies that use the Viewed and Also Viewed and the Viewed and Later Purchased recommendation algorithms based on the last item purchased in any session.

You must send the product ID of the last purchase.

Example Request for Omnichannel Recs Action Using Viewed and Also Viewed, Viewed and Later Purchased Algorithms


This example is for recommendation strategies that use the Viewed and Also Viewed and the Viewed and Later Purchased recommendation algorithms based on the last item carted in any session.

You must send the product ID of the last item added to the cart.

Example Request for Omnichannel Recs Action Using Viewed and Also Viewed, Viewed and Later Purchased Algorithms


Request Best Practices by Implementation Type

If your site uses a hybrid implementation, keep in mind these best practices when configuring an Omnichannel Product Recommendation action:

  • You only have to send product IDs if you base recommendations on a specific product (for example, a recommendation strategy configured with the Viewed and Also Viewed recommendation algorithm based on the last item viewed in any session or the first item viewed on the current page).
  • monetate:context:ProductDetailView, CartLine, and PurchaseLine events are obtained from the Monetate tag. You're not required to send these.

If your site uses a pure Engine API implementation, keep in mind that you must send all ProductDetailView, cartLine, and purchaseLine events.