What is a tracking specification?

A tracking specification (tracking spec, or solution design reference) is the document that defines exactly what analytics data a digital experience must collect: which events fire on which interactions, with which parameters, mapped to which schema fields in your analytics stack (such as Adobe XDM/AEP or GA4). It is the contract between the people who need the data and the people who implement the tracking — and when it is missing or stale, every downstream number is a guess.

What a good spec contains

For each step of a user journey, the spec names the events (page views, clicks, form submissions, transactions), the parameters each event carries (page identifiers, product details, campaign context), the schema mapping in the target stack, and the conditions under which each fires. Good specs are written against the actual journey — screen by screen — not against an abstract list of "things we might want".

Why specs rot

Specs are traditionally spreadsheets in shared drives — and spreadsheets fork. The site changes, a release renames a parameter, a second analyst saves "spec_final_v3", and within two quarters nobody can say which version is live. The failure mode is quiet: dashboards keep rendering, numbers drift, and the error is discovered only when two reports disagree in front of leadership.

The fix is treating the spec like code: one current version, changes as reviewed revisions, named approvals, and a history that explains every change.

Validation: testing the site against the spec

A spec that is not tested against reality is documentation, not governance. Validation exercises the live experience and compares what actually fires — event by event, parameter by parameter — against what the spec requires, producing a gap report someone can be assigned. Run after every release, validation turns tracking regressions from a quarter of silently wrong data into a bug fixed in days.

OmniSpec, Cresia’s analytics governance product, covers this loop end to end: specs drafted from journey screenshots, versioned with approvals like code, and validated against the live site on demand.

Who should own the spec

The analytics or marTech team owns the artifact, but its consumers are everyone: implementation engineers build against it, QA verifies against it, and every marketer whose dashboard depends on the data has a stake in it being current. That is exactly why it needs to live in a governed system rather than a personal drive.

Common questions

Is a tracking spec the same as a tag management plan?

They overlap but differ in altitude. The spec defines what data must be collected and how it maps to your schemas; the tag plan describes how tags are deployed to do it. The spec is the contract; tagging is one implementation of it.

How often should tracking be validated?

After every release that touches the experience, and on a regular cadence besides. Tracking breaks when sites change — validation is how you find out in days instead of quarters.

What does "schema mapping" mean in practice?

Naming exactly where each parameter lands in your analytics stack — an XDM field path in Adobe AEP, or an event parameter in GA4 — so implementation is unambiguous and reports mean what they say.

Keep learning

See the platform behind the practice.

Cresia puts creative, experiments, media and measurement in one workspace.

Request a demo