Syntax for identifiers


Read more about Data Workbench’s End-of-life announcement.

Metric, dimension, and filter expressions can use identifiers to refer to named metrics, dimensions, and filters.

These identifiers are case sensitive and must be typed exactly as they are defined.

A valid identifier can contain one or more of the following:

  • Underscores (_). Underscores in an identifier represent spaces in the metric, dimension, or filter name. For example, the Session Referrer dimension would be referred to as Session_Referrer in an expression.
  • Percent signs (%)
  • Upper case letters (A-Z)
  • Lower case letters (a-z)
  • Dollar signs ($)
  • Numbers (0-9), except as the first character in an identifier.
  • Non-ASCII characters

All other characters are illegal in an identifier.

These same rules apply to the names of metrics, dimensions, and filters when they are used outside of expressions, except that the names can contain spaces but not underscores. For example, you can define the Session Referrer dimension in the Transformation.cfg file as Session Referrer, but not Session_Referrer.

On this page