Login

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 attributeExtracted data attributeDescription
metadata-workspace-keyworkspace_idUnique identifier for the workspace.
metadata-video-titlevideo_titleTitle of the video being played.
metadata-viewer-user-idviewer_idIdentifier for the viewer watching the video.
`metadata-video-id``video_idUnique ID of the video.
metadata-experiment-nameexperiment_nameName of any ongoing experiment related to the video.
metadata-player-nameplayer_nameName of the video player being used.
metadata-player-versionplayer_versionVersion of the video player.
metadata-video-durationvideo_durationDuration of the video in seconds.
metadata-view-session-idview_session_idSession ID for the video viewing.
metadata-page-contextpage_contextContext of the page where the video is embedded.
metadata-sub-property-idsub_property_idID for any specific sub-property of the video.
metadata-video-content-typevideo_content_typeType of video content (e.g., live or on-demand).
metadata-video-drm-typevideo_drm_typeDRM type used for the video.
metadata-video-encoding-variantvideo_encoding_variantEncoding variant of the video, like resolution or bitrate.
metadata-video-language-codevideo_language_codeLanguage code of the video's audio.
metadata-video-producervideo_producerProducer or creator of the video content.
metadata-video-variant-namevideo_variant_nameName of the specific video variant (e.g., resolution).
metadata-video-cdnvideo_cdnCDN used to deliver the video content.
metadata-video-variant-idvideo_variant_idUnique ID for the video variant.
metadata-video-seriesvideo_seriesSeries name or ID if the video is part of a series.
metadata-custom-1 to metadata-custom-10custom_1 to custom_10Custom 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.