Event taxonomy

Event taxonomy helps you organize the events in an event stream, creating an efficient and streamlined experience. With event taxonomy, you can control which events are visible in the event selector inside templates. You can also make changes to the configuration of individual events, such as modifying their names, descriptions, and definitions.

Go to Data > Events. All event streams in your dataset display here.

To see details related to an event stream, click the stream and view details like display name, descriptions, definition, and visibility status.

To search for specific events in the events stream, enter the event name in the search bar.

To filter events by their visibility status, use the Visibility drop-down list. The following options are available:

To modify an individual event, follow these steps:

Each event type carries usage stats collected from daily event counts. Use them to separate a live event from one that stopped receiving data. Hover an event to open its popover, which reports the following stats:

The two usage ranks measure how often an event is queried, not how much data it receives. A high-volume event that nobody analyzes ranks low.

The daily average uses the days Optimizely holds counts for, up to the most recent 30. A recently synced dataset reports a shorter window rather than counting the missing days as empty. Optimizely recounts every two days, so a newly instrumented event has no stats until the next run. The stats do not change when you change the time range of an analysis.

A daily average of zero, or no stats at all, means Optimizely holds no recent counts for the event. Check whether the event was merged into another event, and whether its dataset still receives data. Hide the event when it is obsolete. Raise it with the team that owns the dataset when the event should still arrive.

Sort the event selector by usage to reach the events you analyze most without scrolling or searching. By default, each event stream in the selector starts with the events you and your team query most. Switch to alphabetical order when you know the event name and want to scan for it.

Usage order combines your own queries with the queries of everyone in the app. Your queries carry more weight, so the order reflects how you work. Recent queries also count more, because the weight of a query halves each week. All Events stays first in the list.

To change the sort order, click Sorted by usage or Sorted alphabetically in the event selector. The new order applies to every event stream in the selector. Analytics saves your choice for each app, so the event selector opens in the same order in later sessions.

When you search, the event selector ranks results by how closely they match your search, not by your sort order. Exact name matches come first, followed by events that receive data. Clear the search to return to your sort order.

To control the visibility of an event, toggle Visible on or off for each event.

To hide multiple events, select the events using the checkboxes and click Hide. This turns the status of the selected events to Hidden.

To display previously hidden events, select the events using the checkboxes and click Show. This turns the status of the selected events to Visible.

Categorize events to group related events and find them faster in filters and pickers. To categorize an event, follow these steps:

To create a category from the list, go to Configure categories and permissions.

Merging events streamlines analysis by combining related actions, such as unifying separately captured events like explorations and dashboards, or consolidating renamed events over time.

To unmerge events, follow these steps:

You can delete events you no longer need from the event catalog in one action instead of one at a time. Deleting an event removes its configuration in Optimizely Analytics, such as its display name, description, and visibility settings. It does not affect the underlying event data in your data warehouse.

To delete multiple events, do the following:

To refresh the page, click Refresh.

You can create custom events directly from the Events section or the app Menu bar. Custom events are cohorts of events that fall under a single event stream. When you create the custom event, you can select events by name using the Filtered Event block.

To create a custom event, do the following:

To edit, duplicate, or delete an existing custom event, do the following: