Recombee RecommendItemSegmentsToUser
RecommendItemSegmentsToUser operation from Recombee with batching
Overview
This node integrates with the Recombee recommendation service to fetch personalized item segment recommendations for a specified user. It is designed to handle multiple input items in batches, improving efficiency when processing large datasets.
Typical use cases include:
- E-commerce platforms recommending product segments tailored to individual users.
- Content platforms suggesting categories or groups of content based on user behavior.
- Any application requiring batch retrieval of recommended item segments for users.
For example, an online store could use this node to recommend groups of related products to a user based on their past interactions, helping increase engagement and sales.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier of the user to get recommendations for. |
| Count | The number of recommended item segments to return. |
| Cascade Create | Whether to create the item if it does not exist in the database (true/false). |
| Filter | Currently unused; intended for filtering recommendations using Recombee's ReQL filtering syntax. |
| Scenario | The scenario name to tailor the recommendation context. |
| Booster | A booster string to influence the ranking or scoring of recommended items. |
| Logic | JSON object defining additional logic rules to apply to the recommendation query. |
| Batch Size | Number of requests to send per batch when processing multiple inputs. |
| Timeout (Ms) | Request timeout duration in milliseconds. |
| Max Retries | Number of retry attempts on failure before throwing an error. |
Output
The node outputs an array of JSON objects, each corresponding to an input item processed. Each output object contains:
success: Boolean indicating if the recommendation request succeeded.userId: The user ID for whom recommendations were requested.count: Number of recommended items requested.scenario: The scenario used for the recommendation.filter: The filter string applied (currently unused).booster: The booster string applied.logic: The logic object applied.data: The actual recommendation results returned by Recombee API.
If an error occurs and "Continue On Fail" is enabled, the output will contain:
success: falseerror: Error message describing the failurepairedItem: Index of the input item that caused the error
The node does not output binary data.
Dependencies
- Requires an API key credential for authenticating with the Recombee service.
- Needs configuration of the Recombee database ID, private token, and region.
- Uses the official Recombee API client library (
recombee-api-client).
Troubleshooting
- Timeouts: If requests time out, consider increasing the "Timeout (Ms)" property or checking network connectivity.
- Authentication errors: Ensure the API credentials are correctly configured and have sufficient permissions.
- Batch size issues: Very large batch sizes may cause performance degradation or rate limiting; adjust "Batch Size" accordingly.
- Retries exhausted: If the node fails after maximum retries, verify the Recombee service status and input parameters.
- Invalid input parameters: Make sure required fields like "User ID" and "Count" are provided and valid.
Common error messages include:
- Network or timeout errors: Check connectivity and timeout settings.
- Authentication failures: Verify API keys and tokens.
- Invalid request parameters: Review the input properties for correctness.
Links and References
- Recombee API documentation: https://docs.recombee.com/
- Recombee ReQL Filtering and Boosting: https://docs.recombee.com/reql_filtering_and_boosting#reql-filtering