> 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.

# Monitor video data

> Enable playback analytics in the FastPix iOS Player with enableAnalytics to track views, engagement, and quality of experience in your FastPix workspace.

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:

* The FastPix iOS Player SDK installed and a video playing. See [Install FastPix iOS player](/docs/ios-player/install-fastpix-ios-player).
* Your **Workspace Key**, from the **Workspaces** section of the [FastPix dashboard](https://dashboard.fastpix.com/).

\


## Enable analytics

Call `enableAnalytics` on the player view controller with your metadata:

```swift
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

| Field                     | Description                                                       |
| ------------------------- | ----------------------------------------------------------------- |
| `workspace_id`            | Your workspace key. Required to send analytics.                   |
| `video_title`             | The title of the video, shown in your dashboard.                  |
| `video_id`                | A unique identifier for the video.                                |
| `viewer_id`               | A unique identifier for the viewer, such as a user or session ID. |
| `video_content_type`      | The type of content, for example `series` or `movie`.             |
| `video_stream_type`       | The type of streaming, `live` or `on-demand`.                     |
| `custom_1` to `custom_10` | Custom fields for your own business logic.                        |

\


#### Frequently asked questions

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

`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.

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

\


## What's next

* [Play uploaded videos](/docs/ios-player/play-uploaded-videos) to get a video playing before you enable analytics.
* [Complete integration example](/docs/ios-player/complete-integration-example) to see the player set up end to end.