Integrate video data with player

You can integrate the FastPix Player within your platform to provide seamless video delivery and gain insights into viewer engagement – all with minimal setup. Designed specifically for videos hosted on FastPix, the Player offers a pre-configured solution that simplifies video delivery and provides built-in data tracking for informed decision-making.

Key metrics tracked by Video Data

Buffering time: Gain insights into how often and how long viewers experience buffering. This information helps identify potential bottlenecks in your delivery pipeline and implement targeted optimizations to reduce buffering and ensure smooth playback.
Video quality of experience: Track the playback quality of experience, experienced by viewers across different devices and network conditions. This allows you to assess the effectiveness of your video encoding strategies and identify areas for improvement to deliver consistently high-quality video experiences.
Viewer engagement: Understand how viewers interact with your content by analyzing metrics like watch time, completion rates, and engagement patterns. You can use this information to tailor your content strategy to better resonate with your audience and keep them engaged.

For list of all metrics tracked, explore our Video Data guides.

Integrate easily with a player package

Fast setup: Avoid complex integrations and extensive development. FastPix Player arrives as a pre-built package, significantly reducing setup time and development efforts. Simply embed the provided player code into your platform to deliver engaging video experiences.
Seamless configuration: FastPix Player handles manual configurations for you. HLS settings are automatically optimized behind the scenes to ensure smooth playback across different devices, browsers, and internet speeds. This lets you focus on your platform's primary features and user experience.

Built-in data tracking for actionable insights

The FastPix Player integrates seamlessly with Video Data, a comprehensive analytics suite that provides an unified view of video performance and user interactions without requiring additional setup.

The player does a mapping of video and user-related attributes for real-time analytics tracking. These attributes help monitor and improve playback behavior, viewer engagement, and other performance metrics.

Enable video data integration

To enable data tracking and analysis, include the metadata-workspace-key attribute in the FastPix Player embed code.

<fastpix-player
  playback-id="your-live-playback-id"
  stream-type="live-stream"
  metadata-workspace-key="your-metadata-key"  
  metadata-video-title="video title"
  metadata-viewer-user-id="user id"
  metadata-video-id="video-id"
  >
</fastpix-player>

Disabling Data Monitoring

If you want to disable data tracking after providing metadata attributes, include the disable-data-monitoring attribute.

<fastpix-player
  playback-id="your-live-playback-id"
  stream-type="live-stream"
  disable-data-monitoring
  >
</fastpix-player>

Debugging data monitoring setup

To facilitate debugging and ensure proper data tracking setup, use the enable-debug attribute.

<fastpix-player
  playback-id="your-live-playback-id"
  stream-type="live-stream"
  enable-debug
  >
</fastpix-player>

Respect 'Do Not Track' preferences

To honor users' privacy settings regarding the 'Do Not Track' (DNT) preference, set the respect-do-not-track attribute to true.

<fastpix-player
  playback-id="your-live-playback-id"
  stream-type="live-stream"
  respect-do-not-track
  >
</fastpix-player>

Disable cookies for data monitoring

If you prefer data tracking without using cookies, include the disable-cookies attribute.

<fastpix-player
  playback-id="your-live-playback-id"
  stream-type="live-stream"
  disable-cookies
  >
</fastpix-player>

Attribute mapping breakdown

The following table outlines the key metadata attributes and their corresponding data mappings:

Context attribute	Extracted data attribute	Description
`metadata-workspace-key`	`workspace\_id`	Unique identifier for the workspace.
`metadata-video-title`	`video\_title`	Title of the video being played.
`metadata-viewer-user-id`	`viewer\_id`	Identifier for the viewer watching the video.
`metadata-video-id``	`video\_id`	Unique ID of the video.
`metadata-experiment-name`	`experiment\_name`	Name of any ongoing experiment related to the video.
`metadata-player-name`	`player\_name`	Name of the video player being used.
`metadata-player-version`	`player\_version`	Version of the video player.
`metadata-video-duration`	`video\_duration`	Duration of the video in seconds.
`metadata-view-session-id`	`view\_session\_id`	Session ID for the video viewing.
`metadata-page-context`	`page\_context`	Context of the page where the video is embedded.
`metadata-sub-property-id`	`sub\_property\_id`	ID for any specific sub-property of the video.
`metadata-video-content-type`	`video\_content\_type`	Type of video content (e.g., live or on-demand).
`metadata-video-drm-type`	`video\_drm\_type`	DRM type used for the video.
`metadata-video-encoding-variant`	`video\_encoding\_variant`	Encoding variant of the video, like resolution or bitrate.
`metadata-video-language-code`	`video\_language\_code`	Language code of the video's audio.
`metadata-video-producer`	`video\_producer`	Producer or creator of the video content.
`metadata-video-variant-name`	`video\_variant\_name`	Name of the specific video variant (e.g., resolution).
`metadata-video-cdn`	`video\_cdn`	CDN used to deliver the video content.
`metadata-video-variant-id`	`video\_variant\_id`	Unique ID for the video variant.
`metadata-video-series`	`video\_series`	Series name or ID if the video is part of a series.
`metadata-custom-1` to `metadata-custom-10`	`custom\_1` to `custom\_10`	Custom metadata attributes for additional information.

Understanding metadata usage

Workspace and video identification

These attributes (workspace\_id, video\_id, video\_title) help identify the video and its associated workspace, enabling accurate tracking and reporting.

Viewer and session tracking

viewer\_id and view\_session\_id attributes track individual users and session details, helping with personalized analytics and engagement insights.

Video and player details

Attributes such as video\_duration, player\_name, player\_version, and video\_language\_code provide essential data for optimizing playback experience and diagnosing issues.

Privacy and compliance

FastPix Player respects user privacy by allowing features such as ‘Do Not Track’ compliance and cookie-free data tracking. Developers can configure data tracking settings as per their requirements.

By leveraging these pre-configured settings and customizable metadata attributes, you can enhance viewer engagement, improve analytics, and ensure optimal playback experiences.