Custom event goals
Conversion tracking
without the complexity
GhostlyX custom event goals let you measure any action on your site. Fire an event with one line of JavaScript and see conversions, conversion rate, and top converting pages in your dashboard instantly.
Get started freeacme-corp.com
Goals & events
Waiting for events...
Simulated preview with sample data. Get started free to see your real conversion data.
How custom event goals work
Once the GhostlyX script is on your page, firing a custom event takes one line of JavaScript. Call ghostlyx.event('event-name') from anywhere in your code. The event is sent to GhostlyX, recorded against the current session, and immediately visible in your dashboard.
Goals are defined inside GhostlyX by matching an event name. When a visitor fires that event, the goal is counted. You see total conversions, conversion rate, and the pages where conversions happen most often.
You do not need to modify your analytics configuration each time you want to track something new. Define the goal name once in GhostlyX and fire the matching event from your code.
JavaScript
// Track a form submission ghostlyx.event('signup-form-submitted'); // Track a download with properties ghostlyx.event('pdf-downloaded', { file: 'pricing-guide.pdf' }); // Or use a data attribute (no JS needed) <button data-event="upgrade-clicked"> Upgrade </button>
Full documentation in the custom events guide.
Common conversion events to track
Custom event goals work for any interaction your site can detect in JavaScript or via a data attribute.
Form submissions
Count signups, contact form completions, newsletter opt-ins, and any other form submit event.
File downloads
Know how many visitors download your PDFs, software packages, or other assets.
Outbound link clicks
Track when visitors click links to external sites, partner pages, or your app store listings.
Button clicks
Measure engagement with specific CTAs. Know which button copy and placement drives the most action.
Video plays
Fire an event when a visitor starts or completes a video so you know how far they engage with your content.
Checkout steps
Track each step of your purchase or onboarding flow to identify where visitors drop off.
Frequently asked questions
What are custom event goals in web analytics?
Custom event goals are user-defined conversion points that fire when a visitor performs a specific action on your site, such as submitting a form, clicking a button, or downloading a file. GhostlyX records each event, counts conversions, and shows the conversion rate and the pages where conversions happen most often.
How many custom events can I track?
The number of distinct event types you can define is not capped at the script level. Goal limits depend on your subscription plan. Check the pricing page for current plan details.
Can I pass properties with an event?
Yes. The event function accepts an optional properties object. You can pass key-value pairs that will be recorded alongside the event and made available for filtering in your dashboard.
Do custom events count towards my pageview limit?
No. Custom events are counted separately from pageviews. Your plan's pageview limit applies only to standard page loads tracked by the script.
Can I track events without writing JavaScript?
Yes. The GhostlyX script supports data attributes on HTML elements. Add a data-event attribute to any link or button and the script will automatically fire the corresponding event when that element is clicked, with no JavaScript required.
Are custom events included in API responses?
Yes. The REST API lets you query custom event totals, breakdowns by page, and time-series data for any event you have defined.
Do I need to change my analytics configuration when I add a new goal?
No. You define the goal name once inside GhostlyX and fire the matching event from your code. There is no tag configuration, no manager interface to update, and no redeploy of a container required.
Start measuring what matters
Set up conversion tracking in minutes without touching your analytics configuration.