Custom Mechanics

The Custom Mechanics dashboard lets developers create their own data visualizations using any of their tracked custom events and event sub-parameters. See below to learn how to use Custom Mechanics.


Setting Up A Mechanic tag

Use the "+ Add Event" button to create a event you want to start analyzing.
Step 1. Select an event

Select an event in the event dropdown.

Step 2. Select Sub-Parameters

Select sub-parameters in the event to analyze by using the "+ Add Sub-Parameter" button.

Step 3. Add Aggregate

To analyze an aggregate in the event, select "+ Add Aggregate". See the the types and their definitions below.

If not selected, the default aggregate selected is count.

Step 4. Link a Segment

Select the Segment in the dropdown you have setup in the right side panel.

If not selected, the default segment is all users.

Step 5. Repeat and keep adding more events you want to analyze.

Edit the Segment Settings

Select "+ Add Segment" to create a new segment of users. Then define the segment user settings. The settings will be saved with the filter if you save the mechanic

Build Multiple Segments

Select "+ Add Segment" to create a another new segment of users.

Use Segment

When using segments, every new segment will be added to the events linked segment dropdown. When building an event to analyze, you can add a segment to that specific event.

Create a Formula

To build a formula, you can only use the events you've created with operators given in the table.

Use Events in the Formula

A Event in a formula is formed like this '{A}'. The event will be the result of the aggregate selected on the event. So, if you aggregate Event "A" by count, then '{A}' will represent the count value.

The formula must be a valid mathmatical formula

Ex. ({A} / {B}) * 100.

Breakdowns tag

Add breakdowns

Breakdowns consist of basic parameters and custom event sub-parameters.

Use Events Sub-Parameters

All events will filter down to match each other's sub-parameters to only display matching named parameters. You can breakdown by any number of the filtered parameters.

What will happen if I use a breakdown?

Your data will be grouped/split by the specific parameters you selected and plot thier aggregate value.

Chart Types tag

Select a Chart

Charts default to line, if unselected.

Type 1. Bar

The data will be broken down by Event, and each breakdown you selected. Graph will produce a horizontal bar chart.

Type 2. Stacked Bar

The data will be broken down by Event, and each breakdown you selected. Graph will produce a horizontal stacked bar chart using two depths of breakdowns you selected.

Type 2. Line Graph

The data will be broken down by Event, and each breakdown you selected. Graph will produce a line chart with the x-axis always set to date.

Aggregates List tag

Listed are the different aggregate options on the Mechanics dashboard.
Type 1. Count

The count of events.

Type 2. Unique

The amount of unique users doing this event.

Type 3. Average

The calculated average amount of times this event occurs per unique user; Count/Unique.

Type 3. Sub-Parameter Aggregation

Select a Sub-Parameter you want to aggregate by. This will only output correctly if the sub-parameter is a numerical value. Using a sub-parameter as an aggregate will allow you to select a sub-type to calculate by.


Sub-Type 1. AVG

Average value of the sub-parameter.

Sub-Type 2. MEDIAN

Median value of the sub-parameter.

Sub-Type 3. SUM

Total sum value of the sub-parameter.

Sub-Type 4. MIN

Smallest min value of the sub-parameter.

Sub-Type 5. MAX

Largest max value of the sub-parameter.