Where vocabularies come from
Every vocabulary on Relay > Taxonomy is a Terrain dictionary definition that lists approved values, the same record Lens binds metrics to. Terrain owns the definition, the values, the owner and the version history. Adding a value is a proposal in Terrain that its owner agrees, not an edit made in Relay. Click Open in Terrain to go there.
A definition with no approved values is not shown, because it cannot govern anything.
The Taxonomy page
| Tile | Counts |
|---|---|
| Vocabularies | Vocabularies for the company |
| Approved values | Values across every vocabulary |
| Never used | Approved values carried by no link |
| Not yet agreed | Vocabularies still in review in Terrain |
Each vocabulary row shows its name, the parameter it governs (for example utm_medium), its status, Closed list or Open list, up to eight values (unused ones are marked), the owner, the Terrain version, when it was agreed, and how many values were never used. The Taxonomy analytics panel lists findings with a severity of Error, Warning or Note.
Closed and open lists
| List | A value not on it |
|---|---|
| Closed list | Is rejected. The link cannot be saved |
| Open list | Is allowed with a warning that nobody has agreed it, so the owner can see what people type before deciding whether to adopt it |
Where a near match exists, the message suggests it. A vocabulary that is not yet agreed in Terrain still accepts its values, with a warning that they are not reportable until the owner agrees them.
Scope
Vocabularies are held at company level, so a value such as paid_social means the same thing on every property. A property can override one vocabulary where it genuinely differs, for example a regional site with its own product lines. The override is a Terrain variant of the company list.
One vocabulary
Click a vocabulary to open it.
- Approved values: each value with its label and notes, a usage bar, the number of Links carrying it, and when it was Last used. Unused values are marked Never used.
- Definition: the description, Parameter, Scope (Company-wide or Property override), List type, Owner, Status, Version and Agreed date.
- Governed in Terrain: the Terrain definition's name, with Open the definition. Click Edit in Terrain to propose, agree or change values.
How vocabularies are applied
A vocabulary governs a parameter only when a template field is bound to it. A field with no vocabulary is free text and is checked for casing and length only. Bulk generate picks sources and mediums from the vocabularies for utm_source and utm_medium.