Dimension: player

URL parameters

Analytics API reports support the following URL parameters.

URL Parameters
Parameter	Description	Required	Values	Default
`account`	The accounts you want to report on	yes	one or more account ids as a comma-delimited list	none
`dimensions`	The dimension(s) to report on	yes	one or more dimensions as a comma-delimited list (some combinations are not valid - use the interactive tool here to determine if a combination is valie)	none
`where`	Used to specify filters for reports	no	{dimension}=={value} - one or more as a semi-colon-delimited list. The value will be one or more values for the primary metric of that dimension. For example: `video==video_id`, `country=country-code`, or `viewer=viewer_id` (in the last case, the form of the viewer_id will vary depending on whether you are capturing and sending some kind of viewer_id yourself or depending on the value generated by the analytics system).	none
`limit`	Number of items to return	no	positive integer	10
`offset`	Number of items to skip	no	positive integer	0
`sort`	Field to sort items on	no	any field that is being returned by the request	video_view
`fields`	Fields to return	no	varies according to the dimension you are reporting on	video,video_view
`format`	Format to return results in	no	json (default) \| csv \| xlxs	json
`reconciled`	If included, will limit results to either historical or realtime data. Analytics data is derived from multiple sources: some is sent by the player, but other data is collected from CDNs and the Video Cloud system. In order to deliver analytics as quickly as possible, we start delivering "real-time" data as soon as it is available, and then adjust the analytics later when data from all sources has been collected and processed. The fully processed data is called reconciled	no	true \| false	true
`from`	The beginning of the date range for the request	no	One of the following: An ISO 8601 date (YYYY-MM-DD) Epoch time in milliseconds (example: 1659641316719 [= Thursday, August 4, 2022 7:28:36.719 PM GMT]). See the Epoch time converter. A string: `from=alltime` +/- relative dates in days (d), weeks (w), or months (m) - example: `from=-6m&to=%2B2w` (the period from 6 months ago to 2 weeks after that -- note that the + sign needs to be URI encoded as `%2B`) Only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.	-30d
`to`	The end of the date range for the request	no	One of the following: An ISO 8601 date (YYYY-MM-DD) Epoch time in milliseconds (example: 1659641316719 [= Thursday, August 4, 2022 7:28:36.719 PM GMT]). See the Epoch time converter. A string: `to=now` +/- relative dates in days (d), weeks (w), or months (m) - example: `from=-6m&to=%2B2w` (the period from 6 months ago to 2 weeks after that -- note that the + sign needs to be URI encoded as `%2B`) Only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.	now

Fields available

The following fields can be returned for the dimension.

ad_mode_begin - the number of times the player entered ad mode
ad_mode_complete - the number of times the player completed ad mode
bytes_delivered - total bytes delivered to client machines for the player and associated media
engagement_score - the average engagement score for a videos played in a player
play_request - total number of times video playback was requested
play_rate - the average play rate (video views divided by impressions) for a video
player - the player id
player_load - the number of times a player was loaded
player_name
video_engagement_1 - the number of views at the 1 percent point of the video
video_engagement_100 - the total number of views at the 100 percent point of duration of videos played in the player
video_engagement_25 - the total number of views at the 25 percent point of duration of videos played in the player
video_engagement_50 - the total number of views at the 50 percent point of duration of videos played in the player
video_engagement_75 - the total number of views at the 75 percent point of duration of videos played in the player
video_impression - the total number of videos loaded into the player
video_percent_viewed - the sum of percent viewed of videos in the player
video_seconds_viewed - total seconds of videos viewed in the player
video_view - total times video playback started in the player

Filter values

Used as a filter, a dimension allows you to narrow the results.

Filter values: player ids as a comma-delimited list

Combining dimensions

To see what dimensions this on can be combined with, and what fields are available for the combination, see Dimension and Fields.

Request Examples

Dimension request

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=player

Filter request

    https://analytics.api.brightcove.com/v1/data?accounts=1752604059001&dimensions=player&where=player==qsvobWoRx

Sample Response

{
  "item_count": 102,
  "items": [
    {
      "video_view": 1,
      "player": "players.brightcove.com/1752604059001/Y4jYJKe82_default"
    },
    {
      "video_view": 1,
      "player": "players.brightcove.com/1752604059001/AGkFatykc_default"
    },
    {
      "video_view": 1,
      "player": "players.brightcove.com/1752604059001/default_default/true"
    },
    {
      "video_view": 2,
      "player": "players.brightcove.com/1752604059001/1OHQdsTAr_default"
    },
    {
      "video_view": 2,
      "player": "players.brightcove.com/1752604059001/HybvHcK_default"
    },
    {
      "video_view": 2,
      "player": "players.brightcove.com/1752604059001/27mn0s7nD_default"
    },
    {
      "video_view": 3,
      "player": "players.brightcove.com/1752604059001/b547079e-00cc-4585-b354-04020a7ed70a_default"
    },
    {
      "video_view": 3,
      "player": "players.brightcove.com/1752604059001/WRgbJgqAe_default"
    },
    {
      "video_view": 3,
      "player": "players.brightcove.com/1752604059001/B1ELWRgeg_default"
    },
    {
      "video_view": 4,
      "player": "players.brightcove.com/1752604059001/YQMkeKRuP_default"
    }
  ],
  "summary": {
    "video_view": 45135
  }
}