Create and manage event definitions

Create event definitions to track user behavior.

An event definition in Digital Experience Analytics (DXA) represents a combination of attributes and tags on spans from Splunk Real User Monitoring (RUM), which defines a specific user interaction (for example, click, route change, application crash, and more) you want to track. Create event definitions that can be referenced in other filters, funnels, or event analyses used in DXA. For more information, see RUM Browser data model.

Use cases for event definitions

  • Use same event across multiple analyses: A product manager wants to define and track the same user event across multiple conversion funnel analyses.

  • Track user behavior across multiple pages: A product manager wants to track button clicks on different pages in an application to identify drop-off points.

  • Create custom events: A marketing analyst needs to define a "Newsletter Signup" event to measure the success of a new campaign.

  • Audit event data: A data analyst needs to review event definitions to ensure data quality and consistency across the organization.

Events in Digital Experience Analytics

Events are collected using mobile and browser RUM agents, which ingest and store data in RUM. Events represent spans collected in Splunk RUM, which can then be combined to become event definitions. The event definitions in DXA are categorized into the following types:

  • Interaction: click, tap, rage click

  • Navigation: route change, document load, screen name change

  • Error: JS error, application crash

  • Custom: user-defined events

Events can also include tag attributes for more detailed tracking and filtering. Event tags are similar to the tags used in Splunk RUM. An event with tags added creates an event filter. DXA includes the following filter templates to capture common use cases, and define the events that should be considered for analysis:

  • Click on element: event name is click with tag target_xpath

  • Click on text: event name is click with tag target_text

  • Visited URL: event category is navigation with tag url.full

  • Custom: any of the ingested event names

Create new event definition

Define the steps involved the event you want to track. Preview the events that match your definition based on real-time data from your environment in the Occurrences section. Follow these steps to define a new event.

  1. From the Digital Experience Analytics Overview page, select the Event Definitions tab.
  2. Select New event definition.
  3. Add a title and description for your event.
  4. Define the event steps. Build a query from your own custom events, or select from a list of pre-defined events. Use AND/OR operators to include multiple events in your definition, and the three-dot menu next to each step to duplicate or change the order of event steps.
  5. Note: The definition settings will impact all objects that are referenced in the event definition.
    Select Save to save your new definition.

Manage all your event definitions from the Event Definitions tab. Select the three-dot Actions menu to edit or delete an event.

Create event definitions for specific interactions on a web page using the element picker. For more information, see Use the element picker.

After you create an event definition, you can use this definition when creating conversion funnel analyses. For more information, see: Create a conversion funnel analysis.