Definitions and synonyms
Metrics and dimensions, the business’s own terms, and other names for them.
Metrics and dimensions
They come from where your metrics are defined, and are read-only here: their meaning and other names belong to that source. Write context about them instead.
A line under the toolbar says which tool they come from and links to it in Integrations. When the tool has figures switched on, an info button at the end of the line names the data contact who hears about a figure that looks wrong.
A read makes a name for each new one, and it reaches Definitions once its owner publishes it on the Names card in the Inbox. An admin publishes a name that belongs to no domain. See Set up your workspace.
What a metric is built from
A metric’s page says what it is built from, as its source’s structure says it, under its description:
- Built from: the metrics it takes, such as a ratio’s two, each a link to its page, and the columns its calculation reads, by name.
- Used by: the metrics built from it.
- Converted from and Converted to: a metric in another currency, worked out from the other with one more column, such as
exchange_rate_usd.
These come from the source at each read and are never edited here. They never show the calculation, and never mark context as due for a check. An input the source no longer has says so.
Families
A family is one entry for many near-identical metrics, such as a metric for each currency and channel. Its row shows a stack of tiles, Family · 250 variants, and what tells them apart, such as by Currency and Channel.
- Its variants are never rows of their own. A search for one finds its family, and says how many variants match.
- Its quick view and page say what the family means, and where those words come from. Words your tool writes for the family come first. Else it takes the words most variants share, with each value shown as what it stands for, such as Currency. Else it takes the words of the variant the others are converted from.
- An owner of its domain, or an admin, can choose Change: one variant’s words, or words written for the family. History keeps each choice. Variants whose own words say something else are named, and agents read their words too.
- Its own page lists the variants, and narrows them by each value, such as Currency: EUR. It says how the family was found, such as declared in dbt, and which variant is converted from which.
- Context about the family applies to every variant. See Variants: a dimension, not a metric each.
Terms and synonyms
Another name for a metric or a dimension, such as GMV for Gross sales. Agents read it as that definition.
- A term is a word with its own meaning, such as Peak season.
- On a definition, type other names into Another name: a comma or Enter makes each one a tag.
- In a term’s editor, Another name for points the word at a metric or a dimension.
- A word that already means something else says who has it, and is never saved twice. Case, spaces and accents don’t make it another word: Salés is Sales.
- A word that looks like one in use, such as Sale beside Sales, only warns. Agents read them as two words, so you can still publish it.
- If a definitions tool later gives a word a second meaning, the word shows a conflict. Agents ask which one until it’s settled.