Skip to main content

Product recommendations

Engage's Product Recommendation engine looks at all historical purchases and identifies how products relate to each other through the behavior of your customers. Once the AI engine learns your customers' purchase and return behavior, it can use their favorite product categories, favorite brands, viewed relevant products online, and abandoned carts to present them with personalized product recommendations.

For an introduction to product recommendations in Engage, check out this article.

Tip

if you want to control which products are included in the recommendation engine and which are not, you can use a separate product feed for product recommendations. However, if you do this, be aware that it needs to be structured the same way as your other product feeds.

Prerequisites for product recommendations

To get started with the recommendation engine, your Engage environment (tenant) needs to have these features activated:

  • Product feed (Only products that exists in this feed can be recommended)

  • A BI-export to the Engage BI-lake

Getting product recommendations

There is an API endpoint to do this. You'll need the contact's unique contact ID.

GET /api/v3/contacts/{contactId}/productrecommendations

The response will be something like this:

{
"skus":[
"1234","2345","3456","4567","5678","6789","7890","8901","9012","0123"]
}

If the request has not been successful, you'll get one of the following HTTP error codes:

  • 400 - InvalidContactId

  • 404 - ContactNotFound

Promote/demote items in product recommendations

It is possible to promote or demote items that come from your product feed. This is done with a number between -100 and 100 (referred to as the product's weight). A weight of -100 will demote the item to the maximum extent while 100 will promote it to the maximum extent. The "maximum extent" is determined by a setting in the back-end which control the maximum (and minimum) boost effect. So you'll need to inform your Voyado team if you plan to use this promote/demote functionality.

Important

The default maximum / minimum boost effect is 20% and usually this is the best value.

The field in the XML containing the promotion weight for a product should be named productRecommendationPromotionWeight:

<productRecommendationPromotionWeight>50</productRecommendationPromotionWeight>

Contact your Voyado team if you have any more questions about this.