Custom dimensions and Explore

Custom dimensions turn selected event and user properties into indexed reporting fields. PureStats keeps the original event properties compatible, but only properties you explicitly define are indexed for filters and reports.

Create a dimension#

Open Site settings → Custom dimensions, then provide a label, property key, scope and value type.

• Event stores the value for the pageview or event carrying the property.
• Session applies the latest supplied value to the current session.
• Visitor uses properties passed to identify() and follows the pseudonymous visitor identity.

Supported value types are string, number, boolean and date. Existing event properties are backfilled in the background and the setup screen shows the backfill state.

PureStats rejects property keys commonly associated with personal data, including names, email addresses, phone numbers, postal addresses and IP addresses. Do not place personal data in values either.

Send properties#

Event properties use the normal event API:

purestats('Signup Completed', {
  account_type: 'customer',
  seats: 12
})

Visitor properties are sent with an opaque user ID:

purestats.identify('internal-user-42', {
  account_type: 'customer',
  trial_active: false
})

Filter and explore#

Configured dimensions appear in the common analytics filter dialog. They work with overview reports, saved segments, custom dashboards, funnels, exports and the Stats API.

Open Analytics → More → Explore to combine a metric, dimension, period, comparison and filters. Saved reports remain private to your account and site.

The Stats API endpoint GET /api/stats/custom-dimensions returns active definitions and their most common values for a selected period.