Home/Blog/Conversion Funnels/How to Name Tracking Events Before You W…
Conversion Funnels

How to Name Tracking Events Before You Write the First One

How to name tracking events: agree one shape for casing, word order and tense before the first event exists, since renaming later loses the history you need.

Cover of the FIKR Space guide: How to Name Tracking Events Before You Write the First One

To name tracking events well, decide one shape before you write the first event, with the same casing, the same word order and a single tense, and write it down. It is about fifteen minutes of agreement, and it prevents a mess that cannot be cleaned up afterwards.

Naming feels like a detail, so it is usually left to whoever writes the code on the day. That is exactly how funnels end up with several versions of the same thing. This post is only about the names. Which actions deserve an event at all, and how to check they fire, is covered in how to track funnel events.

How to name tracking events: treat the names as a schema

An event name is not a label for a human to read once. It is a key that every later report depends on. In effect the whole set of names is a schema, and a schema is about as forgiving as you would expect. If two records use different keys for the same thing, a system that groups by key will treat them as different things, and it will be correct to do so.

The guide shows the failure with a simple case. A codebase that emits signup_completed, SignupComplete and completed-signup is describing one moment in three ways. Each name produces its own series. No dashboard will ever reconcile them, because nothing in the data says they mean the same thing. The only link between them is a person who remembers.

What was emittedWhat the report sees
signup_completedOne series
SignupCompleteA second, unrelated series
completed-signupA third, unrelated series

Every one of them is a perfectly sensible name taken alone. The trouble only appears when they sit next to each other, which is why nobody notices it while writing any single event.

The three choices that make up a shape

A convention does not need to be long. The guide names three things to fix, and between them they remove most of the ways the same moment can be spelled differently.

  1. Casing. Pick one style and use it for every event. Whether it is lower, upper or mixed matters far less than the fact that it is the same everywhere.
  2. Word order. Decide whether the thing comes first and the action second, or the other way round, and keep that order every time.
  3. Tense. Past tense or imperative, but not both. An event records that something happened, so choose one voice and stay in it.

Take the three variants above and look at what differed. One put the thing before the action, and one put the action first. One was in past form and one was not. And their casing and separators all differed. Fixing those three choices is what would have collapsed them into one.

ChoiceThe question to answer onceWhat goes wrong if left open
CasingWhich style do we use?The same event appears under several spellings
Word orderThing first or action first?Related events cannot be found together
TensePast or imperative?Names read inconsistently and invite new variants
Free guide, 30 pages: The Funnel Playbook. Send me the guide.

Decide it before the first event, not after the tenth

Timing is the whole point. The convention has to exist before the first event is written, because the cost of changing it grows with every event that follows.

The reason is that renaming later loses the history. If you rename an event, the old name and the new name are separate series, and the data collected under the old one does not become part of the new one. You can no longer compare this month with last without stitching two series together by hand and hoping nobody forgets. In a funnel, where the first month of data is your clean baseline, that is a real loss.

That is why the guide calls it fifteen minutes of agreement that prevents a permanent mess. It is cheap at the start and expensive at every later point, and the price only goes one way.

Write it down where people will see it

An agreement that lives in someone's head is not an agreement. Write the shape down. The guide's checklist makes it a box you can tick: the event naming convention is written down and followed. Both halves matter. Written down means a new person can find it. Followed means somebody checks.

A convention can be a short note. It needs to say which casing you use, which word order, and which tense, and it should show the names of the events you already have so that the next person can see the pattern. Keep it where the work happens, so that anyone about to add an event meets it first.

How the funnel gives you the list of names

You do not have to invent the names from nothing. Your funnel is already a list of states, and the events are the ones that record a person reaching a state by doing something. If your steps look like the ones in how to define funnel steps, a few of them will be actions, and those are the events you need to name.

Go down the list and give each action step one name in your chosen shape. Because you have five or six steps, you are naming only a handful of events. That is a small enough job to do in a single sitting, and a small enough set that mistakes are easy to spot by eye.

Step as a stateIs it an action?Needs a named event?
ArrivedNo, it is a pageNo, use the page
Gave us their emailYesYes
Completed setupYesYes
Used it onceYesYes
PaidYesYes

Naming a few events well is far better than naming many events loosely. A short list also supports the aim of not over-instrumenting, because every extra event is another name that must follow the convention for as long as it exists.

FIKR Content, multi-channel publishing: reads, listens, opens, clicks in one dashboard. See FIKR Content.

Questions to ask before adding a new event

Once the shape exists, the discipline is about what happens next time someone wants to add something. A short set of questions keeps the convention alive.

  • Is there already an event that records this moment under a different name?
  • Does the proposed name use our casing, our word order and our tense?
  • Does it correspond to a step in the funnel, or is it coverage for its own sake?
  • Is it written into the convention note now, so the next person finds it?

The first question catches the most damage. Duplicate events for one moment are how three versions of a signup arrive, and they are almost always created by someone who did not know the first one existed. Asking before adding is cheaper than reconciling afterwards.

What a good convention does for your numbers

Consistent names do more than tidy a list. They make the counts trustworthy. When a step is measured by one event under one name, you can count cohorts through it without wondering whether a second spelling holds the rest of the people. The method of counting only people who completed the earlier steps, set out in funnel cohort analysis, depends on being able to tell who did what, and that depends on a name meaning one thing.

It also protects your baseline. You want a month of untouched data before you change anything, and a rename in the middle of that month damages the one clean read you will get. Settling the names first means the baseline is built on stable ground.

Free guide, 30 pages: The Funnel Playbook. Send me the guide.

If the names are already a mess

Some teams reach this post after the damage is done. If your events already exist under several spellings, the honest position is that the history under the old names cannot simply be merged by renaming. Decide the shape now, apply it to everything you write from today, and record clearly which old names map to which moment so that nobody mistakes them for different things.

Do not rename quietly and hope. A rename without a record produces a break in the series that nobody can explain a few months later. Whatever you decide, write it down.

FIKR Content, multi-channel publishing: reads, listens, opens, clicks in one dashboard. See FIKR Content.

Frequently asked questions

Does it matter which casing I choose?

Much less than being consistent. Pick one, use it for every event and write it down. The damage comes from mixing styles, not from any particular style.

Past tense or imperative?

Either works, but not both. Choose one and keep to it, so that the names read the same way and new events follow the pattern without argument.

Can I rename events later?

You can, but you lose the history, because the old and new names become separate series. That is why the convention is decided before the first event is written.

How long does this take?

About fifteen minutes of agreement. It is one of the cheapest pieces of funnel work and one of the hardest to repair if skipped.

The full method, with the checklists, is in The Funnel Playbook, a free 30-page playbook.

LG

Luis Goncalves

// Founder & CEO at FIKR Space

Three-time founder. Built and exited Evolution4All before this. Now building FIKR Space — the operating infrastructure underneath every innovation ecosystem (startups, accelerators, governments, investors). Lisbon-based, works global.

Claim your founding member spot.

Every founding member is hand-reviewed. Tell us who you are and how you want to co-create — we get back inside 48 hours.

Role
Job Title
Country
Cookies

We use cookies.

Essential ones keep the site working. The rest only run if you say so. No dark patterns, no pre-ticked boxes.Privacy policy

Co-create with us. It's about building it together.Co-Create With Us