Intervals engaged block

2 min

Use the intervals engaged block to calculate the time intervals, such as days or weeks, during which a user or other actor interacts with a product or service. This block is useful for measuring user engagement with a product, feature, new release, or experiment.

Configure the block with the following fields:

Count of distinct time Intervals – Determine the count of unique days, weeks, or months to measure user engagement.

Actor – Specify the actor dataset, which pertains to the entity that performed an action or demonstrated engagement.

Event or Action (did) – Pinpoint the particular activity of interest to demonstrate engagement. Specify "active" or "user-initiated" events instead of "passive" events like push notifications. Use the event filtering interface to refine your selection

Event selector – Select specific events or broad event categories (event stream).

Event filter – Filter down to a specific set of events.

Time filter – Filter events based on their timing.

Relative – Filters relative to the current time, for example, the last three months.

Absolute – Filters based on specific dates and times of day.

Relative to event – Filters based on the relative duration between an event and a baseline event or timestamp, for example, "within two weeks after the first occurrence of onboarding."

Frequency – Specify using the "at least" and "at most" settings to constrain the number of times the actor engages in the identified activity.

Use comparison operators in each condition (string comparisons are case-insensitive). You may include catalog properties such as columns, derived columns, blocks, values, or parameters.

is – Checks if the left side equals the right side.

is not – Checks if the left side does not equal the right.

contains – Determines if the left side string contains the right side as a substring.

in – Verifies if the left side is present within the values on the right side.

<, >, >=, ... – Applies mathematical operators.

Example

To create a metric that calculates the time interval during which users performed the 'Play Content' event,

Select days in the Count of distinct field and the Users dataset as the actor.

Select the Play Content event using the Select events drop-down list in the did field.

Define the minimum and maximum count for the event occurrence as 1 and 5, respectively.

Click Run.

Output

The output of the intervals engaged block is a numeric value for each actor used within the block definition.