Persistence component settings

Persistence is the ability for a given dimension value to relate to a metric beyond the event it is set on. It uses a combination of allocation and expiration.

  • Allocation lets you determine which value is kept when more than one dimension item can persist at a time in a single column.
  • Expiration lets you determine how long a dimension item persists beyond the event it is set on.

Persistence is available only on dimensions, and is retroactive to the data it is applied to. It is an immediate data transformation that happens before filtering or other analysis operations are applied.

Persistence

Setting Description
Set persistence Enable persistence for the dimension. If persistence is not enabled, the dimension only relates to metrics that exist in the same event. This setting is disabled by default.
Allocation Lets you specify the allocation model used on a dimension for persistence. Options are: Most recent, Original, Instance, All.
Expiration Lets you specify the persistence window for a dimension. Options are: Session (default), Person, Custom Time, Metric. You might need to be able to expire the dimension on a purchase (such as internal search terms or other merchandising use cases). The maximum expiration time you can set is 90 days. If you select an allocation of All, only Session or Person expiration is available.

Allocation settings

Details around the available allocation settings.

  • Most Recent: persists the most recent (by timestamp) value present in the dimension. Any subsequent values that occur within the dimension’s expiration period replaces the previously persisting value. If “Treat ‘No Value’ as a value” is enabled on this dimension under No value options, empty values overwrite previously persisted values. For example, consider the following table with Most recent allocation and Session expiration:

    Dimension Hit 1 Hit 2 Hit 3 Hit 4 Hit 5
    Dataset values C B A
    Most recent allocation C B B A
  • Original: Persists the original value by timestamp present within the dimension for the duration of the expiration period. If this dimension has a value, it is not overwritten when a different value is seen on a subsequent event. For example, consider the following table with Original allocation and Session expiration:

    Dimension Hit 1 Hit 2 Hit 3 Hit 4 Hit 5
    Dataset values C B A
    Original allocation C C C C
  • All: Acts similarly to the Participation attribution model for metrics. Persists all values equally so each get full credit for the metric in reporting. For example, consider the following table with All allocation and Session expiration:

    Dimension Hit 1 Hit 2 Hit 3 Hit 4 Hit 5
    Dataset values A B C A
    All allocation A A,B A,B,C A,B,C A,B,C

Expiration settings

Details around the available expiration settings.

  • Session: Expires after a given session. Default expiration window.
  • Person: Expires at the end of the reporting window.
  • Time: You can set the dimension value to expire after a specified time period (up to 90 days). This expiration option is only available for Original and Most Recent allocation models. When using time-based expiration, values previous to the start of your reporting window (up to 90 days) are considered.
  • Metric: When this metric is seen in a hit, immediately expire the persisted value in the dimension. You can use any metric as the expiration end for this dimension. This expiration option is only available for Original and Most Recent allocation settings.

On this page