# Sticky Mini-Player

A small player that docks to a corner and keeps playing as the viewer scrolls or navigates between pages on your site, preserving the session for [Maya](https://begenuin.com/developers/browse-by-products/supervised-intelligence/supervised-intelligence-what-it-does-and-where-to-start#maya-genuin-s-orchestrator).

The Sticky Mini-Player keeps a video or an episode going when the viewer moves on. When the viewer scrolls past the placement or opens another page, the player docks to a corner and plays on. The session stays intact, so Maya keeps ranking with what the viewer already watched.

[Octo](https://begenuin.com/developers/get-started/any-business/octo-operates-your-brand-control-center-octo-proposes-you-approve), Genuin's Supervised Intelligence interface in Brand Control Center (BCC), proposes this capability when it finds a fit on your sites and apps. It completes the steps under Set it up from your brand context. Nothing goes live until you approve it. It's part of [Onsite](https://begenuin.com/developers/browse-by-products/onsite/onsite-what-it-does-and-where-to-start), and [Onsite contextual placements](https://begenuin.com/developers/get-started/any-business/onsite-contextual-placements-across-homepage-category-and-product-pages) explains how a session carries across the placements on your pages.

## When to use it

Use it where viewers stay a while or move between pages.

- **Long articles**: the player stays in view after the reader scrolls past the placement.
- **Multi-page journeys**: playback continues as the viewer moves from page to page on your site.
- **Listening sessions on podcast sites**: pair it with the [Audio + Video Dynamic Player](https://begenuin.com/developers/browse-by-products/onsite/audio-video-dynamic-player), so an episode keeps playing while the listener browses.

## How it works

- The mini-player is a player control. You turn it on per page type and can override it per placement.
- It docks when its trigger fires: the viewer scrolls past the placement, or navigates to another page.
- You choose the dock corner and the dismiss rules.
- On narrow viewports, you can have it turn off automatically.
- With the SDK, the mini-player can follow the viewer into the next page. The session carries over, and [Contextual Continuity](https://begenuin.com/developers/browse-by-products/onsite/contextual-continuity) shapes what the next placement shows.

## Set it up

Octo proposes the mini-player with these steps already done. You review the result and confirm it.

1. Turn on the Sticky mini-player for the page type under **Control** > **Player controls**. Learn how in [Player Controls and Feed Settings](https://begenuin.com/developers/browse-by-products/control/player-controls-and-feed-settings).
2. Choose the dock corner and the trigger: scrolling past the placement, or navigation.
3. Optionally, let the mini-player follow the viewer into the next page through the SDK.

## Settings

| Setting | What it controls |
| --- | --- |
| Sticky mini-player | On or off, per page type |
| Dock position | The corner the player docks to |
| Trigger | Scrolling past the placement, or navigation |
| Dismiss rules | How the docked player is dismissed |
| Narrow viewports | Turns the mini-player off automatically, if you choose |

Set these per page type, and override them per placement, in [Player Controls and Feed Settings](https://begenuin.com/developers/browse-by-products/control/player-controls-and-feed-settings). Changes apply without a code change.

## What it reports

**Reports** > **Onsite** shows these measures for each placement. [Measure engagement](https://begenuin.com/developers/get-started/any-business/measure-engagement-watch-time-lift-and-cohorts) explains how watch time and pages per session are counted.

- **Minutes added**: the watch time the mini-player adds.
- **Dismiss rate**: how often viewers dismiss the docked player.
- **Pages per session**: compared with the mini-player and without it.

## Add it to your site

The Web SDK renders this placement today. [Embed the Genuin Web SDK on your website](https://begenuin.com/developers/developer-resources/sdk/how-do-you-embed-and-configure-the-genuin-web-sdk-on-your-website) covers loading the script, and [Add a Genuin placement to your website](https://begenuin.com/developers/developer-resources/sdk/how-do-you-configure-the-genuin-web-sdk-placement-on-your-website) covers the placement and style IDs. [Customize the Genuin video player](https://begenuin.com/developers/browse-by-products/control/how-does-a-brand-customize-the-genuin-video-player-controls) sets sizes, tile layouts, and the profile menu.

The placement settings calls in the [Business Account API](https://begenuin.com/developers/get-started/any-business/business-account-api-provisioning-oauth-and-the-resource-map) are proposed, not live. [Live API today and the Business Account API roadmap](https://begenuin.com/developers/developer-resources/guides/live-api-today-and-the-business-account-api-roadmap) maps what you can call now to what's planned.
