Naming Conventions
Metric Columns
Overview
A metric will always consist of an entity
(e.g. order, customer), dimension
, and in some cases, a modifier
.
To make column names more human readable, our naming conventions will always keep the entity
and the metric
next to each other,
as the combination of the two represents the majority of what you’re looking for when locating a metric or typing a metric in a query.
From there, any relevant entity modifiers will appear before the metric, as this context is critical for understanding the meaning of the
entity_metric
combination.
Metric column name formula
{{ modifier }}_{{ entity }}_{{ metric }}
Examples of metrics without modifiers
order_gross_revenue
whereorder
is theentity
andgross_revenue
is themetric
order_net_revenue_before_refunds
whereorder
is theentity
andnet_revenue_before_refunds
is the metric
Examples of metrics with modifiers
new_customer_order_net_revenue
whereorder
is theentity
,net_order_revenue
is themetric
, andnew_customer
modifies thisentity_metric
combinationrepeat_customer_order_count
whereorder
is theentity
,count
is themetric
, andrepeat_customer
modifies thisentity_metric
combination
Was this page helpful?