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.
Access events
Go to Data > Events. All event streams in your dataset display here.
Manage event stream details
Locate specific events
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:
- All Visibility – View events regardless of their visibility status.
- Visible – View visible events.
- Hidden – View hidden events.
Modify event details
To modify an individual event, click anywhere on the event or select More > Edit, make changes to its information, and then click Apply.
Note
Event descriptions display on hover wherever you can select events in the Analytics app. Users can manually specify descriptions, including updating descriptions that automatically sync from the table description in the data warehouse when there are tables in union datasets that contain only one event type.
Event usage stats
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:
- Average – The average number of events received per day.
- Present on – The days the event was received, out of the days counted.
- Trend – The daily change as a percentage. Optimizely shows a trend only when the direction is clear enough to report.
- Your usage – How often you query the event, ranked against every event in the app.
- App usage – How often everyone in the app queries the event, ranked the same way.
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.
Control visibility of events
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.
To categorize events for organizational purposes, click the drop-down list in the Categories column and select an existing category. You can also create a category by clicking +. See Manage Categories.
Merge events
Merging events streamlines analysis by combining related actions, such as unifying separately captured events like explorations and dashboards, or consolidating renamed events over time.
- Select the events using the checkboxes and click Merge.
- Enter the Display Name, Description, and set the visibility status of the selected events you want to merge.
- (Optional) Add events to the merge list by clicking the Definition field and selecting the events from the drop-down list.
- Click Apply to see the merged event.
Unmerge events
- Click the merged event.
- Remove events that you want to unmerge from the Definition field.
- (Optional) Rename the event.
- Click Apply.
- The unmerged events display in the original event list.
Delete multiple events
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:
- Go to Data > Events.
- Select the events using the checkboxes. The toolbar shows how many events you have selected.
- Click Delete. The button shows the number of selected events, for example Delete (3).
- In the confirmation dialog, check the number of events you are about to delete and click Yes. To keep the events, click No.
Warning
You cannot undo a deletion. To use a deleted event again, you must recreate its configuration.
Refresh event details
To refresh the page, click Refresh.
Custom events
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.
Create a custom event
To create a custom event, do the following:
- Go to Data > Events.
- Click New custom event.
- Enter a name for your event and add a desired description.
- Use the Cohort of drop-down list to select the event stream where you want to create a custom event. This opens the cohort editor.
- In the Filtered Event block, select the events you want to include in the cohort and click Apply.
- Run the cohort and click Save. The system creates your custom event, and it is visible under the Custom Events tab in the Events section.
Edit, duplicate, or delete a custom event
To edit, duplicate, or delete an existing custom event, do the following:
- Go to Data > Events.
- In the Custom Events tab, click More (...) corresponding to the event you want to edit, duplicate, or delete, and click on the associated option.
- Make the necessary edits and click Save.
