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:

customeventsview1.png manageproperties1.png

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!

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.

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.


Data Type Coercion

Forced Data Type Description
Boolean Inputs of 1, true, t (not case sensitive) will be stored as true
Boolean Inputs of 0, false, f (not case sensitive) will be stored as false
Number Integers or Floats (i.e. 1, 1.5) will be stored as numbers
Array Comma separated list of values, with or without square brackets (i.e.[first, second, third], or first,second,third) will be stored as an Array

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”.

New Stuff!