Recombee SetUserValues
Overview
This node, "Recombee SetUserValues," is designed to set or update properties for a specific user in a Recombee database. It allows you to maintain up-to-date user profiles by modifying any user-related information such as preferences, demographics, or behavioral data. This operation is essential when you want to personalize recommendations or track user attributes dynamically.
Common scenarios include:
- Updating user preferences after they interact with your application.
- Adding demographic details to user profiles for better segmentation.
- Recording behavioral data like recent activity or purchase history.
For example, if you have a user with ID "user123" and want to update their preferred categories and last login time, you can use this node to send those updates directly to the Recombee service.
Properties
| Name | Meaning |
|---|---|
| User ID | The unique identifier of the user whose properties you want to update. |
| Values | A JSON object containing the user properties to set or update. These can be any key-value pairs representing user data. |
| Cascade Create | Boolean flag indicating whether to create the user if they do not already exist in the database. Options: true or false. |
| Max Retries | Number of times to retry failed batch requests. Useful for handling temporary network issues or rate limits. Default is 2. |
Output
The node outputs an array of JSON objects, each corresponding to one user update attempt. Each output item contains:
success: Boolean indicating if the update was successful.- If successful, the original input parameters plus a
userDatafield containing the response from Recombee. - If failed, an
errorfield describing the failure along with the original input parameters.
The output structure helps identify which user updates succeeded or failed, enabling error handling or retries downstream.
No binary data is produced by this node.
Dependencies
- Requires an API key credential for authenticating with the Recombee service.
- Needs configuration of the Recombee database ID, private token, and region via credentials.
- Uses the official Recombee API client library bundled within the node.
Troubleshooting
- Empty Values Error: If the "Values" JSON object is empty, the node throws an error stating "Values cannot be empty." Ensure you provide at least one property to update.
- API Errors: If the Recombee API returns errors for individual user updates, these are either thrown as node errors or included in the output depending on whether "Continue On Fail" is enabled.
- Retries: Network issues or rate limits may cause request failures. The node automatically retries batch requests up to the configured "Max Retries" count.
- Credential Issues: Missing or incorrect API credentials will cause authentication failures. Verify that the API key and database details are correctly set in n8n credentials.