Usage
User Events
ProTrack user events like button clicks, form submissions, and downloads.
User events let you track specific user interactions beyond pageviews. Use them to measure conversions, engagement, and feature usage.
Data Attributes
Track events declaratively using HTML data attributes:
<!-- Basic event -->
<button data-insights-event="signup_clicked">
Sign Up
</button>
<!-- Event with category -->
<button
data-insights-event="download_whitepaper"
data-insights-category="conversion"
>
Download Whitepaper
</button>
When clicked, these elements automatically trigger the corresponding event. No JavaScript required.
trackEvent()
Track a custom event programmatically:
window.insights.trackEvent(name, options)
Parameters:
Example:
// Track a newsletter signup
window.insights.trackEvent('newsletter_signup', {
category: 'conversion'
});
// Track a file download
window.insights.trackEvent('download_pdf', {
category: 'engagement'
});
// Track a button click
document.querySelector('#cta-button').addEventListener('click', function() {
window.insights.trackEvent('cta_clicked');
});
Best Practices
Naming Conventions
Use consistent, descriptive event names:
// Good - clear and consistent
window.insights.trackEvent('form_submitted', { category: 'contact' });
window.insights.trackEvent('video_played', { category: 'engagement' });
window.insights.trackEvent('pricing_viewed', { category: 'conversion' });
// Avoid - vague or inconsistent
window.insights.trackEvent('click');
window.insights.trackEvent('btn1');
Categories
Group related events with categories:
Form Tracking
Track form submissions:
document.querySelector('form').addEventListener('submit', function(e) {
window.insights.trackEvent('form_submitted', {
category: 'conversion'
});
});
Video Tracking
Track video engagement:
const video = document.querySelector('video');
video.addEventListener('play', function() {
window.insights.trackEvent('video_started', {
category: 'engagement'
});
});
video.addEventListener('ended', function() {
window.insights.trackEvent('video_completed', {
category: 'engagement'
});
});
Viewing Events
User events appear in:
- Dashboard - User Events card shows top events
- Events Page - Full event list with filters