Join declared metadata to reporting codes to display labels such as Tablet or Germany.
These views contain configuration and built-in definitions, never observed traffic or counts.
Administrators publish them with app:analytics:glossary:sync after migrations
or metadata changes, or save through Reporting → BI glossary.
Approved glossary view contracts
| View | Join key and purpose |
bi_dim_event_name_v1 | event_name; declared event labels. |
bi_dim_goal_event_v1 | goal_event; configured goal labels. |
bi_dim_referrer_channel_v1 | referrer_channel; all built-in channel codes. |
bi_dim_device_class_v1 | device_class; all five device codes. |
bi_dim_viewport_bucket_v1 | viewport_bucket; all viewport codes. |
bi_dim_geo_area_v1 | geo_area; all continents and countries, plus geo_level. |
bi_dim_website_token_v1 | website_token; registered website names and domains, plus declared labels. |
bi_glossary_values_v1 | Filter to one dimension and locale, then join code to the fact's code column. |
bi_glossary_columns_v1 | Filter by object_name and locale for column labels and definitions. |
The six dimension views have one row per code in the deployment's default locale, with
prefixed fields such as device_class_label and device_class_sort.
Relate each one many-to-one to the matching fact column and display the label. For translated
labels, filter bi_glossary_values_v1 to one dimension and one published locale before
joining; joining all locales multiplies fact rows.
Use a left join and keep the original code when a label is missing: undeclared event names,
deleted goals, and the synthetic country:other/continent:other pools
have no dimension row.
SELECT f.event_day, f.goal_event,
COALESCE(d.goal_event_label, f.goal_event) AS goal_label,
f.event_count
FROM bi_anonymous_goals_v1 f
LEFT JOIN bi_dim_goal_event_v1 d ON d.goal_event = f.goal_event;
Power BI and Tableau steps, locale parameters, and column lists
(opens in a new tab)
Labels, descriptions, and declared codes are published to routine BI readers; keep them
free of personal or identifying text. Declaring values for consent-gated properties publishes
those codes even when their event values remain private. Glossary joins do not restore
withheld cells: sums by group still undercount. Column descriptions for private custom views
do not grant access to those facts. Keep the hourly, goal, and geography facts separate.