Skip to main content
The built-in metrics cover plays, retention and revenue. A custom metric covers whatever else you sell on: an add-to-cart click, a quiz completion, a scroll to the guarantee. Once defined, a custom metric behaves like any other: it gets a card, a sparkline and a trend, and it can be the goal metric of a split test.

Define one

1

Open the metric library

Go to a video → Analytics → General, then click Customize metrics.
2

Create the metric

Give it a name, then choose what it counts.
3

Arrange the cards

Drag the cards into the order you want. The layout is saved per video.

What a metric counts

required
Which event to count: a built-in player event (click, hover, scroll, and so on), or custom for an event you send yourself via the Custom Events API.
el_href | el_text | event_name
Which part of the event to match against. For a click, match the link’s href or its visible text. For a custom event, match the event name.
contains | equals | wildcard | regex
How to compare.
list
What to match, and what to explicitly rule out.
count | pct | sum
  • count: how many times it happened.
  • pct: as a percentage of a denominator you choose.
  • sum: the total of a numeric field, e.g. the value on your custom events.
optional
Only count the event if it happened before or after a point in the video.
A click metric with no matcher counts every click on the page, which is almost never what you want. Set the match values.

Declaring an event name

Defining a custom metric on the custom event does double duty: it also declares that event name so the browser is allowed to send it.
That call is rejected until quiz_completed exists as a custom metric. See Custom Events API for why the browser path works this way.
Events sent from your backend do not need the declaration to be accepted: a token is already proof of trust. They still need it to be charted. Define the metric either way.

Preset metrics

Connect an integration and it brings its own metrics with it: ElasticFunnels, ClickBank, BuyGoods and Digistore24 each ship a preset group, plus a generic “any funnel” set. Presets are fixed: you can chart them and split-test on them, but you cannot edit or delete them. Build your own alongside.