Universal Models
Universal Recombee models for the most common use-cases.
recombee:default
Default model ensemble aiming to work well in most common use cases. It is an ensemble of collaborative filtering and content-based recommendation, backed by popularity-based models when there's not enough data in the given context. The ensemble is being continuously optimized by AI so it automatically adapts to incoming data.
recombee:homepage
Universal model ensemble suitable for putting recommendations on the homepage / welcome-screen scenarios.
recombee:personal
Universal model ensemble suitable for user-based recommendations reflecting the personal tastes of the current user.
There must be interaction data for the user.
recombee:similar
Universal model ensemble suitable for either recommending items which are similar to the given item (in case of Items-to-Item recommendation), or recommending users who are similar to the given user (in case of Users-to-User recommendation).
recombee:popular
Universal model suitable for recommending globally popular items, taking into account all interaction types. More important actions (purchases, cart-additions) have higher weight for computing the popularity than less important actions (detail-views).
Interaction data (Detail Views/Purchases/Cart Additions) must be present.
Parameters
The time period in which the popularity is measured.
ReQL filter on top of user properties defining the segment of users among whom the popularity is calculated. For example, when user properties like profession and country are provided for some users, you may only ask for items popular among software developers in US and Canada: 'profession'=="software developer" and 'country' in {"US", "CA"}.
Interaction types to be taken into account when computing the popularity. By default, all the interactions are taken into account. But for example by providing only ["purchases"], you will retrieve items which are most frequently purchased, no matter how frequently are they (or the other items) viewed, bookmarked, etc.
recombee:popular-segments
Universal model ensemble suitable for recommending globally popular segments.
Parameters
The time period in which the popularity is measured.
ReQL filter on top of user properties defining the segment of users among whom the popularity is calculated. For example, when user properties like profession and country are provided for some users, you may only ask for items popular among software developers in US and Canada: 'profession'=="software developer" and 'country' in {"US", "CA"}.
Interaction types to be taken into account when computing the popularity.
recombee:recently-viewed
Model returning the list of recently viewed items for a particular user.
Detail Views must exist for the user.
Parameters
Maximal age of the DetailView since the current timestamp.
Order in which the items are returned with regard to the time when they were interacted. When the order is descending, the last interacted item is at the beginning of the list of recommendations. When it is ascending, the first interacted item matching the maxAge condition is at the beginning of the list.
recombee:visually-similar
Model recommending similar items based on visual similarity (using deep-learning neural networks to process the images provided through the image properties). While the image similarity can take part in other Logics as well, in recombee:visually-similar, it is explicitly used as the primary model. Image processing may take some time. Therefore, changes in image item properties do not take effect in real-time. The functionality is still in beta mode.
This Logic is not available in new databases by default. Please contact support@recombee.com if you want to use it.
Some image properties must be defined for items, with valid image links provided for the majority of the items in the catalog.
Parameters
Enable fallback models to make the recommendations if the model based on visual similarity cannot be used (e.g. due to a missing image for the given source item).
recombee:similar-properties
Model recommending similar items based on item properties (numerical values, sets, and texts). While property values can take part in other Logics, in recombee:similar-properties, they are explicitly used as the primary data source for recommending similar items or uses. Various machine-learning methods, including NLP deep-learning networks that process unstructured text descriptions, are used to compute the similarities.
Some properties must exist for the items/users, depending on the used API endpoint.
Parameters
Enable fallback models to make recommendations if the model based on item properties cannot be used (e.g. due to missing property values for the given source item).
recombee:emailing
Model ensemble suitable for recommending items in periodic e-mailing campaigns. It contains fine-tuned rotation settings so that the set of recommended items for a particular user changes with each e-mail sent.
By default, rotation only takes into account recommendations (e-mails) at most 14 days old. Should a longer time period be needed for your use case, kindly contact support@recombee.com.
Parameters
A policy determining how strictly should already recommended items be rotated.
The default option "smart" contains fine-tuned rotation settings, which take into account the position of recommended items and enable some of the items to re-appear in further e-mails.
Option "total" never recommends items that have already appeared in previous e-mails.
recombee:custom-sort
Model suitable for recommending items ordered by a ReQL expression given as a booster
recombee:related-to-segment
Recommends items that are contextually related to the Item Segment and should be of interest to the user. Items may belong to the Segment or be outside it if they are strongly relevant.
Consider using recombee:personal-from-segment if you want recommendations strictly limited to items within the Segment.
Examples:
- News: For the "Climate Change" Segment, recommend articles about renewable energy (inside the Segment) or related topics like electric vehicles (outside the Segment).
- Music: For the "Jazz" Segment, recommend jazz-related songs, including classic tracks (inside the Segment) or modern experimental pieces (outside the Segment).
- E-commerce: For the "Digital Cameras" Segment, recommend products like digital cameras (inside the Segment) or accessories like tripods, lenses, or lighting kits (outside the Segment).
- Video Streaming: For the "Science Fiction" Segment, recommend sci-fi movies (inside the Segment) or related dystopian thrillers (outside the Segment).
recombee:personal-from-segment
Recommends items from the Item Segment, tailored to the user's preferences.
Consider using recombee:related-to-segment if you don't need all the recommended items to belong to the Segment.
Examples:
- News: For the "Environmental News" Segment, recommend articles on climate policy or renewable energy that align with the user’s reading history.
- Music: For the "Jazz" Segment, recommend jazz songs matching the user’s listening habits.
- E-commerce: For the "Digital Cameras" Segment, recommend digital cameras the user is most likely to be interested in, based on their browsing and purchase history.
- Video Streaming: For the "Science Fiction" Segment, recommend sci-fi movies that match the user’s preferences.
recombee:popular-from-segment
Recommends the most popular items within the Item Segment, based on overall engagement. Use this Logic to highlight trending or widely appealing items.
Examples:
- News: Most-read articles from the "World Politics" Segment.
- Music: Most-streamed tracks from the "Rock" Segment.
- E-commerce: Best-selling smartphones in the "Smartphones" Segment.
- Video Streaming: Most-watched action movies in the "Action Movies" Segment.
Interaction data (Detail Views/Purchases/Cart Additions) must be present.
Parameters
The time period in which the popularity is measured.
Interaction types to be taken into account when computing the popularity. By default, all the interactions are taken into account. But for example by providing only ["purchases"], you will retrieve items which are most frequently purchased, no matter how frequently are they (or the other items) viewed, bookmarked, etc.
recombee:items-from-top-segment-for-you
This Composite Logic provides a comprehensive recommendation in a single response consisting of:
- Top Segment for the User: It identifies and returns the most relevant Item Segment (e.g., the top category) for the user from the specified Segmentation.
- Top Items from the Segment: Along with the Segment, it also returns a list of the top items within that Segment.
This Logic is ideal for recommending a section and its content together, making it particularly useful for personalized homepage sections.
If you want to display multiple distinct sections in a personalized order on your homepage, you can achieve this by making multiple Composite Recommendation requests within a single Batch call.
For more specific use cases, such as "Videos From The Top Genre For You" or "Products from the Top Category For You," there are specialized Logics available.
Composite Stages
Endpoint: Item Segments to User
The Logic returns the most relevant Item Segment (e.g., the top category) for the user from the specified Segmentation.
Endpoint: Items to Item Segment
The Logic returns the list of the top items within the top Segment.
recombee:because-you-interacted
This Composite Logic delivers two results within a single response consisting of:
- Item the User Interacted With: The Logic selects and returns an item that the user has interacted with, based on the interaction types specified by the interactionTypes parameter (e.g., Watched, Purchased, Liked).
- Top Related Items: Simultaneously, it returns a list of top items related to that specific interacted item.
This Logic is ideal for general "Because You..." scenarios, where recommendations are tailored based on the user's previous interactions. For more specific use cases, such as "Because You Bought" or "Because You Watched", there are specialized Logics available.
Composite Stages
Endpoint: Items to User
The Logic selects and returns an item that the user has recently interacted with.
Parameters
Defines which interactions are considered when selecting the item the user has interacted with
Defines the maximum number of days since the user interacted the item for it to be considered for the "Because" selection.
For example, setting maxDaysAgo to 7 will only consider items interacted within the last 7 days.
Endpoint: Items to Item
The Logic returns a list of top items related to a specific item, offering content the user is likely to be interested in.
recombee:swiping-feed
This Logic is designed for infinite swiping feed experiences (such as reels or short-form video feeds), where users continuously browse content and can express feedback through likes or dislikes.
It optimizes recommendations in real time based on a configurable combination of user engagement (likes, number of viewed items, purchases), and time spent consuming content.
View Portions shall be sent for consumed content, with the autoPresented parameter set to true and timeSpent specified
Likes and dislikes shall be sent as +1 / -1 Ratings
After a few items have been presented, call Recommend Next Items to retrieve the next batch of content
Parameters
Property representing the creation time of an item, enabling the Logic to evaluate and prioritize newer content in recommendations.
Weight (0–1) controlling the importance of time spent on content in the optimization.
Weight (0–1) controlling the importance of user likes (positive Ratings) in the optimization.
Weight (0–1) controlling the importance of maximizing the number of items consumed by the user.
Weight (0–1) controlling the importance of Purchases in the optimization.