Dimension: <code translate="No">player</code>

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)	none
`where`	Used to specify filters for reports	no	{dimension}=={value} - one or more as a semi-colon-delimited list	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	a valid field for the request	video_view
`fields`	Fields to return	no	varies according to the dimension you are reporting on	video_view
`format`	Format to return results in	no	json \| csv \| xlxs	json
`reconciled`	If included, will limit results to either historical or realtime data	no	true \| false	true
`from`	The beginning of the date range for the request	no	An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string alltime, or relative date (-1m); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.	30 days prior to now
`to`	The end of the date range for the request	no	An ISO 8601 date (YYYY-MM-DD), epoch time in milliseconds, the string now, or relative data (+7d); only dates within the past 32 days are allowed for engagement endpoints or if reconciled=false.	now

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

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

Filter values: player ids as a comma-delimited list

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

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

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

    Response will appear here when you test a request