The Event Library lists all of your site's events. These are grouped into two categories:
- Events Created By You - events created through our Event Wizard, which lets you create new rules to record events without additional code changes.
- Events Tracked Via API - events we received through API calls or integrations.
Events Created By You - The Event Wizard
You can add rules for three types of events:
- When someone Visits a URL, meaning they saw a particular page.
- When someone Clicks On an element in your site: a particular button, a link, or something else.
- When someone Submits a Form to provide you information. This could be a form for collecting lead-gens, subscribing to your newsletter, or something else.
Should I use your Event Wizard?
Our Event Wizard works for many scenarios, but may not be best to record every event. Consider using our API if you want to track in one of these scenarios:
- Recording URLs that match a regular expression.
- Tracking elements that are loaded dynamically (ie., via Ajax).
Events Tracked Via API
There are three types of events listed here:
- Events you pass in from another data source: a server-side API, our Database Sync tool, CSV import, or one from of our other integrations.
- Events collected from old Event Wizard entries that have historic data, but are no longer actively tracking current user behavior.
Event Library FAQs
When you save changes to the Event Library, they are set to update within 1 minute. Realistically though, it can take up to an hour for our CDN to synchronize the updates across the servers providing your JS library, and for your browser's cached version of the JS Library to expire (without you forcing a refresh). We don't typically see it taking THAT long, but in the worst case scenario, your new Event Library events won't be visible until an hour later.
- Where can I change the display names of the events?
- Where can I see the frequency of each event, for all time?
- I created an event using the Event Library, but I'm not able to see that event when setting up reports. What's wrong?
One thing to keep in mind is that an event must have data associated with it before it can become available to reports. If there's no data associated with an event, as is often the case with a freshly-created event, you won't be able to use it in reports. To check on the status of an event and see if it has received data, visit the "View Total Counts" page.
Contributed by Eric Fung