Skip to navigation

Monitor video data

The FastPix iOS Player can report playback analytics to your FastPix workspace, so you can track video playback, viewer interaction, and environment details for monitoring and insight.

Analytics are built into the player. You turn them on with enableAnalytics and pass metadata that identifies your workspace and the video being played.


Before you begin

Make sure you have the following:


Enable analytics

Call enableAnalytics on the player view controller with your metadata:

playerViewController.enableAnalytics(
metadata: [
"workspace_id": "WORKSPACE_KEY", // Unique key to identify your workspace (replace with your actual workspace key)
"video_title": "Test Content", // Title of the video being played
"video_id": "f01a98s76t90p88i67x", // A unique identifier for the video
"viewer_id": "user12345", // A unique identifier for the viewer
"video_content_type": "series", // Type of content (e.g., series, movie)
"video_stream_type": "on-demand", // Type of streaming (e.g., live, on-demand)
// Custom fields for additional business logic
"custom_1": "", // Use for any additional data your business logic needs
"custom_2": "",
// Add any additional metadata
]
)

Metadata fields

FieldDescription
workspace_idYour workspace key. Required to send analytics.
video_titleThe title of the video, shown in your dashboard.
video_idA unique identifier for the video.
viewer_idA unique identifier for the viewer, such as a user or session ID.
video_content_typeThe type of content, for example series or movie.
video_stream_typeThe type of streaming, live or on-demand.
custom_1 to custom_10Custom fields for your own business logic.

Frequently asked questions

How do I add analytics to the FastPix iOS player?

Call playerViewController.enableAnalytics(metadata:) with a metadata dictionary that includes your workspace_id. The player then reports playback analytics to your FastPix workspace.

Which metadata is required?

workspace_id is required. The rest, such as video_title, video_id, and viewer_id, are optional but make your dashboard data easier to read and segment.

Where do I see the analytics?

In the FastPix dashboard, which shows views, engagement, buffering, and other playback metrics in near real time.


What’s next