UserInterestRecommendationsList
UserInterestRecommendationsList
The UserInterestRecommendationsList
controller recommends products to the current user based on their general interests. To achieve this, ML models learn from users' previous actions, and use this information to find other customers that share similar browsing patterns. The model then suggests products that have been previously browsed by customers who share similar interests with the current user.
Methods
refresh
Gets new recommendations for items that may be of interest to the user.
subscribe
Adds a callback that’s invoked on state change.
Parameters
-
listener:
() => void
A callback that’s invoked on state change.
Returns Unsubscribe
: A function to remove the listener.
Attributes
state
The state of the UserInterestRecommendationsList
controller.
Properties
-
error:
SearchAPIErrorWithStatusCode | null
An error returned by the Coveo platform when executing a recommendation request, or
null
if none is present. -
isLoading:
boolean
Whether a recommendation request is currently being executed against the Coveo platform.
-
maxNumberOfRecommendations:
number
The maximum number of recommendations.
-
recommendations:
ProductRecommendation[]
The products recommended by the Coveo platform.
Initialize
buildUserInterestRecommendationsList
Creates a UserInterestRecommendationsList
controller instance.
Parameters
-
engine:
ProductRecommendationEngine
The headless engine.
-
props:
UserInterestRecommendationsListProps
The configurable
UserInterestRecommendationsList
properties.
Returns UserInterestRecommendationsList
UserInterestRecommendationsListProps
The configurable UserInterestRecommendationsList
properties.
Properties
-
options?:
UserInterestRecommendationsListOptions
UserInterestRecommendationsListOptions
Properties
-
additionalFields?:
string[]
Additional fields to fetch in the results.
-
maxNumberOfRecommendations?:
number
The maximum number of recommendations, from 1 to 50.
Default:
5
Related Types
ProductRecommendation
Properties
-
additionalFields:
Record<string, unknown>
An object containing the requested additional fields for the product.
-
childResults:
ProductRecommendation[]
A list of child product recommendations in a product grouping context.
-
clickUri:
string
A direct link to the product in URL format.
-
documentUri:
string
This parameter is no longer used by the Coveo Usage Analytics service.
-
documentUriHash:
string
Document UriHash in the index. Useful for analytics.
-
permanentid:
string
The SKU of the product.
-
totalNumberOfChildResults:
number
The total number of items in the group.
-
ec_brand?:
string
The brand of the product.
From the
ec_brand
field. -
ec_category?:
string
The category of the product (for example,
"Electronics"
,"Electronics|Televisions"
, or"Electronics|Televisions|4K Televisions"
).From the
ec_category
field. -
ec_images?:
string[]
Additional product images in URL format.
From the
ec_images
field. -
ec_in_stock?:
boolean
The availability of the product (that is, whether it’s in stock).
From the
ec_in_stock
field. -
ec_item_group_id?:
string
The id used for Product Grouping.
From the
ec_item_group_id
field. -
ec_name?:
string
The name of the product.
From the
ec_name
field. -
ec_price?:
number
The base price of the product or variant.
From the
ec_price
field. -
ec_promo_price?:
number
The promotional price of the product or variant.
From the
ec_promo_price
field. -
ec_rating?:
number
A rating system. Ratings range from 0-10.
From the
ec_rating
field. -
ec_shortdesc?:
string
A short description of the product.
From the
ec_shortdesc
field. -
ec_thumbnails?:
string[]
Product images in URL format.
From the
ec_thumbnails
field.
Unsubscribe
Call signatures
-
(): void