diff --git a/data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog.mdx b/data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog.mdx index b4b278c..9d6d2d9 100644 --- a/data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog.mdx +++ b/data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog.mdx @@ -78,8 +78,9 @@ models: - name: filter_condition description: > - The actual filter condition applied to the metric, if any. - NULL if no filter is applied. + Filter condition applied to the metric, if any. + Extracted from MetricFlow/dbt metric definitions. + NULL if no filter is applied (or if the filter cannot be extracted). - name: metric_time_grains description: > @@ -90,7 +91,7 @@ models: description: > Configuration for cumulative metrics: - "month", "quarter", "year" for grain-to-date (MTD, QTD, YTD) - - "30 day", "90 day", "365 day" for trailing windows + - "30 days", "90 days", "365 days" for trailing windows - "all_time" for unbounded cumulative from the beginning - NULL for non-cumulative metrics diff --git a/data-activation/data-tables/sm_utils/currency_conversion_rates_daily.mdx b/data-activation/data-tables/sm_utils/currency_conversion_rates_daily.mdx new file mode 100644 index 0000000..0c43fa3 --- /dev/null +++ b/data-activation/data-tables/sm_utils/currency_conversion_rates_daily.mdx @@ -0,0 +1,14 @@ +--- +title: 'currency_conversion_rates_daily' +sidebarTitle: 'currency_conversion_rates_daily' +description: 'Daily foreign exchange rates used for currency normalization.' +icon: 'table' +--- + +## Overview + +`currency_conversion_rates_daily` provides daily FX rates used to convert amounts to a standard currency (typically USD) for cross-market reporting. + +## Common uses + +- Converting `order_*` revenue fields to a standardized currency for aggregated reporting diff --git a/data-activation/data-tables/sm_utils/dim_dates.mdx b/data-activation/data-tables/sm_utils/dim_dates.mdx new file mode 100644 index 0000000..926a082 --- /dev/null +++ b/data-activation/data-tables/sm_utils/dim_dates.mdx @@ -0,0 +1,15 @@ +--- +title: 'dim_dates' +sidebarTitle: 'dim_dates' +description: 'Date spine + date attributes used for time-based analysis.' +icon: 'table' +--- + +## Overview + +`dim_dates` is a shared date dimension used for consistent week/month/quarter/year rollups and “to-date” calculations. + +## Common uses + +- Joining daily fact tables to derive `week_start_date`, `month_start_date`, `quarter_start_date` +- Time-series charting and period comparisons diff --git a/data-activation/data-tables/sm_utils/geo_countries.mdx b/data-activation/data-tables/sm_utils/geo_countries.mdx new file mode 100644 index 0000000..828c34a --- /dev/null +++ b/data-activation/data-tables/sm_utils/geo_countries.mdx @@ -0,0 +1,14 @@ +--- +title: 'geo_countries' +sidebarTitle: 'geo_countries' +description: 'Reference table for country codes and names.' +icon: 'table' +--- + +## Overview + +`geo_countries` is a shared reference table for country names and codes. + +## Common uses + +- Normalizing country fields from different source systems diff --git a/data-activation/data-tables/sm_utils/index.mdx b/data-activation/data-tables/sm_utils/index.mdx new file mode 100644 index 0000000..403db30 --- /dev/null +++ b/data-activation/data-tables/sm_utils/index.mdx @@ -0,0 +1,16 @@ +--- +title: 'sm_utils' +sidebarTitle: 'sm_utils' +description: 'Utility tables shared across reporting (dates, FX rates, geo).' +icon: 'database' +--- + +## Overview + +`sm_utils` contains shared utility tables used across multiple reports and analyses. These tables are designed to be broadly reusable and stable. + +## Tables + +- [`dim_dates`](/data-activation/data-tables/sm_utils/dim_dates) — Date spine + common date attributes (week/month/quarter starts, etc.) +- [`currency_conversion_rates_daily`](/data-activation/data-tables/sm_utils/currency_conversion_rates_daily) — Daily FX conversion rates +- [`geo_countries`](/data-activation/data-tables/sm_utils/geo_countries) — Country reference data diff --git a/docs.json b/docs.json index 22603f4..2406f62 100644 --- a/docs.json +++ b/docs.json @@ -597,6 +597,15 @@ "data-activation/data-tables/sm_metadata/dim_semantic_metric_catalog" ] }, + { + "group": "Utility Tables", + "pages": [ + "data-activation/data-tables/sm_utils/index", + "data-activation/data-tables/sm_utils/dim_dates", + "data-activation/data-tables/sm_utils/currency_conversion_rates_daily", + "data-activation/data-tables/sm_utils/geo_countries" + ] + }, { "group": "Experimental Tables", "pages": [ diff --git a/onboarding/data-docs/metrics.mdx b/onboarding/data-docs/metrics.mdx index ad4ec75..76a818d 100644 --- a/onboarding/data-docs/metrics.mdx +++ b/onboarding/data-docs/metrics.mdx @@ -116,7 +116,7 @@ These metric names are maintained for backward compatibility. **Always use the p | `ctr` | `click_through_rate` | Click-Through Rate | | `cpo` | `cost_per_order` | Cost Per Order | | `cvr` | `conversion_rate` | Conversion Rate | -| `cpa` | `customer_acquisition_cost` | Cost Per Acquisition (same as CAC) | +| `cpa` | `customer_acquisition_cost` | Cost Per Acquisition (often used similarly to CAC; confirm your internal definition) | ### AOV Variants