User Update
The User Update component allows you to update a user’s attributes, events, and purchases in a JSON composer, so there’s no need to include sensitive information like API keys.
With User Update, updates don’t count towards your users or track per minute rate limit. Instead, these updates are batched so Braze can process them more efficiently than a Braze-to-Braze webhook. Note that this component does consume data points.
Users will only advance to downstream Canvas steps after the relevant user updates have been completed. If your downstream messaging relies on the user updates that you’re making, you can ensure that these updates have been completed prior to when the messages send.
Create a User Update
Drag and drop the component from the sidebar, or click the plus button at the bottom of the variant or step and select User Update.
There are three options that allow you to update existing, add new, or remove user profile information. All combined, the User Update steps in an app group can update up to 200,000 user profiles per minute.
Update custom attribute
To add or update a custom attribute, select an attribute name from your list of attributes and enter the key value.
Remove custom attribute
To remove a custom attribute, select an attribute name using the dropdown. You can switch to the advanced JSON composer to further edit.
Advanced JSON composer
Add an attribute, event, or purchase JSON object up to 65,536 characters to the JSON composer. A user’s global subscription and subscription group state can also be set.
Using the advanced composer, you can also preview and test that the user profile is updated with the changes with the Preview and test tab. You can either select a random user or search for a specific user. Then, after sending a test to a user, view the user profile using the generated link.
Limitations
Do not include any of the following information in the JSON composer:
- External user ID
- API key
- Braze cluster URL
- Fields related to push token imports
Use case
For example, if we want a group of users to be promoted to loyalty members, select Loyalty Member as the attribute name, and select True
as the corresponding key value. So, the users who enter this User Update step will have their VIP Member attribute updated to True
.
Personalization features
To store the property of the trigger event for a Canvas as an attribute, use the personalization modal to extract and store the Canvas entry property. This component also supports the following personalization features:
- Connected Content
- Content Blocks
- Entry properties
- Liquid logic (including aborting messages)
- Multiple attribute or event updates per object