Playback Data
Play Session Daily Definitions
Daily rollups of the play session data
| Column Name | Description |
|---|---|
| AD_CLICKS integer | Number of times an ad was clicked in an embedded player |
| AD_CLIENT integer | Ad client being used
Possible values:
|
| AD_COMPLETES integer | Number of times an ad was completed in an embedded player |
| AD_IMPRESSIONS integer | Number of ad starts across all embedded players |
| AD_SCHEDULE_ID string | ID associated with a specific ad schedule |
| AD_SKIPS integer | Number of times an ad was skipped in an embedded player |
| AD_VIEWABLE_IMPRESSIONS integer | 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)
The following are required to properly receive metrics:
|
| ADVANCE_TYPE string | Denotes the method by which the playlist advanced at the end of this play session
Possible values:
|
| ANALYTICS_ID string | 22-character alphanumeric ID representing a grouping of properties
When segmenting data by a specific property, query by site ID. |
| AVG_PLAYER_HEIGHT float | Average player height in pixels throughout the session |
| AVG_PLAYER_SIZE integer | Average player size bucket throughout the session
The player size is grouped by width. Possible values:
|
| AVG_PLAYER_WIDTH float | Average player width in pixels throughout the session |
| BROWSER string | Browser used to fetch the content
Example values:
The browser is identified based on the user agent string. |
| CITY string | City from which a user accessed the media item
The value is based on the ISO 3166-2 standard. |
| COMPLETES integer | Number of times a viewer watched the end of a media item |
| COUNT_PLAYBACK_STALLS integer | Number of times the player buffers for this play session |
| COUNTRY_CODE string | Two-letter country code from which a user accessed a media item
The value is the ISO 3166-1 alpha-2 country code. |
| DEVICE_TYPE string | Device on which the user experienced the session
Possible values:
|
| EASTERN_DATE string | Date when the media item started to play within a player, using YYYY-MM-DD (USA - Eastern Time) format |
| EMBED_ID string | ID a player instance that is embedded on a page |
| EMBEDS integer | Number of times a player has been set up on a page
The following behaviors can log an embed:
|
| END_TIME string | End time of session in YYYY-MM-DD HH:MM:SS.0000 in UTC |
| FEED_ID string | Unique ID for a playlist |
| FIRST_FRAME integer | Time in milliseconds (ms) until first frame is displayed |
| HAS_AD_BLOCK integer | Indicates if an ad block is detected for this session due to a browser blocking ads
Possible values:
|
| IS_AUTOSTART integer | Player autostart setting for the first video upon embed of the player
Possible values:
|
| IS_CLICK_TO_PLAY integer | Denotes whether the reason for this play is a user click, auto or unknown
Possible values:
|
| MEDIA_DURATION integer | Length of the video in seconds |
| MEDIA_ID string | ID of the media item |
| MEDIA_TITLE string | Title of the media |
| MEDIA_TYPE string | Media type player has played |
| MEDIA_URL string | URL of the media item |
| NUM_AD_BREAKS integer | (IMA) Total number of ad break events that occurred during this session |
| OPERATING_SYSTEM string | Operating system of the device used to fetch content
Possible values:
The operating system is identified based on the user agent string. |
| PAGE_DOMAIN string | Domain within which a player was embedded
By excluding www, all subdomains are also included. |
| PAGE_URL string | URL of the page within which a player was embedded |
| PERCENT_VIEWABLE_WATCH_TIME decimal | Percentage of total watched duration that occurred while the player was viewable
Viewable was defined as at least 50% of the video pixels being visible within the viewport of the active tab. |
| PLACEMENT_EMBED_ID string | Unique ID generated for each placement instance that is embedded on a page |
| PLACEMENT_ID string | ID associated with a placement |
| PLAY_ATTEMPTS integer | Number of play attempts for this session
A play attempt is fired right before the video plays, whether it was user generated or auto-started. |
| PLAY_ID string | Unique ID generated for each play session |
| PLAY_SEQ integer | Item number within a playlist |
| PLAYER_ID string | ID of the player |
| PLAYER_PLAYBACK_MODE string | Player's playback mode when the first frame of content is rendered
Possible values:
|
| PLAYS integer | Number of media item starts
The player does not have to be visible for this event to fire. This is based on the firstFrame player event.
|
| PLUGIN_DOCUMENT_REFERRER string | Referrer to the page where player is embedded
This information is gathered from the DOM. |
| REGION string | Two-letter region code from which the viewer accessed a media item
The value is the ISO-3166-2 region code. |
| SDK_PLATFORM integer | SDK platform in which the player was embedded
Possible values:
|
| SETUP_DURATION integer | Time in milliseconds (ms) for the player to set up |
| SITE_ID string | Unique alphanumeric ID of the site |
| START_TIME string | Start time of session in YYYY-MM-DD HH:MM:SS.0000 in UTC |
| TIME_THRESHOLD_3S integer | Whether the viewer crossed the three second threshold of the video
Possible values:
|
| TIME_THRESHOLD_10S integer | Whether the viewer crossed the ten second threshold of the video
Possible values:
|
| TIME_THRESHOLD_30S integer | Whether the viewer crossed the thirty second threshold of the video
Possible values:
|
| UNDERBUFFER_CUMULATIVE integer | Total milliseconds (ms) spent buffering since the play attempt for a given media item |
| VIDEO_SEEKS integer | Total number of times the user used the seek functionality of the player during this play session |
| VIDEO_SHARES integer | Total number of times a viewer has clicked an option to share to social media |
| VIEWER_ID string | Unique identifier of the viewer
The viewer ID is generated based on a combination of the client's IP address and user agent. NOTE: 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. |
| VIEWER_TZ_OFFSET integer | UTC offset for the timezone of the user represented as an integer from -12 to 14 |
| WATCHED_DURATION integer | Total duration watched in seconds |
| WATCHED_DURATION_AUDIBLE integer | Total duration of content watched with audio unmuted, in seconds |
| WATCHED_DURATION_VIEWABLE integer | Total viewable watched duration for this session in seconds
In this instance, viewable means that 50% of the video pixels are in the viewport of the active tab. |
| WATCHED_PCT float | Farthest point in the media reached by the user, as a percentage of the media duration |
Updated about 1 hour ago