Contextual Filters

Refinement filters

The first contextual filter introduced to our application is Visited Url, which can be used in conjunction with the main event - Clicked Element.

Definition

The contextual filter is a filter that can only be used in combination with a primary one. It allows you to add additional conditions to the actions of the users.

What is the difference between main event filter and contextual Visited URL?

To better understand the distinction, we will examine both configurations.

When you have a configuration like this one:

πŸ“˜

Configuration with 2 main event filters: Visited URL and Clicked Element

visited URL contains https://examples.sencha.com/*/*/examples/admin-dashboard/frame-index.html#email

Clicked Element (CSS) is: #button-1092-btnInnerEl

This means that your segment will be matched with all users who have visited the page at least once and clicked the element, regardless of which page they were on at the time of the button click.

18921892

Using 2 main event filters

In the example below: two users have interacted with the HTML element and visited the page.

18181818

The list of users who have visited the page and interacted with the element.

This is not the same as having the following configuration:

πŸ“˜

Configuration with one main event filter and contextual one

Clicked Element (CSS) is: #button-1092-btnInnerEl

{when} visited URL contains: https://examples.sencha.com/*/*/examples/admin-dashboard/frame-index.html#email

The last guaranteed that users who pressed that button were on that specific page at the time. Only users who interacted with the element while on the page will be included in your segment.

19081908

Using one main event and the contextual filter

The first configuration includes two users, as shown in the examples, whereas the second includes only one user who clicked the button while on the page.

18191819

The list of users who have interacted with the element on a specific page

How to configure

Follow these steps to configure:

19101910

Step 1: Open filters.

In order to access the refinement filter, select the Clicked Element one.

19081908

Step 2: Select and define Clicked Element event filter.

By pressing the filter button, the contextual filter is added automatically beneath the Clicked Element.

18941894

Step 3: Click the filter button to refine the event.

Define a value for the contextual filter. Save the configuration as a segment for later usage if needed.

19021902

Step 4: Define a value for the contextual filter

Now that you're finished, you can check the list of users that match your search parameters.

The contextual filter can be used also in combination with the main event Rage Click. For more about this filter, read here.


What’s Next

How to use and configure the main event filters: Clicked Element and Visited URL