Event tracking

Learn how to configure which events are tracked automatically, or disable automatic tracking

This section discusses what kinds of events are tracked by Smartlook, how they are made available in the dashboard, how they relate to user privacy, and how to control the level of tracked events.

Smartlook tracks two types of events:

  • User interaction events: finger touches, gestures, UI element focus, etc.
  • Analytics events: button clicks, navigation between screens, and similar events that initialize an action in the application.

There are no known performance issues related to event tracking. However, tracked events, especially those that are visualized during the session playback, can compromise sensitive user data. For more information on sensitive data, see Handling sensitive data.


Further reading

For more information on how user navigation is tracked, see Recording navigation and heatmaps.

User interaction events

Smartlook tracks user interactions with the application UI, like taps and gestures, in order to visualise them during recording playback. These records are also the data for creating user interaction heatmaps.

To protect user privacy, user interaction with virtual keyboards (i.e., events in the area where the keyboard is on the screen) is not recorded. When the application uses a custom input view (e.g., a custom PIN-pad) that the system does not recognize as a system virtual keyboard (and thus Smartlook records interaction events in the area), using one of the event tracking modes to suppress user interaction tracking temporarily should be considered. An example is provided in the Secure custom keyboard cookbook.


Setting such a view sensitive is not enough, as user interaction is tracked on sensitive views. Sensitivity and event tracking are controlled independently. The Handling Sensitive Events chapter offers more in-depth information on how to handle events that could reveal sensitive user information.

Rage Clicks Events

Rage Clicks Event is a specific kind of event that flags screens in the app where a user repeatedly fast taps the screen. This behavior typically occurs when the user is frustrated with the UI, does not understand what the interactive elements of the UI are and what are just graphic artifacts. The rage click events can be reviewed along the other events in the player.


In some apps such as games, however, fast user interaction is expected. For these apps, or their sections, rage click events could be ignored by setting the trackRageClickEvents event tracking option. More info about event tracking option is in the Event Tracking Options section of this document.

Analytics Events

Besides direct tracking user interaction at the basic level of touches and gestures, Smartlook also tracks how these events are understood by the application code. These events track what UI elements have been tapped and how the application reacted to it. All these events are visible in the player timeline. If an analytic event is related to a UI element, the element is highlighted in the screen recording.

Most importantly, these analytics events could be used with Smartlook analytics.

Tracking Custom Events

Smartlook aims to track the relevant events automatically. It is, however, not fully possible on all platforms. Also, there are use-cases when the automated tracking might not provide enough information for the purposes of analytics. If this is the case in your application, Smartlook offers some handy methods for manual event tracking.

The events created by these methods are treated by Smartlook exactly the same way as automatically acquired events of the corresponding type.

Custom events

Custom events are identified by a name, and can also have additional and optional properties. The additional properties can be used in funnels and any other filtering. Technical details can be found in each platform API reference.

Event Tracking Options

All events described in this document are tracked by default. In some cases, it is desired to ignore some kinds of them, however. Such cases include the following:

  • rage clicks in games, when fast repeated user interaction is normal.
  • touch events over custom keyboards or similar controls, that may reveal sensitive information.
  • detected navigation events in apps generated by tools like React Native, where generated screen identifiers make no obvious sense and repeat themselves.


By default, full events tracking is enabled.
To tweak which events are tracked, disable selected event categories.

Smartlook offers several event tracking options that can be combined:

  • Track User Interaction: automatically detected selector (click on a View), focus, touch, gesture, and keyboard events.
  • Track Navigation Interaction: automatically detected navigation events. User defined ones are still being sent.
  • Track Rage Clicks Events: automatic detection and tracking of rage click events.
  • No Tracking: no automatically detected events are tracked. Only user defined events are still tracked.

Did this page help you?