> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://fastpix.com/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://fastpix.com/docs/_mcp/server.

# Introduction

> Set up FastPix Video Data SDKs to capture real-time playback events and analyze 50+ audience and QoE metrics across web, mobile, and smart TV players.

In this guide, we’ll take you through the key features, from setting up your first data stream to generating actionable insights using our dashboards. Whether you're new to video data analytics or looking to deepen your understanding, this guide will provide the step-by-step instructions you need to harness the full power of our platform.

\


## Dive deeper into Video Data

#### [How Video Data works](/video-data/how-it-works)

Architecture deep-dive on how Video Data captures, processes, and surfaces playback insights.

#### [What Video Data do we capture](/video-data/what-video-data-do-we-capture)

Every dimension, playback event, and calculated metric captured by Video Data SDKs.

#### [Find out why viewers drop off](/video-data/find-out-why-viewers-drop-off)

Worked example: use breakdown values and view drill-down APIs to diagnose viewer churn.

#### [Identify top-performing content](/video-data/identify-top-performing-content)

Worked example: use top-content aggregation and device breakdown to surface popular videos.

* [How Video Data works](/video-data/how-it-works)

Architecture deep-dive on how Video Data captures, processes, and surfaces playback insights.

* [What Video Data do we capture](/video-data/what-video-data-do-we-capture)

Every dimension, playback event, and calculated metric captured by Video Data SDKs.

* [Find out why viewers drop off](/video-data/find-out-why-viewers-drop-off)

Worked example: use breakdown values and view drill-down APIs to diagnose viewer churn.

* [Identify top-performing content](/video-data/identify-top-performing-content)

Worked example: use top-content aggregation and device breakdown to surface popular videos.

\


[FastPix Video Data](https://www.fastpix.io/video-data) helps collect playback events as and when they happen from video Playback by using our easy to integrate Data SDKs for popular players in Web, Android and iOS Platforms. It provides insights for Viewer Engagement and QoE analysis by getting deeper into important metrics such as Audience metrics, Play metrics, Failure metrics, Stream metadata and Custom metadata by segmenting data across 50+ dimensions and different timeframes.

\
\


## Getting started with video data

FastPix Video Data continuously monitors key video metrics from errors, engagement to experience. The resulting data, analytics and tools help you build and deliver better video and experiences from your site or app.

\


### Step 1: Navigate to Workspaces:

* Log in to your FastPix account.
* Locate the **Workspaces** section from the main menu or dashboard.
* Select the workspace you want to integrate your views into and copy the workspace key.

\


![Navigate to Workspaces](https://files.readme.io/4f1f9535c83c8da9f64f53eb3886c4d0941ebe0368ac2fbd28e3a25a65b551a6-image.png)

\


### Step 2: Select your client-side SDK

Choose the SDK that aligns with the video player you're using. FastPix Data SDK supports several popular players, including:

* Shaka Player
* HLS.js
* ExoPlayer
* AVPlayer
* FastPix Player

Each SDK is optimized to ensure smooth integration and accurate data collection.

\


### Step 3: Integrate the player with the FastPix Data SDK

After selecting your preferred SDK, integrate it into your video player by passing key metadata parameters. This metadata will allow you to visualize audience and QoE metrics in the FastPix dashboard or APIs.

Below you can see a section of the actual integration how metadata should be passed.

**Example**: [Integrating Shaka Player](/video-data/monitors/the-shaka-player)  with metadata

**`Javascript`**

```json Javascript
// Initialize the Shaka Player with essential configurations  
loadShakaPlayer(player, {  
debug: false, // Set to true for debugging information in the console  
  data: {  
  workspace_id: 'WORKSPACE_KEY', // Replace with your actual workspace key  
  viewer_id: '', // Example: '12345' - Unique identifier for the viewer  
  experiment_name: '', // Example: 'player_test_A' - Name of the experiment if applicable  
  sub_property_id: '', // Example: 'cus-1' - Identifier for the sub-property  

  // Player Metadata  
  player_name: '', // Example: 'My Main Player' - Name of the player instance  
  player_version: '', // Example: '1.0.0' - Version of the player  
  player_init_time: Date.now(), // Use current time or specify a timestamp  

  // Video Metadata  
  video_id: '', // Example: 'abcd123' - Unique identifier for the video  
  video_title: '', // Example: 'My Great Video' - Title of the video  
  video_series: '', // Example: 'Weekly Great Videos' - Series name if applicable  
  video_duration: 120000, // Example: 120000 (2 minutes) - Duration in milliseconds  
  video_stream_type: 'on-demand', // Specify 'live' or 'on-demand'  
  video_cdn: '' // Example: 'Fastly' or 'Akamai' - CDN used for streaming  
  }  
});  
```

\


## Making sense of video data

Once integrated, FastPix enables you to analyze key metrics through its dashboard or APIs. These metrics are divided into audience metrics such as understand viewer demographics, engagement patterns, and behavior trends. QoE metrics to measure playback quality, failure rates, buffering times, and more to improve the streaming experience.

FastPix Video Data lets you segment data by over 50 dimensions, including device type, region, playback type, and timeframes, to help you get insights that matter most to your platform’s success. You gain a complete understanding of how viewers interact with your content and where improvements are needed. These insights help you make informed decisions to enhance content delivery, optimize streaming performance, and ultimately increase user satisfaction.

## What you can do with Video Data

Monitor your players, explore metrics, and work with the data FastPix collects.

**Web players**

* [Monitor the FastPix player](/video-data/monitors/the-fastpix-player)
* [Monitor the Shaka player](/video-data/monitors/the-shaka-player)
* [Monitor HLS.js](/video-data/monitors/hlsjs)
* [Monitor Video.js](/video-data/monitors/videojs)
* [Monitor DASH.js](/video-data/monitors/dashjs)

**Android players**

* [Monitor AndroidX Media3](/video-data/monitors/androidx-media3)
* [Monitor ExoPlayer](/video-data/monitors/exoplayer)
* [Monitor Brightcove Player](/video-data/monitors/brightcove-player)
* [Monitor Bitmovin Player](/video-data/monitors/bitmovin-player)
* [Monitor Kaltura Player](/video-data/monitors/kaltura-player)
* [Monitor THEOPlayer](/video-data/monitors/theoplayer)

**iOS and cross-platform players**

* [Monitor AVPlayer (iOS)](/video-data/monitors/avplayer)
* [Monitor React Native](/video-data/monitors/react-native)
* [Monitor Better Player (Flutter)](/video-data/monitors/better-player)

**Smart TV players**

* [Monitor Samsung Tizen](/video-data/monitors/samsung-tizen)
* [Monitor LG webOS](/video-data/monitors/lg-webos)
* [Monitor Roku](/video-data/monitors/roku)

**Concepts**

* [Understand data definitions](/video-data/understand-data-definitions)
* [What Video Data do we capture](/video-data/what-video-data-do-we-capture)
* [Audience metrics](/video-data/audience-metrics)
* [Quality of experience (QoE) metrics](/video-data/quality-of-experience-qoe-metrics)
* [Playback metrics](/video-data/playback-metrics)
* [Video startup metrics](/video-data/video-startup-metrics)
* [Stability metrics](/video-data/stability-metrics)
* [Render quality metrics](/video-data/render-quality-metrics)

**Working with video data**

* [Explore the dashboard](/video-data/explore-the-dashboard)
* [Build workflows with the API](/video-data/build-workflows-with-the-api)
* [Find out why viewers drop off](/video-data/find-out-why-viewers-drop-off)
* [Analyze viewer drop-off with ClickHouse](/video-data/analyze-viewer-drop-off-with-clickhouse)
* [Identify top-performing content](/video-data/identify-top-performing-content)
* [Pass custom metadata to metrics](/video-data/pass-custom-metadata-to-metrics)
* [Use custom dimensions](/video-data/use-custom-dimensions)
* [Troubleshoot playback errors](/video-data/troubleshoot-playback-errors)