Top videos and User engagement reports

Kaltura analyzes data collected while viewers engage with your content. Each metric is defined below, along with its method of calculation.

Top videos 

System name Descriptive/friendly name Definition
object_id Object ID Entry ID
entry_name Entry Title Name of the entry.
creator_name Entry Creator Name Name of the entry creator.
created_at Creation Time Time the entry was created (in epoch format, which is the date and time relative to which a computer's clock and timestamp values are determined).
status Entry Status Entry status (in enumeration). 
media_type Media Type Media type (in enumeration). 
1 = Video
2= Image
3 = Text
4 = Html
5 = Audio
6 = Show
10 = XML
11 = Document
12 = SWF
13 = PDF
201 = Live stream
202 = Live stream Windows Media
203 = Live steam RealMedia
204 = Live stream QuickTime
duration_msecs Entry Duration (Milliseconds) Duration of video in milliseconds. 
entry_source Entry Source The origin or source of the uploaded entry.
count_plays Total Plays Count Total number of plays.
count_plays_25, count_plays_50, count_plays_75, and count_plays_100
count_plays_25, count_plays_50, count_plays_75, and count_plays_100
These count plays are calculated by the play-through quartiles (25, 50, 75, 100). Each time a user will watch through the 25%, 50%, 75% or 100% point of the video, a play count event will be counted. For example, if a video is 10 seconds long, when a user watched the 25th second, there is a count. 
sum_time_viewed Total Minutes Viewed
(Quartile-Based*)
Total effective viewing time. 
Calculation: The number of minutes in the entry multiplied by the percentage of last quartile viewed.  
Example: The entry is 60 minutes long. The viewer watches 50 minutes of the entry. The last complete quartile viewed is 75%. Total Minutes viewed is 60 X .75 = 45.



avg_time_viewed Average Minutes Viewed (Quartile-Based*)
The average of minutes viewed, calculated by quartile, per play. 
Calculation: "Total Minutes Viewed" divided by the number of plays.
Example: The entry is 60 minutes long. Viewer 1 watches 10 minutes and reaches no quartiles (0%), Viewer 2 watches 25 minutes and reaches 1st quartile (25%), and Viewer 3 watches 40 minutes and reaches 2nd quartile (50%).
Average time viewed is sum of quartiles viewed 0%+25% + 50% = 75% divided by 3 plays = 25% multiplied by 60 minutes = 15 minutes



count_loads Player Impressions Count Number of player impressions. A player impression event is counted each time the player is loaded on the page. 
load_play_ratio Play-to-Impression Ratio Player load to play conversion rate.
Calculation: Total number of plays divided by the total number of player impressions.
avg_view_drop_off Average Drop-off Rate (Quartile-Based*) The average percentage of drop-off quartile (last quartile watched), across all plays. Calculated for VOD entries only.
Calculation: Sum of quartiles viewed by all users divided by the number of plays.
Example: Viewer 1 viewed 100% of the entry (4 quartiles), Viewer 2 viewed 65% (3 quartiles), and Viewer 3 viewed 40% (2 quartiles). Sum of quartiles viewed is 4+3+2 = 9. Number of plays is 5. Average Drop-Off Rate is 9 divided by 5 = 1.8 quartiles. This means, on average, users watched about 45% of the entry (since 1.8 out of 4 quartiles = 45%).
unique_known_users Unique Users Count Number of unique users that sent an event in the specific report.
engagement_ranking Engagement Ranking (1-10) This is an engagement score that ranges from 1-10.
avg_completion_rate Average Completion Rate (Interval-Based*) Average percentage of completion, across all plays. Calculated for VOD only.
Calculation: Sum of the percentiles that the user has viewed divided by the number of plays.
Example: Viewer 1 viewed 60% of the entry, Viewer 2 viewed 40%, and Viewer 3 viewed 80%. Sum of percentiles viewed is 60+40+80 = 180. Number of plays is 3. Average Completion Rate is 180 divided by 3 = 60%.
unique_viewers Unique Viewers Count Number of unique users that sent a play event. 
sum_view_period Total Minutes Viewed
(Interval-Based*)
View time calculated from events sent every 10 seconds during VOD and live streams (excluding meetings).
avg_view_period_time Average Minutes Viewed (Interval-Based*)
Average duration a viewer spends actively watching content - whether on VOD or live streams - per play.
Calculation: "Total Minutes Viewed" divided by the number of plays.
Example: Viewer 1 watched one minute. Viewer 2 watched two minutes. Viewer 3 watched 1 minute. Total view time is 60+120+60 = 240 seconds. Number of plays is 3. Average View Period Time is 240 divided by 3 = 80 seconds.


User engagement

System nameDescriptive/friendly name Definition
idID Email address for the user.
full_nameFull Name First name + last name of the user. 
unique_videosUnique Videos Viewed Count Number of videos that were viewed in the category.
count_playsTotal Plays Count Total number of plays.
count_plays_25, count_plays_50, count_plays_75, and count_plays_100
count_plays_25, count_plays_50, count_plays_75, and count_plays_100
These count plays are calculated by the play-through quartiles (25, 50, 75, 100). Each time a user will watch through the 25%, 50%, 75% or 100% point of the video, a play count event will be counted. For example, if a video is 10 seconds long, when a user watched the 25th second, there is a count. 
sum_time_viewedTotal Minutes Viewed
(Quartile-Based*)
Total effective viewing time. 
Calculation: The number of minutes in the entry multiplied by the percentage of last quartile viewed.  
Example: The entry is 60 minutes long. The viewer watches 50 minutes of the entry. The last complete quartile viewed is 75%. Total Minutes viewed is 60 X .75 = 45.
avg_time_viewedAverage Minutes Viewed
(Quartile-Based*)
The average of minutes viewed, calculated by quartile, per play. 
Calculation: "Total Minutes Viewed" divided by the number of plays.
Example: The entry is 60 minutes long. Viewer 1 watches 10 minutes and reaches no quartiles (0%), Viewer 2 watches 25 minutes and reaches 1st quartile (25%), and Viewer 3 watches 40 minutes and reaches 2nd quartile (50%).
Average time viewed is sum of quartiles viewed 0%+25% + 50% = 75% divided by 3 plays = 25% multiplied by 60 minutes = 15 minutes
avg_view_drop_offAverage Drop-off Rate
(Quartile-Based*)
The average percentage of drop-off quartile (last quartile watched), across all plays. Calculated for VOD entries only.
Calculation: Sum of quartiles viewed by all users divided by the number of plays.
Example: Viewer 1 viewed 100% of the entry (4 quartiles), Viewer 2 viewed 65% (3 quartiles), and Viewer 3 viewed 40% (2 quartiles). Sum of quartiles viewed is 4+3+2 = 9. Number of plays is 5. Average Drop-Off Rate is 9 divided by 5 = 1.8 quartiles. This means, on average, users watched about 45% of the entry (since 1.8 out of 4 quartiles = 45%).
count_loadsPlayer Impressions Count Number of player impressions. A player impression event is counted each time the player is loaded on the page.
load_play_ratioPay-to-Impression Ratio Player load to play conversion rate.
Calculation: Total number of plays divided by the total number of player impressions.
avg_completion_rateAverage Completion Rate
(Interval-Based*)
Average percentage of completion, across all plays. Calculated for VOD only.
Calculation: Sum of the percentiles that the user has viewed divided by the number of plays.
Example: Viewer 1 viewed 60% of the entry, Viewer 2 viewed 40%, and Viewer 3 viewed 80%. Sum of percentiles viewed is 60+40+80 = 180. Number of plays is 3. Average Completion Rate is 180 divided by 3 = 60%.
count_viralEntry Shares Count Number of times the entry was shared from the player.
total_completion_rateTotal Completion Rate
(Interval-Based*)
Number of percentiles viewed per user.
sum_view_periodTotal Minutes Viewed
(Interval-Based*)
View time calculated from events sent every 10 seconds during VOD and live streams (excluding meetings).
avg_view_period_timeAverage Minutes Viewed (Interval-Based*)
Average duration a viewer spends actively watching content - whether on VOD or live streams - per play.
Calculation: "Total Minutes Viewed" divided by the number of plays.
Example: Viewer 1 watched one minute. Viewer 2 watched two minutes. Viewer 3 watched 1 minute. Total view time is 60+120+60 = 240 seconds. Number of plays is 3. Average View Period Time is 240 divided by 3 = 80 seconds.

*Video tracking events are specific milestones that are tracked while someone is watching a video. When talking about Quartile-Based video tracking events, we are referring to events fired when a viewer reaches certain percentages of the video's length (25%, 50%, 75%, and 100%). When talking about Interval-Based video tracking events, we are referring to events fired every 10 seconds of viewing/playback.

Was this article helpful?
Thank you for your feedback!
User Icon

Thank you! Your comment has been submitted.

In this article
Related articles
Back to top

Never miss a thing!

Subscribe to our customer newsletter and our release notes updates, so you always get the best out of Kaltura.
Newsletter