Custom events are events that are sent to Heap using our API. Once they come into Heap, we automatically define these events for you to use in analysis. You can also rename, categorize, use them in combo events, and add notes to these events to keep them organized.
Once brought in by your API, you can rename custom events to specify the conditions of the event. For example, you might rename your custom event to Order Confirmation – Revenue > $50′, ‘Sent Email – Subject: Getting Started’, and ‘Submit Sign Up – > 20 employees. These names clearly define the parameters of the event for use in analysis.
The ‘Custom’ Source will only be available in the drop-down once you have sent an event via the heap.track API.
To build a new event using a custom event as the base:
- Navigate to Define > Events and click the New Event button
- Choose Custom as the Source, and select the custom event you’d like to use as a base
- Add filters to specify the parameters of your new event
- Rename and categorize your new event
Custom events are often created using custom properties or Snapshots. When a custom event definition is built on a custom property, you can see the custom property in the event definition. You can also jump to the custom property that the event is built on by clicking the external link icon next to the custom property.
Watching Replays of Events (paid feature)
Session replay is an add-on feature for paying customers only. You may try the feature for free for 14 days or 10,000 sessions (whichever comes first), after which you must contact sales to continue use.
If you have session replay enabled, you can watch replays of events from the event details page. Next to the event title, click the Replays of event button.
A pop-up will appear where you can watch the latest replay of the event. Use the play, pause, rewind, adjust speed, and next replay options to explore replays where this event took place.
For more information about session replay, check out our session replay docs.