Analytics and Tracking

Custom Event

Also called user-defined event

An action you define and send to analytics yourself, because the platform does not collect it automatically.

Quick facts: Custom Event

Category
Analytics and Tracking
Also called
user-defined event
Level
Beginner
Affects
Conversion reporting, audience building, ad platform optimisation
Where to see it
GA4 (Admin, Events), Google Tag Manager, GA4 DebugView
In this article4
  1. How a custom event works
  2. Why custom events matter
  3. Where custom events go wrong
  4. How to act on it

How a custom event works

Analytics platforms collect a standard set of actions without being asked — a page loading, a file downloading, an outbound link being clicked. A custom event is one you define instead: you choose the name, you choose the parameters that travel with it, and you choose what has to happen on the page before it fires. Typical examples are a quote form submitted, a WhatsApp button tapped, a price list opened, or a video finished.

It reaches the platform the same way every other event does — through the site tag, through Google Tag Manager, or from your own server. Once it arrives it is treated no differently from a built-in event. The only thing that makes it custom is that you invented it. GA4 also publishes a list of recommended event names with expected parameters; if your action matches one of those, use the published name so the built-in reports recognise it rather than inventing your own.

Why custom events matter

Without them, analytics describes traffic rather than the business. Page views tell you where somebody went. A custom event tells you what they did when they arrived, which is the part a proposal, a budget decision or a bid strategy actually needs. On sites serving Nepal that gap is wide, because a large share of enquiries arrive as a phone tap or a WhatsApp message rather than a form submission, and none of that is collected by default.

Custom events are also the raw material for everything downstream. Audiences, key events and the conversions you send back to ad platforms are all built from events that already exist. If the action was never captured, no amount of reporting work will recover it later — the data simply is not there for the days before the tag went live.

Where custom events go wrong

The commonest failure is a name that only made sense on the afternoon it was created. Names like btn_click or event_two are unreadable a quarter later, and nobody can tell which button they refer to. Agree a naming pattern in lower case with underscores, write it down, and apply it to every property you own.

The second failure is packing detail into the name instead of into parameters. A separate event for every form on every page produces a long list of names that cannot be totalled or compared. One event with a parameter carrying the form name gives the same detail and still adds up. The third is quieter: a parameter that is never registered as a custom dimension is collected but never appears in standard reports, so people assume the tracking failed.

How to act on it

Start from the business, not the tag manager. Write down the actions that indicate someone is close to buying, decide which of them are worth counting, and only then build tags for those. Fire each one in a preview or debug view before publishing, and check both that it appears once and that its parameters carry the values you expect.

Then finish the job. Register the parameters you want to report on, mark the events that represent real outcomes as key events, and record what each event means in a short document a colleague could read. A tidy, documented GA4 and tag manager setup is what makes the rest of your reporting trustworthy.

Do and do not

Do

  • Agree one naming pattern and write it down
  • Put detail in parameters, not in the event name
  • Test in debug view before publishing the tag

Do not

  • Create a separate event for every button on the site
  • Assume a parameter shows in reports without registering it
  • Track an action nobody will ever make a decision from

Questions people ask about this

What is the difference between a custom event and a recommended event?

A recommended event has a name and parameter list published by Google for a common action, such as a purchase or a sign-up. Using the published name lets built-in reports and ecommerce features understand the data. A custom event is one you name yourself for an action with no published equivalent. Check the recommended list first, then invent a name only if nothing fits.

Do custom events cost anything to collect?

Collecting them in a standard analytics property carries no fee, but there are caps on how many distinct event names and parameters a property will accept, and the cap is enforced silently once you pass it. The real cost is maintenance: every event needs a trigger that still works after a site redesign, so keep the list short and deliberate rather than tracking everything.

Can I add custom events to data that has already been collected?

No. Events are recorded at the moment they happen, so a tag published today produces data from today onwards and nothing for the weeks before. This is why tracking is worth setting up before a campaign launches rather than after, and why a site migration should carry its tags across on day one instead of waiting for someone to notice the gap.

Related terms

Found this useful?

Share it, or ask an AI to summarise it

Back to the glossary

Knowing the term is the easy part

Applying it to your own site and budget is the work. Book a call and I will tell you what actually applies to you.