Create a latency dimension
Latency dimensions are constructed from a parent countable dimension, such as Sessions, and a time dimension, such as Day.
When you create a latency table in Data Workbench, you automatically add a latency dimension to the visualization file (.vw). You can edit a table’s latency dimension by following the steps below.
To edit a latency dimension
- Open the latency table that you created in a text editor such as Notepad. It is located in the User > working profile name > Work folder within your Data Workbench installation directory.The defined latency dimension includes the parameters shown in the following example. (The definition of your latency dimension may include additional parameters.) The line entity = LatencyDim: indicates the start of the latency dimension’s definition.
entity = LatencyDim: Name = string: dimension name Level = ref: wdata/model/dim/level Clip = ref: wdata/model/dim/clip Time = ref: wdata/model/dim/time dimension Format = printf_format: format = string: %+0.0f time string offset = double: offset Time Before = int: time before Time After = int: time after
- Edit the values for the Name, Level, Clip, Time, Format, Time Before, or Time After parameters using the following table as a guide:
For this parameter... Provide this information...NameOptional. The name of the latency dimension that appears in the context menu when you right-click the dimension label or elements.LevelA countable dimension that is the parent of the latency dimension. Examples include Session, Visitor, and Page View.ClipA countable dimension that has a one-to-many relationship with the level of the latency dimension. Latency is not calculated across the boundaries of this dimension. For example, if you specify a level of Page View and a clip of Session, latencies are calculated for those page views that occurred during the same session as the event.For information about one-to-many (simple) dimensions, see the Dataset Configuration Guide .TimeThe dimension used to measure elapsed time for the latency dimension. This dimension can be a time dimension, such as Day or Hour, or a countable dimension, such as Visitor, Session, or Page View. FormatOptional. Specifies the appearance of the latency visualization in Data Workbench. Within the Format parameter, you can edit the following values:
Time BeforeThe maximum amount of time (expressed in the units of the Time dimension) before the event for which latency is calculated. If this value is set to 0 or not set at all, latency is calculated only for the forward direction.If you change this value, be sure to change the offset value in the Format parameter: The offset is the negative of the value for Time Before.Time AfterThe maximum amount of time (expressed in the units of the Time dimension) after the event for which latency is calculated.
- Time string. The unit of time shown in the latency visualization, such as day or week. Be sure to change the time string when you change the time dimension.
- Offset. A whole number that is equal to the negative of the value for Time Before. For example, if Time Before is 7, the offset should be -7.
- Save the .vw file to the User*working profile name*\Work folder.Following are the settings for the default latency dimension:
entity = LatencyDim: Name = string: Level = ref: wdata/model/dim/Session Clip = ref: wdata/model/dim/Visitor Time = ref: wdata/model/dim/Day Time Before = int: 7 Time After = int: 7In the following latency dimension, the latency of each session event is calculated in hours and Time Before is set to zero. Therefore, latency is calculated for only those sessions that occurred within 24 hours after the defined event.
entity = LatencyDim: Name = string: Level = ref: wdata/model/dim/Session Clip = ref: wdata/model/dim/Visitor Time = ref: wdata/model/dim/Hour Time Before = int: 0 Time After = int: 24