In May 2023, we released powerful engagement metrics offering detailed information on viewer behavior and playback quality on your platform. The API includes engagement metrics such as view counts and watch time, as well as performance metrics such as error rate, time to first frame, rebuffer ratio, and exit-before-starts across a variety of dimensions. For more details, check out the docs here.

In this tutorial we will introduce a simple, free, and customizable method to quickly visualize the core metrics and dimensions of the API.


Before you begin this tutorial, make sure you have:

  1. Integrated the necessary components to capture viewership data. Details here.
  2. Viewed videos via (1) to collect data.
  3. Created an CORS-enabled API Key. The key must allow CORS access from your Grafana origin, or from all (*)
  4. Set up a Grafana account and workspace with permissions to add new dashboard (and datasource/connection, if necessary). A free account is sufficient and available at
  5. Install the JSON API plugin for grafana.

With that we are ready to set up our dashboard!

Setting up the Engagement Dashboard

  • Login to Grafana
  • Click “Connections” > “Connect Data”
  • Rename the dashboard if you’d prefer