Skip to content

Customer behavior and user events

Use the search bar or the checkboxes below to find the events you need to use Currents effectively.

These schema include other App or Website activity such as Sessions, Custom Events, and Purchases tracked through the platform.

Contact your Braze representative or open a support ticket if you need access to additional event entitlements. If you can’t find what you need on this page, check out our Message Engagement Events Library or our Currents sample data examples .

Explanation of customer behavior and user event structure and platform values

Event structure

This customer behavior and user events breakdown shows what type of information is generally included in a customer behavior or user event. With a solid understanding of its components, your developers and business intelligence strategy team can use the incoming Currents event data to make data-driven reports and charts, and take advantage of other valuable data metrics.

Breakdown of a user event showing a purchase event with the listed properties grouped by user-specific properties, behavior-specific properties, and device-specific properties

Customer behavior and user events are comprised of user-specific properties, behavior-specific properties, and device-specific properties.

Platform values

Certain events return a platform value that specifies the platform of the user’s device.
The following table details the possible returned values:

User device Platform value
iOS ios
Android android
FireTV kindle
Kindle kindle
Web web
tvOS tvos
Roku roku

Random Bucket Number Update events

This user event occurs every time a new user is created within their workspace. During this event, each new user gets assigned a random bucket number that you can then use to create uniformly-distributed segments of random users. Use this to group together a range of random bucket number values and compare performance across your campaigns and campaign variants.

Custom events

This event occurs when a specific custom event is triggered. Use this to track when users perform custom events in your application.

Property details

  • For ad_id, ad_id_type, and ad_tracking_enabled, you need to explicitly collect the iOS IDFA and Android Google ad ID through the native SDKs. Learn more about them here: iOS, Android.
  • If you’re using Kafka to ingest Currents data, reach out to your customer success manager or account manager to enable the feature flipper for sending ad_id.

Install Attribution events

This event occurs when an app installation is attributed to a source. Use this to track where your app installs are coming from.

Location events

This event is triggered when a user visits a specified location. Use this to track users triggering location events in your app.

Property details

  • For ad_id, ad_id_type, and ad_tracking_enabled, you need to explicitly collect the iOS IDFA and Android Google ad ID through the native SDKs. Learn more about them here: iOS, Android.
  • If you’re using Kafka to ingest Currents data, reach out to your customer success manager or account manager to enable the feature flipper for sending ad_id.

Purchase events

This event occurs when a user makes a purchase. Use this data to track when users purchase something in the application.

Property details

  • For ad_id, ad_id_type, and ad_tracking_enabled, you need to explicitly collect the iOS IDFA and Android Google ad ID through the native SDKs. Learn more about them here: iOS, Android.
  • If you’re using Kafka to ingest Currents data, reach out to your customer success manager or account manager to enable the feature flipper for sending ad_id.

First Session events

This event occurs when a user starts their first session in your application. Use this data to track when users start sessions.

Session End events

This occurs when a user exits your application, therefore ending their current session. Use this data to track when sessions end, and along with the appropriate session start event, calculate the duration of their time in a session.

Session Start events

This event occurs when a user starts a session. Use this data to track when users start sessions.

HOW HELPFUL WAS THIS PAGE?
New Stuff!