Player Event Types - Analytics

Player Event Types

The Kaltura Player v7 fires approximately 45 event types that feed the analytics system. Custom player implementations should report these events to achieve parity with the built-in player.

Core Playback Events

Event Type	Description	When to Fire
WIDGET_LOADED	Player widget initialized	Player DOM is ready
MEDIA_LOADED	Media metadata loaded	Source URL resolved and metadata available
PLAY_REQUEST	User initiated playback	Play button clicked or autoplay triggered
PLAY	Playback started	Media begins playing
FIRST_PLAY	First play in session	First play event in this player session
PAUSE	Playback paused	User paused or programmatic pause
SEEK	User seeked	Seek operation completed
REPLAY	User replayed	Playback restarted from beginning

Progress Events (Quartiles)

Event Type	Description	When to Fire
PLAY_REACHED_25	25% completion	Playhead passes 25% of duration
PLAY_REACHED_50	50% completion	Playhead passes 50% of duration
PLAY_REACHED_75	75% completion	Playhead passes 75% of duration
PLAY_REACHED_100	100% completion	Playhead reaches end of content

Fire quartile events only once per playback session. If the user seeks past a quartile point, fire the event when the playhead naturally reaches that position during forward playback.

Quality Events

Event Type	Description	When to Fire
BUFFER_START	Buffering began	Playback stalled for buffering
BUFFER_END	Buffering ended	Playback resumed after buffer
ERROR	Playback error	Fatal or recoverable playback error
SOURCE_SELECTED	Source chosen	Adaptive bitrate source selected
FLAVOR_SWITCH	Quality changed	Bitrate/quality level switched

Engagement Events

Event Type	Description	When to Fire
CAPTIONS	Captions toggled	User enabled/disabled captions
RELATED_CLICKED	Related content clicked	User clicked a related video
SHARE_CLICKED	Share button clicked	User opened share dialog
DOWNLOAD_CLICKED	Download clicked	User initiated download