Custom Event and Attribute Management
Adding Custom Attributes, Custom Events, Products, and Event Properties
To add a custom attribute, event, or product, go to the Custom Attributes, Custom Events, or Products pages, respectively, under “Manage App Groups” by clicking the “Add ..” button on the upper right hand corner of the lists of data. This will enable tracking on it.
You can also add event properties for custom events or products by clicking on the “Manage Properties” link in the “Event Properties” column:
To make these added custom attributes, events, products, or event properties trackable, you must ask your developer to create it in the SDK using the exact name you used to add it earlier. Or, you may use Braze’s APIs to import data on that attribute. After that, the custom attribute, event, or other will be actionable and apply to your users!
All User Profile data (Custom Events, Custom Attribute, Custom Data) is stored as long as those profiles are active. Custom Event Properties are stored and available for Segmentation for thirty (30) days. If you’d like to leverage Event Properties for Segmentation, please contact your Braze account or customer success manager.
Blacklisting Custom Attributes, Custom Events, and Products
If you want to stop tracking a specific custom attribute/custom event/product (e.g., accidental creation during testing, no longer useful), search for it in the Custom Events tab, then click Blacklist.
Once a custom event or attribute is blacklisted,
- No data will be collected regarding that event/attribute,
- Existing data will not be wiped,
- Blacklisted events/attributes will not show up in filters or graphs.
Changes to the blacklist may take a few minutes to propagate. You may re-enable any blacklisted event or attribute at anytime.
Please note that you should still remove the event/attribute from your app code during your next release.
Forcing Data Type Comparisons
Braze automatically recognizes data types for attribute data that is sent to us. However, in the event multiple data types are applied to a single attribute, you can force the data type of any attribute to let us know what it really is. Click on the drop-down in the Data Type column to choose.
Note: Forcing data types does not apply to event properties, or purchase properties.
If you elect to force the data type for an attribute, any data that comes in that isn’t the specified type will be ignored.
Data Type Coercion
|Forced Data Type||Description|
|Number||Integers or Floats (i.e.
|Array||Comma separated list of values, with or without square brackets (i.e.
For more information on specific filter options exposed by different data type comparisons please see “Configuring Reporting - Braze Academy”. And for more information on the different available data types, please see the section on “Custom Attribute Data Types”.
Please note that data sent to Braze is immutable and cannot be deleted or modified once we’ve received it. However, you can use any of the steps listed above to exercise control over what you’re tracking in your dashboard.