Create a latency dimension

Last update: 2022-10-04
  • Created for:
  • User
    Admin
IMPORTANT

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

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

  1. 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
    
  2. 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...

    Name

    Optional. The name of the latency dimension that appears in the context menu when you right-click the dimension label or elements.

    Level

    A countable dimension that is the parent of the latency dimension. Examples include Session, Visitor, and Page View.

    Clip

    A 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.

    Time

    The 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.

    Format

    Optional. Specifies the appearance of the latency visualization in Data Workbench. Within the Format parameter, you can edit the following values:

    • 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.

    Time Before

    The 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 After

    The maximum amount of time (expressed in the units of the Time dimension) after the event for which latency is calculated.

  3. 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: 7
    

    In 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
    

On this page