You can create or edit dimensions through the Dimensions tab.

• Saving a draft saves the item to the session cache on the server. Changes must be committed before they are applied to the incoming session data.
• If you enabled automatic creation of Top Movers, a Top Mover is immediately created and enabled to track changes in values for your new dimension after your changes are committed to the server. Depending on the type of dimension, you might want to disable this Top Mover.
• For dimensions provided by Tealeaf, you may edit the following properties: Values to Record and Allow Empty Values.

The following list describes some of the available properties:

Fixed WhiteList

Select this option to limit the whitelist to a fixed set of values.

Populated By

Select the event, hit attribute, or session attribute whose value populates this dimension:

• Events - The No Dimension Report Group fact for the event is used to populate the dimension.
• Hit Attributes - Tealeaf and user-defined hit attributes are available.

  Note: Hit attributes that match on fixed text strings, such as those created in BBR, cannot be used as the source for a dimension because they can only return the fixed text string. These hit attributes are filtered from the available selections.

• Session Attributes - Tealeaf and user-defined session attributes are available.

You can also use step attributes as the source of your dimensions.

Dimension values can be up to 450 characters in length. Values that are longer than this limit are truncated, which may impact dimensions populated by hit attributes that match long character strings in the session data.

Populated With

Select the value to populate in the dimension:

• First Value - First value on the hit (hit attribute source) or session (event or session attribute source)
• Last Value - Last value on the hit (hit attribute source) or session (event or session attribute source)
• Current Count in Session - (event source only) Current count of the event occurrence in the session

Default Value

• If Values to Record is set to Whitelist + Observed Values and the observed value is on the blacklist, the observed value is not recorded and is instead added to count of instances of the default value.
• If Values to Record is set to Whitelist Only or configured to use a Group List and the observed value is not covered by the settings, the observed value is not recorded and is instead added to count of instances of the default value.

Max Values Per Hour

If desired, you can specify a maximum number of values per Canister to capture and report for this dimension for each hour.

• Whitelisted and blacklisted values do not count against this limit.
• Depending on the type of dimension, this value may be applied in different ways.

Allow Empty Values

When this option is selected, empty dimension values are permitted.

If the source value is a null value and this option is selected, the defined [Empty] value is assigned. Otherwise, null values result in [Null] value assignments.

Set Value Display Order

When selected, values in the whiteslist or groups lists are displayed in the order specified in the Report Builder. You may re-order the displayed whitelist using the up and down arrow keys in the Whitelist or Group List editors.

The display order is not applied if Value to Record is set to Whitelist + Observed.

Evaluated At

This setting is available only if you have licensed cxOverstat.

By default, all dimensions are evaluated immediately. When the event is triggered, the current value for the dimension is immediately recorded. For cxOverstat, you can optionally configure a dimension to be evaluated at the end of the session, at which time previous occurrences of the dimension are backfilled with the last recorded dimension value for the session.

Dimensions populated by hit attributes cannot be configured to be published at the end of the session. If you choose the End of Session option, the dimension must be populated by an event or a session attribute. You cannot populate the dimension from a hit attribute.

Note: After you save your event definition, you cannot change this setting. In almost all cases, set this value to Immediate.

Reset Trim Flag

To prevent runaway growth of observed values for a dimension, Tealeaf imposes an upper limit on the number of values that can be stored in the database. When this limit is reached, the Data Collector automatically trims values, and the Portal inserts a warning message that the dimension values have been trimmed when the dimension is used in a report.

If your dimension values have been trimmed, you should review the reporting results. You can reset this trim flag, which removes the message from display in the Report Builder.