Lexicon

Lexicon is the dictionary of your data: what each event and property means. Every picker in ClickClacks reads from it, so an hour spent here makes every report easier for the whole team.

Updated

When to use it

  • New teammates keep asking what ob_step_3 means.
  • Two names for the same thing crept in, such as Signed Up and signup_completed.
  • Old test events clutter every picker.

Browse your data

Open Lexicon under Data. It has three tabs: Events, Event properties and Person properties. Each tab lists the name, a description, how much it is used (events in the last 30 days, or the share of recent events for a property), when it was first and last seen, and where it is used.

Search matches names, descriptions and tags. Filter by All, Verified, Not verified or Hidden, or click a tag to show only items with it.

Describe, tag, verify, hide

Click a row to open it:

  • Description: up to 500 characters. It saves when you leave the field, or with ⌘/Ctrl + Enter.
  • Tags: up to 10 short, lowercase tags, such as onboarding or billing. Press Enter or a comma to add one.
  • Verified: pickers show a check next to it, so people know it is the right one to use.
  • Hidden: left out of pickers. Reports that already use it keep working.
  • Used in: links to every saved funnel, insight, retention definition, board, experiment, alert and segment that names it.

Property types

Each property shows an inferred type, such as Inferred · Text. Set it to Number, Text, True / false or Date if the guess is wrong. The type decides which filter operators are offered. A number property gets greater than, less than and between, and a date gets before and after.

Merge duplicate events

On an event, under Merged names, use Merge another event into this one. From the next refresh, reports count the merged name as this event, and pickers show one entry with a +1 merged chip.

Stored events keep their original names, so Unmerge restores everything exactly. System events can’t be merged.

What changes in pickers

  • Hidden events and properties drop out. One you had already picked stays.
  • Merged names fold into their main event.
  • Verified items show a check, and properties show a type glyph.
  • Descriptions appear as a second line or a tooltip, and search matches them.

This applies to the event pickers in Insights, Funnels, Events and segments, and to the property filter builder.

Tips and gotchas

  • Lexicon doesn’t rename events. To fix a name at the source, change what your code sends, then merge the old name into the new one.
  • Start with the busiest events. Describe and verify the ones with the most activity in the last 30 days first.

Recipes

Clean up two names for sign-up.

  1. Open Lexicon › Events and search sign.
  2. Open the name you want to keep, such as Signed up.
  3. Under Merged names, merge signup_completed into it.
  4. Turn on Verified and add a description: Fires once, when the account is created.

Hide test events from everyone’s pickers.

  1. Search for test.
  2. Open each test event and turn on Hidden.
They disappear from pickers. Any report that already used them keeps working.

Make “seats” filterable as a number.

  1. Open Event properties (or Person properties) and find seats.
  2. Set its type to Number.
Filters on seats now offer greater than, less than and between, so Seats > 50 works.

Related