Scenarios

You can configure different recommendation behaviors for each scenario and then monitor their performance in the KPI section and the Insights.

Setting Up a Scenario

In the Recombee Admin UI, navigate to the Scenarios section. Choose Create Scenario and enter a name for your new scenario.

Then, select its Type:

Ranked List

• Returns a single set of recommended items, users, or Item Segments.
• Ideal for typical recommendation and search use cases.

Composite

• Suitable for cases such as Because You Watched <movie> or Items from <category> for You.
• Produces a composite response with two parts:
  • Source — a single item, user, or Item Segment
  • Result — a set of recommended items, users, or Item Segments related to the Source
• See Composite Recommendations for more details.

Requesting a Scenario

Use the Scenario in API Requests or No-Code Widgets.

When using the API:

• Pass the name of the created scenario to the scenario parameter of the recommendation request.
• Example for scenario homepage:

const result = await client.send(
  new recombee.RecommendItemsToUser(userId, count, {
    scenario: 'homepage',
  })
);