Skip to main content

Documentation Index

Fetch the complete documentation index at: https://developer.voyado.com/llms.txt

Use this file to discover all available pages before exploring further.

A personalized suggested product is an item that a customer might be likely to buy, based on their previous purchases, activity and other factors. Engage’s suggested products 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 suggested products. 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 suggested products. However, if you do this, be aware that it needs to be structured the same way as your other product feeds.

​
Prerequisites

To get started with the suggested products engine, your Engage environment (tenant) needs to have these features activated:
  • Product feed (only products in this feed can be recommended)
  • A BI-export to the Engage BI-lake
Your Voyado PM will need to help you with this.

​
Fetching suggested products

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 payload 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 suggested items

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 PM if you plan to use this promote/demote functionality.
The default maximum / minimum boost effect is 20% and usually this is the best value.
The field in the XML that contains the promotion weight for a product should be named “productRecommendationPromotionWeight”: 
<productRecommendationPromotionWeight>50</productRecommendationPromotionWeight>
Contact your Voyado PM if you have any more questions about this.