The Marketing Data Dictionary: Define Metrics Once So Meetings Stop Relitigating Them
How to build a marketing data dictionary: canonical metric definitions with formulas, sources, and owners, so every dashboard and meeting uses the same numbers.
- Most dashboard disagreements are definition conflicts, not data quality problems.
- A useful entry specifies formula, source system, filters, time basis, limitations, and a single owner.
- Link definitions from the dashboards and reports themselves; adoption happens at the point of consumption.
- Version definition changes with dates and restatement decisions, or you manufacture fake trend breaks.
The argument is about definitions wearing a data costume
The recurring meeting scene where marketing's lead count differs from sales' lead count is almost never a data quality problem, it is a definition problem. One dashboard counts form submissions, another counts CRM records created, a third counts records that passed qualification, and all three present their number under the label leads. Each is internally correct, mutually contradictory, and the meeting burns twenty minutes relitigating a question that should have been settled once in writing.
The tell that you need a dictionary is exactly this repetition: the same definitional dispute resurfacing across meetings with slightly different combatants. Every hour spent arguing about what counts as an MQL, whether pipeline means created or open, or which conversion rate is the conversion rate, is an hour the dictionary would have refunded.
What a real definition contains
A dictionary entry that actually settles arguments has more than a name and a sentence. It states the formula in operational terms, the exact system and field the inputs come from, the filters applied, such as excluding internal domains or test records, the time basis, meaning whether events are counted by created date or closed date, and known limitations someone will otherwise rediscover in a meeting. It also names an owner, the single person with authority to change the definition, because a definition nobody owns is a definition everyone quietly forks.
Write entries at the altitude of the disputes. The metrics worth defining first are not the exotic ones but the load-bearing common words: lead, MQL, SQL, opportunity, pipeline created, win rate, CAC, and the conversion rates between stages. In most organizations fewer than two dozen entries cover the surface area of ninety percent of the arguments, which is why this is an achievable document and not a boil-the-ocean project.
Put it where the numbers appear, not where documents sleep
A dictionary in a forgotten folder changes nothing; adoption comes from placing definitions at the point of consumption. Link the entry from the dashboard tile, the report header, and the spreadsheet column, so the person about to dispute a number is one click from its formula, filters, and known caveats. Teams running a warehouse and BI layer can go further by encoding definitions directly into a shared metrics or semantic layer so every downstream tool computes the same figure from the same logic, but the linked document alone captures most of the value at a fraction of the effort.
Adoption also needs one social rule with teeth: dashboards and decks that display a defined metric must use the defined version or visibly label the variant. The moment leadership starts asking is this the dictionary definition in reviews, the dictionary stops being documentation and becomes the terrain.
Handle changes like migrations, not edits
Definitions legitimately evolve, and the dictionary must make evolution safe rather than pretending it will not happen. When a definition changes, version it: record the old and new definitions, the change date, the reason, and whether historical values were restated or left as-is, because a silent mid-year definition change manufactures a fake trend break that someone will later analyze as a real one. The owner communicates the change to everyone consuming affected reports before dashboards flip, not after.
Review the dictionary on a light cadence, quarterly is plenty, to catch definitions that drifted from practice and disputes that reveal a missing entry. The maintenance burden is genuinely small, a few hours a quarter, which buys back the meeting hours currently spent relitigating settled questions and, more valuably, restores the default assumption that when two numbers differ, one of them is wrong rather than both being right in different languages.
- Most dashboard disagreements are definition conflicts, not data quality problems.
- A useful entry specifies formula, source system, filters, time basis, limitations, and a single owner.
- Link definitions from the dashboards and reports themselves; adoption happens at the point of consumption.
- Version definition changes with dates and restatement decisions, or you manufacture fake trend breaks.
Frequently asked questions
What is a marketing data dictionary?
A marketing data dictionary is a maintained document or metrics layer that gives each important metric one canonical definition: its formula, the exact source system and fields, applied filters, time basis, known limitations, and a named owner. Its purpose is to ensure every dashboard, report, and meeting uses the same number for the same word.
Which metrics should a data dictionary define first?
Start with the load-bearing common words that generate recurring disputes: lead, MQL, SQL, opportunity, pipeline created, win rate, CAC, and stage-to-stage conversion rates. In most organizations, fewer than two dozen entries cover the vast majority of definitional arguments, so the initial version is an afternoon of workshops, not a quarter-long project.
How do you get a team to actually use a data dictionary?
Place definitions at the point of consumption by linking entries from dashboard tiles, report headers, and spreadsheet columns, and establish the rule that displayed metrics either match the defined version or visibly label the variant. Adoption solidifies when leadership routinely asks whether a presented number uses the dictionary definition.
What happens when a metric definition needs to change?
Treat it like a migration: record the old and new definitions, the change date, and the rationale, decide explicitly whether historical values are restated or left as-is, and notify consumers of affected reports before dashboards change. Silent definition changes create artificial breaks in trend lines that get misread as real performance shifts.
Liked this? Get the next play in your inbox.
One signal-driven GTM play every week. No fluff, no spam, unsubscribe anytime.
Operator-built
Built by someone who runs the playbook, not an agency reselling labor.
You own it
Your data, your CRM, your infrastructure. The system is yours.
No lock-in
Start with a free audit. No multi-month retainer to find out it works.
Privacy-first
Your data stays yours. We pen-test our own funnel before we touch yours.
