Metrics and dimensions

Read definitions of each metric and dimension returned in an Analytics API query response.


👍

Premium metrics and dimensions denoted in the following tables require a JW Player Enterprise license.

Metrics

A metric is a quantitative measurement. The following sections list the metrics that we currently offer.

Ads

Name Metric ID Description
Ad Clicks* integer ad_clicks Number of times a video ad was clicked in an embedded player
Ad Completes* integer ad_completes Number of times a video ad was completed in an embedded player
Ad Skips* integer ad_skips Number of times a video ad was skipped in an embedded player

* This premium metric requires a JW Player Enterprise or Developer license.


Engagement

Name Metric ID Description
25% Completes integer 25_percent_completes Number of times viewers watched to the 25% mark of a media item

This metric is only available for media items over 30 seconds.
50% Completes integer 50_percent_completes Number of times viewers watched to the 50% mark of a media item

This metrics is only available for media items over 30 seconds.
75% Completes integer 75_percent_completes Number of times viewers watched to the 75% mark of a media item

This metrics is only available for media items over 30 seconds.
Adjusted Complete Rate percent adjusted_complete_rate Adjusted completes per plays

This metric is not available in dashboard Custom Reports.
Adjusted Completes integer adjusted_completes Used to calculate the Content Score, number of times a viewer watched at least 75% the total duration of a media item

This metric is not available in dashboard Custom Reports.
Complete Rate percent complete_rate Plays per completes, expressed as a percentage
Content Score* integer content_score Average of the play rate and complete rate

* This premium metric requires a JW Player Enterprise or Developer license.


Performance

NameMetric_IDTypeDescription
3-Second Plays☨ 3_second_playsIntegerNumber of times viewers watched to the 3-second mark of a media item
10-Second Plays☨ 10_second_playsIntegerNumber of times viewers watched to the 10-second mark of a media item
30-Second Plays☨ 30_second_playsIntegerNumber of times viewers watched to the 30-second mark of a media item
Ad Impressionsad_impressionsIntegerNumber of ad starts across all embedded players
CompletescompletesIntegerNumber of times a viewer watched the total duration of a media item
EmbedsembedsIntegerNumber of times a player has been set up on a page

The following behaviors can log an embed: loading or refreshing a page with an embedded player, resetting an embedded player without refreshing the page.
Play Rate*play_ratePercentPlays per embeds

Only the first play (based on the firstFrame event) for a given embed is counted.
PlaysplaysIntegerNumber of video starts across all embedded players

The player does not have to be visible for this event to fire. This is based on the firstFrame player event.
Time Watchedtime_watchedIntegerTotal duration of content watched across all embedded players, measured in seconds

This metric excludes the duration of external live streams watched.

* This premium metric requires a JW Player Enterprise or Developer license.
☨ This premium metric requires both a JW Player Enterprise and special authorization. Please contact your JW Player representative.


Viewers

NameMetric_IDTypeDescription
Ad Impressions per Viewer*ads_per_viewerIntegerAverage number of ad impressions for a unique viewer
Logged-In Unique Viewers*logged_in_unique_viewersIntegerNumber of unique authenticated users who have played at least one media item

Values are only returned for OTT Apps that are integrated with a subscriber management provider, such as Cleeng or InPlayer.
Plays per Viewer*plays_per_viewerIntegerAverage number of plays for each unique viewer
Time Watched per Viewer*time_watched_per_viewerIntegerAverage duration of content watched for a unique viewer
Unique Viewers*unique_viewersIntegerNumber of unique users who have played at least one media item

* This premium metric requires a JW Player Enterprise or Developer license.



Dimensions

A dimension is an attribute of your metrics. For example, each Play Event has several attributes that help describe it. JW Player determines what Country it took place in, what Video it was for, what device was used, etc.


Content

NameDimension_IDTypeDescription
Ad Schedule*ad_schedule_idStringID associated with a specific ad schedule
Is First Play*is_first_playBooleanIndicator that the media was the first media item within a playlist
Mediamedia_idStringID of the media item
Media Tag*tagStringMetadata associated with a media item
Play Reason*play_reasonStringIndicator of how media playback was initiated

Possible values:

autoplay: Autostarted playback, not dependent upon player viewability settings
click: A user clicked on the video
external: JavaScript call to the JW Player API
progression: Auto-advance on dynamic and manual playlists
related: Auto-advance on recommendation, search, and trending playlists
repeat: Auto-repeat based on the configuration of the player
unknown: Unknown reason
viewable: Autostarted playback when the player was viewable, dependent upon player viewability settings
Playerplayer_idStringID of the player on the page
Player Playback Modeplayer_playback_modeStringThe player’s playback mode when the first frame of content is rendered.

Possible values include:

VOD: Video on Demand
LIVE: Livestreams that do not support seeking
DVR: Livestreams that support seeking
NULL: Embed without plays

Playlistplaylist_idStringID of the playlist loaded into the player
Playlist Type*playlist_typeStringType of playlist

Possible values include:

Article Matching
Dynamic
Feed1
Manual
None
Search
Trending
Promotion*promotionStringID of the playlist pinned into a recommendations playlist that promoted the media item played in a player
Video Duration*video_duration-Duration of the content

Possible values include:

Short (under 4 mins)
Medium (4-20 mins)
Long (over 20 mins)

* This premium dimension requires a JW Player Enterprise or Developer license.
1 This is the same as a recommendations playlist.


Date/Time

NameDimension_IDTypeDescription
Eastern Dateeastern_dateStringDate when the media item started to play within a player, using YYYY-MM-DD (USA - Eastern Time) format
Upload Date*upload_dateStringDate when the media item was last uploaded to the platform, using YYYY-MM-DD (USA - Eastern Time) format

* This premium dimension requires a JW Player Enterprise or Developer license.


Device

NameDimension_IDTypeDescription
Browser*browserStringType of browser used to watch a media item
Devicedevice_idStringType of device used to watch a media item
Platform*platform_idStringSDK platform in which the player was embedded

Possible values include:

android
chromecast (Chromecast Receiver)
fireos (Fire OS)
ios
roku
tvos (tvOS)
unknown
web

* This premium dimension requires a JW Player Enterprise or Developer license.


Geography

NameDimension_IDTypeDescription
City*cityStringCity from which a user accessed the media item

The value is based on the ISO 3166-2 standard.
Countrycountry_codeStringTwo-letter country code from which a user accessed a media item

The value is the ISO 3166-1 alpha-2 country code.

* This premium dimension requires a JW Player Enterprise or Developer license.


Placement

NameDimension_IDTypeDescription
Domainpage_domainStringDomain within which a player was embedded

Excluding www, all subdomains are also included.
URL*page_urlStringURL of the page within which a player was embedded

* This premium dimension requires a JW Player Enterprise license.