Fact retrieval matrix

When an event references the recorded value of another event, it is referencing a specifically recorded fact, which may be different from the recorded value for the event.

For example, suppose Event A is configured to be recorded only on its first occurrence, even though the event value (its fact value) can change over the course of a session. Suppose Event B's recorded value is the value of Event A. If the values of Event A are 100, 200, and 300 over the course of the session, the recorded values of Event A and Event B are both 100.

In the matrix below, you can review the fact values that are retrieved based on the values that are recorded.

Table 1. Fact retrieval matrix
Recorded Values First Last All
Retrieved Values
First First Last First
Last First Last Last
Nth First Last Nth

Legend

  • Recorded Values - Facts can be defined to track only certain occurrences of the event in the session.
    • First - The first occurrence of the fact is recorded for reporting and searching. Subsequent facts in the session are dropped.
    • Last - The last occurrence of the fact is recorded for reporting and searching. All previous fact occurrences are replaced with the last occurrence.
    • All - Every occurrence of the fact is retained for reporting and searching.
  • Retrieved Values - During evaluation of an event's properties, facts can be retrieved. The first or last occurrence of the fact to retrieve can be specified.
    • First - Retrieves the first occurrence.
    • Last - Retrieves the last occurrence.
    • Nth - The nth occurrence while iterating through the list.