Platform

Marketing semantic layer for governed metrics and exports

Metric Hive treats the semantic layer as the product contract. Source data is mapped into canonical marketing and commerce entities with explicit grain, date semantics, currency behavior, aggregation rules, and query guardrails before it reaches dashboards or exports.

Canonical entities Accounts, sources, campaigns, ads, orders, order lines, products, customers, and dates are modeled as shared business concepts.
Metric grain Additive, derived, and non-additive metrics carry the grain and aggregation behavior needed for safer reporting.
Governed outputs Dashboards, query datasets, and exports use approved fields instead of frontend-only SQL or raw table assumptions.
Semantic contracts

Definitions that travel with the data

The semantic layer makes business meaning explicit before data is queried. That reduces dashboard drift and keeps exports aligned with the same canonical definitions.

Canonical entities

Metric Hive maps source-specific records into stable business entities such as campaign, ad, product, order, order line, customer, source account, and reporting date.

UseKeep cross-source analysis anchored to shared concepts.
GuardrailProvider-native fields stay labeled so source context is not lost.
CampaignsOrdersProducts

Metric grain

Metrics are modeled at the level where they are true, such as campaign-day, ad-day, order, order line, customer-day, or cohort.

UsePrevent unsafe joins between incompatible levels of detail.
GuardrailRatios and rates should be recomputed from governed inputs where possible.
AdditiveDerivedNon-additive

Date semantics

Marketing, commerce, and finance data can use different date bases, including impression date, click date, order date, refund date, and generated date.

UseMake period comparisons explainable and repeatable.
GuardrailReports should label the date basis behind revenue, refunds, cost, and performance metrics.
Order dateEvent dateFreshness

Currency semantics

Spend, revenue, fees, COGS, and profit need an explicit currency policy before they can be safely aggregated.

UseKeep totals honest when accounts, stores, or countries use different currencies.
GuardrailMixed-currency totals should be grouped or converted under a stated policy.
SpendRevenueProfit
Query safety

Approved fields instead of ad hoc logic

Frontend surfaces request approved dimensions, metrics, filters, views, and export modes. Backend query services keep table names, joins, tenant scope, and metric relationships behind governed contracts.

Field approval

Datasets expose fields that have semantic metadata, including the entity, grain, metric behavior, and source capability needed to use them.

Aggregation checks

Metrics such as ROAS, margin rate, CPA, CAC, reach, users, and LTV need denominator and grain rules before they are compared or rolled up.

Tenant scope

Account and subscription identity should come from backend authorization and scoped services, not from browser-provided table names or identity fields.

Exports

Modeled data for BI and downstream reporting

The same semantic contracts support product dashboards and external destinations. Exported data is intended to be modeled and named clearly enough for BI tools, spreadsheets, and warehouse workflows.

BI-ready datasets

Expose governed dimensions and metrics for reporting instead of forcing BI users to rebuild metric definitions from raw connector tables.

Destination consistency

Looker Studio, CSV, spreadsheet, and warehouse destinations should receive the same approved field names, grains, and caveats.

Source traceability

Modeled outputs retain source and account context so teams can inspect provenance when a metric needs explanation.

FAQ

Semantic layer questions

The goal is not only cleaner naming. It is safer analysis across connectors, datasets, dashboards, and exports.

What is a marketing semantic layer?

A marketing semantic layer defines canonical entities, dimensions, metrics, grains, and guardrails so reports and exports use the same business definitions.

Why does metric grain matter?

Metric grain states the level where a row is true, such as campaign-day, order, order line, customer, or cohort. Unsafe joins and aggregations usually start with mixed grains.

Can semantic data be exported?

Metric Hive exposes governed datasets for dashboards, BI, and exports so downstream tools can use modeled fields instead of raw source fragments.