---
updatedAt: 2026-09-10T09:13:05.000Z
agentTools:
  siteIndex: https://docs.jwplayer.com/llms.txt
  projectIndex: https://docs.jwplayer.com/platform/llms.txt
---

# Playback Data

## Play Session Daily Definitions

Daily rollups of the play session data

<span class="manual-tbl-font">
    <table>
        <thead>
            <tr>
                <th> Column Name</th>
                <th> Description </th>
            </tr>
        </thead>
        <tbody>
            <tr>
                <td width="37%"> <strong>AD_CLICKS</strong> integer</td>
                <td width="63%">Number of times an ad was clicked in an embedded player</td>
            </tr>
            <tr>
                <td> <strong>AD_CLIENT</strong> integer</td>
                <td>Ad client being used
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>Null</code>: Player not enabled for ads</li>
                        <li><code>0</code>: VAST</li>
                        <li><code>1</code>: Google IMA</li>
                        <li><code>2</code>: FreeWheel</li>
                        <li><code>3</code>: DAI</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>AD_COMPLETES</strong> integer</td>
                <td>Number of times an ad was completed in an embedded player</td>
            </tr>
            <tr>
                <td> <strong>AD_IMPRESSIONS</strong> integer</td>
                <td>Number of ad starts across all embedded players</td>
            </tr>
            <tr>
                <td> <strong>AD_SCHEDULE_ID</strong> string</td>
                <td>ID associated with a specific ad schedule</td>
            </tr>
            <tr>
                <td> <strong>AD_SKIPS</strong> integer</td>
                <td>Number of times an ad was skipped in an embedded player</td>
            </tr>
            <tr>
                <td> <strong>AD_VIEWABLE_IMPRESSIONS</strong> integer</td>
                <td>Total number of viewable ad impressions in this session, as defined by the IAB (a viewer has watched an ad for 2 consecutive seconds with at least 50% of the pixels in the viewport)
                    <br /><br />
                    The following are required to properly receive metrics:
                    <ul>
                        <li>Player version 8.5+</li>
                        <li>Ad schedule ID</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>ADVANCE_TYPE</strong> string</td>
                <td>Denotes the method by which the playlist advanced at the end of this play session
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>Null</code>: User did not play video, user abandoned during play of video, or no advancement at end of play</li>
                        <li><code>Auto</code>: Auto play</li>
                        <li><code>Click</code>: User clicked on a video</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>ANALYTICS_ID</strong> string </td>
                <td>22-character alphanumeric ID representing a grouping of properties
                    <br /><br />
                    When segmenting data by a specific property, query by site ID.
                </td>
            </tr>
            <tr>
                <td> <strong>AVG_PLAYER_HEIGHT</strong> float</td>
                <td>Average player height in pixels throughout the session</td>
            </tr>
            <tr>
                <td> <strong>AVG_PLAYER_SIZE</strong> integer</td>
                <td>Average player size bucket throughout the session
                    <br /><br />
                    The player size is grouped by width.
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: Unknown</li>
                        <li><code>1</code>: Small (<=320px)</li>
                        <li><code>2</code>: Medium (321-640px)</li>
                        <li><code>3</code>: Large (>640px)</li>
                        <li><code>4</code>: Responsive (100% width)</li>
                        <li><code>5</code>: Audio</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>AVG_PLAYER_WIDTH</strong> float</td>
                <td>Average player width in pixels throughout the session</td>
            </tr>
            <tr>
                <td> <strong>BROWSER</strong> string </td>
                <td>Browser used to fetch the content
                    <br /><br />
                    <strong>Example values</strong>:
                    <ul>
                        <li><code>AppleCoreMedia</code></li>
                        <li><code>Chrome</code></li>
                        <li><code>Edge</code></li>
                        <li><code>Firefox</code></li>
                        <li><code>Roku</code></li>
                        <li><code>Safari</code></li>
                        <li><code>Silk</code></li>
                    </ul>
                    <br />
                    The browser is identified based on the user agent string.
                </td>
            </tr>
            <tr>
                <td> <strong>CITY</strong> string </td>
                <td>City from which a user accessed the media item
                    <br /><br />
                    The value is based on the <a href="https://en.wikipedia.org/wiki/ISO_3166-2" target="_blank">ISO 3166-2</a> standard.</td>
            </tr>
            <tr>
                <td> <strong>COMPLETES</strong> integer</td>
                <td>Number of times a viewer watched the end of a media item</td>
            </tr>
            <tr>
                <td> <strong>COUNT_PLAYBACK_STALLS</strong> integer</td>
                <td>Number of times the player buffers for this play session</td>
            </tr>
            <tr>
                <td> <strong>COUNTRY_CODE</strong> string </td>
                <td>Two-letter country code from which a user accessed a media item
                    <br /><br />
                    The value is the <a href="https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2" target="_blank">ISO 3166-1 alpha-2</a> country code.
                </td>
            </tr>
            <tr>
                <td> <strong>DEVICE_TYPE</strong> string </td>
                <td>Device on which the user experienced the session
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>Connected Device</code></li>
                        <li><code>Connected TV</code></li>
                        <li><code>Desktop</code></li>
                        <li><code>Other</code></li>
                        <li><code>Phone</code></li>
                        <li><code>Tablet</code></li>
                        <li><code>Unknown</code></li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>EASTERN_DATE</strong> string</td>
                <td>Date when the media item started to play within a player, using <code>YYYY-MM-DD</code> (USA - Eastern Time) format</td>
            </tr>
            <tr>
                <td> <strong>EMBED_ID</strong> string</td>
                <td>ID a player instance that is embedded on a page</td>
            </tr>
            <tr>
                <td> <strong>EMBED_SEEN</strong> integer</td>
                <td>Number of times an embed was viewable at least once in the session</td>
            </tr>
            <tr>
                <td> <strong>EMBEDS</strong> integer</td>
                <td>Number of times a player has been set up on a page
                    <br /><br />
                    The following behaviors can log an embed:
                    <ul>
                        <li>Loading or refreshing a page with an embedded</li>
                        <li>Resetting an embedded player without refreshing the page</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>END_TIME</strong> string</td>
                <td>End time of session in <code>YYYY-MM-DD HH:MM:SS.0000</code> in UTC</td>
            </tr>
            <tr>
                <td> <strong>EXPERIENCE_TYPE</strong> string </td>
                <td>End user experience shown for the session
                    <br /><br />
                    <strong>NOTE</strong>: Experience type reporting requires Player version 8.48 or later. Sessions from earlier player versions, or sessions where the experience type is unavailable, appear as <code>null</code>.
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>audio</code>: <a href="https://docs.jwplayer.com/platform/docs/audio-experience " target="_blank">Audio experience</a></li>
                        <li><code>classic</code>: <a href="https://docs.jwplayer.com/players/docs/players-welcome" target="_blank">Default player</a></li>
                        <li><code>vertical</code>: <a href="https://docs.jwplayer.com/platform/docs/vertical-video-discovery " target="_blank">Vertical video</a></li>
                        <li><code>null</code>: Experience type was not reported or could not be determined</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>FEED_ID</strong> string</td>
                <td>Unique ID for a playlist</td>
            </tr>
            <tr>
                <td> <strong>FIRST_FRAME</strong> integer</td>
                <td>Time in milliseconds (ms) until first frame is displayed</td>
            </tr>
            <tr>
                <td> <strong>HAS_AD_BLOCK</strong> integer</td>
                <td>Indicates if an ad block is detected for this session due to a browser blocking ads
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>-1</code>: Unknown</li>
                        <li><code>0</code>: No ad block</li>
                        <li><code>1</code>: Ad block</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>IS_AUTOSTART</strong> integer</td>
                <td>Player autostart setting for the first video upon embed of the player
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: No autostart</li>
                        <li><code>1</code>: Autostart</li>
                        <li><code>2</code>: Autostart when viewable</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>IS_CLICK_TO_PLAY</strong> integer</td>
                <td>Denotes whether the reason for this play is a user click, auto or unknown
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>-1</code>: Unknown</li>
                        <li><code>0</code>: Auto</li>
                        <li><code>1</code>: User click</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>MEDIA_DURATION</strong> integer</td>
                <td>Length of the video in seconds</td>
            </tr>
            <tr>
                <td> <strong>MEDIA_ID</strong> string</td>
                <td>ID of the media item</td>
            </tr>
            <tr>
                <td> <strong>MEDIA_TITLE</strong> string</td>
                <td>Title of the media</td>
            </tr>
            <tr>
                <td> <strong>MEDIA_TYPE</strong> string</td>
                <td>Media type player has played</td>
            </tr>
            <tr>
                <td> <strong>MEDIA_URL</strong> string</td>
                <td>URL of the media item</td>
            </tr>
            <tr>
                <td> <strong>NUM_AD_BREAKS</strong> integer</td>
                <td>(IMA) Total number of ad break events that occurred during this session</td>
            </tr>
            <tr>
                <td> <strong>OPERATING_SYSTEM</strong> string </td>
                <td>Operating system of the device used to fetch content
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>Android</code></li>
                        <li><code>FireOS</code></li>
                        <li><code>iOS</code></li>
                        <li><code>iPadOS</code></li>
                        <li><code>RokuOS</code></li>
                        <li><code>Tizen</code></li>
                        <li><code>Windows</code></li>
                    </ul>
                    <br />
                    The operating system is identified based on the user agent string.
                </td>
            </tr>
            <tr>
                <td> <strong>PAGE_DOMAIN</strong> string </td>
                <td>Domain within which a player was embedded
                    <br /><br />
                    By excluding <em>www</em>, all subdomains are also included.
                </td>
            </tr>
            <tr>
                <td> <strong>PAGE_URL</strong> string </td>
                <td>URL of the page within which a player was embedded</td>
            </tr>
            <tr>
                <td> <strong>PERCENT_VIEWABLE_WATCH_TIME</strong> decimal</td>
                <td>Percentage of total watched duration that occurred while the player was viewable
                    <br /><br />
                    Viewable was defined as at least 50% of the video pixels being visible within the viewport of the active tab.
                </td>
            </tr>
            <tr>
                <td> <strong>PLACEMENT_EMBED_ID</strong> string</td>
                <td>Unique ID generated for each placement instance that is embedded on a page</td>
            </tr>
            <tr>
                <td> <strong>PLACEMENT_ID</strong> string</td>
                <td>ID associated with a placement</td>
            </tr>
            <tr>
                <td> <strong>PLAY_ATTEMPTS</strong> integer</td>
                <td>Number of play attempts for this session
                    <br /><br />
                    A play attempt is fired right before the video plays, whether it was user generated or auto-started.</td>
            </tr>
            <tr>
                <td> <strong>PLAY_ID</strong> string</td>
                <td>Unique ID generated for each play session</td>
            </tr>
            <tr>
                <td> <strong>PLAY_SEQ</strong> integer</td>
                <td>Item number within a playlist</td>
            </tr>
            <tr>
                <td> <strong>PLAYER_ID</strong> string </td>
                <td>ID of the player</td>
            </tr>
            <tr>
                <td> <strong>PLAYER_PLAYBACK_MODE</strong> string</td>
                <td>Player's playback mode when the first frame of content is rendered
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>DVR</code>: Livestreams that support seeking</li>
                        <li><code>LIVE</code>: Livestreams that do not support seeking</li>
                        <li><code>NULL</code>: Embed without plays</li>
                        <li><code>VOD</code>: Video on Demand</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>PLAYS</strong> integer</td>
                <td>Number of media item starts
                    <br /><br />
                    The player does not have to be visible for this event to fire. This is based on the <code>firstFrame</code> player event.
                </td>
            </tr>
            <tr>
                <td> <strong>PLUGIN_DOCUMENT_REFERRER</strong> string </td>
                <td>Referrer to the page where player is embedded
                    <br /><br />
                    This information is gathered from the DOM.
                </td>
            </tr>
            <tr>
                <td> <strong>REGION</strong> string </td>
                <td>Two-letter region code from which the viewer accessed a media item
                    <br /><br />
                    The value is the <a href="https://en.wikipedia.org/wiki/ISO_3166-2" target="_blank">ISO-3166-2</a> region code.
                </td>
            </tr>
            <tr>
                <td> <strong>SDK_PLATFORM</strong> integer </td>
                <td>SDK platform in which the player was embedded
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: Web</li>
                        <li><code>1</code>: Android</li>
                        <li><code>2</code>: iOS</li>
                        <li><code>3</code>: Roku</li>
                        <li><code>4</code>: tvOS</li>
                        <li><code>5</code>: Chromecast Receiver</li>
                        <li><code>6</code>: Fire OS</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>SETUP_DURATION</strong> integer</td>
                <td>Time in milliseconds (ms) for the player to set up</td>
            </tr>
            <tr>
                <td> <strong>SITE_ID</strong> string </td>
                <td>Unique alphanumeric ID of the site</td>
            </tr>
            <tr>
                <td> <strong>START_TIME</strong> string</td>
                <td>Start time of session in <code>YYYY-MM-DD HH:MM:SS.0000</code> in UTC</td>
            </tr>
            <tr>
                <td> <strong>TIME_THRESHOLD_3S</strong> integer</td>
                <td>Whether the viewer crossed the three second threshold of the video
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: No</li>
                        <li><code>1</code>: Yes</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>TIME_THRESHOLD_10S</strong> integer</td>
                <td>Whether the viewer crossed the ten second threshold of the video
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: No</li>
                        <li><code>1</code>: Yes</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>TIME_THRESHOLD_30S</strong> integer</td>
                <td>Whether the viewer crossed the thirty second threshold of the video
                    <br /><br />
                    <strong>Possible values</strong>:
                    <ul>
                        <li><code>0</code>: No</li>
                        <li><code>1</code>: Yes</li>
                    </ul>
                </td>
            </tr>
            <tr>
                <td> <strong>UNDERBUFFER_CUMULATIVE</strong> integer</td>
                <td>Total milliseconds (ms) spent buffering since the play attempt for a given media item</td>
            </tr>
            <tr>
                <td> <strong>VIDEO_SEEKS</strong> integer</td>
                <td>Total number of times the user used the seek functionality of the player during this play session</td>
            </tr>
            <tr>
                <td> <strong>VIDEO_SHARES</strong> integer</td>
                <td>Total number of times a viewer has clicked an option to share to social media</td>
            </tr>
            <tr>
                <td> <strong>VIEWER_ID</strong> string </td>
                <td>Unique identifier of the viewer
                    <br /><br />
                    The viewer ID is generated based on a combination of the client's IP address and user agent.
                    <br /><br />
                    <strong>NOTE</strong>: The viewer ID does not persist over long periods and will reset when the viewer’s IP address changes or cookies are cleared. It should not be relied on as a long-term identifier.
                </td>
            </tr>
            <tr>
                <td> <strong>VIEWER_TZ_OFFSET</strong> integer </td>
                <td>UTC offset for the timezone of the user represented as an integer from -12 to 14</td>
            </tr>
            <tr>
                <td> <strong>WATCHED_DURATION</strong> integer</td>
                <td>Total duration watched in seconds</td>
            </tr>
            <tr>
                <td> <strong>WATCHED_DURATION_AUDIBLE</strong> integer</td>
                <td>Total duration of content watched with audio unmuted, in seconds</td>
            </tr>
            <tr>
                <td> <strong>WATCHED_DURATION_VIEWABLE</strong> integer</td>
                <td>Total viewable watched duration for this session in seconds
                    <br /><br />
                    In this instance, viewable means that 50% of the video pixels are in the viewport of the active tab.
                </td>
            </tr>
            <tr>
                <td> <strong>WATCHED_PCT</strong> float</td>
                <td>Farthest point in the media reached by the user, as a percentage of the media duration</td>
            </tr>
        </tbody>
    </table>
</span>

<br />

<style>
.rm-Pagination {
  display: none;
}
</style>

# Sibling pages

* [Playback Monthly Aggregates](https://docs.jwplayer.com/platform/docs/play-session-monthly-aggregates-dataset.md)
* [Ad Serving Data](https://docs.jwplayer.com/platform/docs/ad-serving-data.md)
* [Ad Serving Monthly Aggregates](https://docs.jwplayer.com/platform/docs/ad-serving-monthly-aggregates.md)
* [Line Item and Creative Data](https://docs.jwplayer.com/platform/docs/line-item-and-creative-data.md)
* [Streaming Data](https://docs.jwplayer.com/platform/docs/server-side-analytics-datasets.md)
* [Streaming Monthly Aggregates Datasets](https://docs.jwplayer.com/platform/docs/server-side-analytics-monthly-aggregates-datasets.md)
* [Ad Insertion Data](https://docs.jwplayer.com/platform/docs/ad-insertion-data.md)
* [Ad Insertion Monthly Aggregates Dataset](https://docs.jwplayer.com/platform/docs/ad-insertion-monthly-aggregates-dataset.md)
* [Strategy Rules Data](https://docs.jwplayer.com/platform/docs/dynamic-strategy-rules-datasets.md)
* [Media Data](https://docs.jwplayer.com/platform/docs/media-datasets.md)
* [Playlist Data](https://docs.jwplayer.com/platform/docs/playlist-datasets.md)
* [Contractual Usage Data (Daily)](https://docs.jwplayer.com/platform/docs/contractual-usage-data-daily.md)
* [True Anthem Data (Daily)](https://docs.jwplayer.com/platform/docs/true-anthem-data-daily.md)