◂ ALL DROPS
??REVOPSAIPORATEREVOPS · CHECKLIST1UP
REVOPS

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.

Mert, founder of AiporateMert · Founder, AiporateBUILDS THE SYSTEMS HE WRITES ABOUTMay 17, 2027·7 MIN READ·
SHARE𝕏 POSTin SHARE
FRAMEWORK-LEDNO FLUFFNO FAKE STATSBUILT BY OPERATORS
▸ TL;DR
  • 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.

▸ KEY TAKEAWAYS
  • 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.

▸ ONE PLAY A WEEK · FREE

Liked this? Get the next play in your inbox.

One signal-driven GTM play every week. No fluff, no spam, unsubscribe anytime.

Found this useful? Send it to a teammate.
SHARE THIS𝕏 POSTin SHARE

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.

Security & privacy ·SOC 2 Type IIISO 27001GDPR · DPA available
Plugs into the tools you already run ·HubSpotSalesforceClaySmartleadApolloGA4
▸ THE OFFER

Be the answer everywhere

SEO + AEO + GEO, built as one system.

Free AI-visibility scan ▸or book a call ▸
LIVE SITE SCAN · REAL · FREE

Can buyers and AI
actually find you?

Drop your website. We scan your live page and show the real SEO, AEO and GEO gaps that keep you invisible to buyers and AI search, in seconds. No signup to scan.

AIPORATE · LIVE SIGNAL SCANNERSTANDBY
1·SITE2·FETCH3·SEO4·AEO5·GEO6·SCORE7·PLAN
▶ DROP YOUR SITE  ·  WE SCAN IT LIVE  ·  SEE THE REAL GAPS  ·  SEO · AEO · GEO  ·  FREE  ·  ▶ DROP YOUR SITE  ·  WE SCAN IT LIVE  ·  SEE THE REAL GAPS  ·  SEO · AEO · GEO  ·  FREE  ·  

REAL PAGE CRAWL · NOTHING STORED · SEO · AEO · GEO IN ONE PASS