Events overview

Last updated:

When a visitor takes an action in your app where Pendo is installed, this generates an event that’s sent through the Pendo agent. These actions include Page load events, Feature click events, focus events, Pendo Track Events, guide events, and more. Pendo records and uses these events to help you better understand how users engage with your app.

Raw events

Raw events are the original, unprocessed event data that's accessible in real time to Pendo admins through the Raw Events tab within an app's settings.

To access raw events, navigate to Settings > Subscription Settings > Applications, choose an app from the list, and then select the Raw Events tab.

In the Events table, you can view the browser time, agent version, Visitor ID, Account ID, event type, remote IP address, browser and operating system, URL, and app associated with each event. For more information on the different types of events surfaced on this page, see Browser Events and Pendo Events.

AppSettings_RawEvents.png

If you don’t see any raw events, it’s likely because we’re receiving a high volume of events from your app. In this case, you see a banner at the top of the page with a Start Recording option. Select this to instruct the Pendo agent to start recording raw events in the Pendo UI. If you don’t see this option and have confirmed that visitors are using your application, contact Pendo Support for assistance.

Tip: The information on the Raw Events page is especially useful after you install Pendo for the first time to confirm that events are populating as expected. You can also use our debugger tool for testing purposes if you or your developers want to view more comprehensive event logs.

Pendo processes this data at the top of every hour and updates the UI with the processed event data within 15 minutes after each hour.

Event types

Events form the foundation of analytics in Pendo, and we start collecting event data from the moment Pendo is installed on your application. Pages, Features, and Track Events are the primary event types surfaced in the Pendo UI.

Note: If you need to exclude certain event types from being collected, see our Analytics agent API documentation for more information.

Pages and Features

Pages and Features are configurations in Pendo that act as labels or filters for your event data. When you “tag” Pages and Features, you define rules that determine which events display in the Pendo UI.

  • Page load events are recorded when a visitor loads a URL matching a Page rule. Page rules can consist of an individual URL or a group of URLs.
  • Feature click events are captured when a visitor interacts with an element that matches a Feature rule. Feature rules are created with specific CSS selectors. Only click events associated with existing Feature tags display in your analytics.

Because Page and Feature data are collected retroactively, you can modify or delete tags without negatively impacting your Pendo data.

Track Events

Track Events differ from Pages and Features in that they're programmatically sent to Pendo, must be configured by a developer, and aren't captured retroactively. You can use Track Events to capture any interactions that aren't automatically collected as Feature click events or Page load events.

Event properties

Every event has event properties associated with them, which are details about an event at the time it takes place. Global event properties are collected by default on all events, and custom event properties are configured for specific Features and Track Events. You can use event properties in reports and segments to target or analyze how your visitors use your app over time.

EventStructure.jpg

You can also configure custom event properties for Pages, but these are currently available to use for tagging purposes only.

Was this article helpful?
6 out of 7 found this helpful