Skip to main content

Analytic Events

MobileWebTV Platforms
Android logoiOS logoResponsive Web logoWebTV logoAndroidTV logoRoku logoTvOS logo

DIVA's SDK provides tracking events that are exposed externally to your host application.

const divaParams = {
...,
onAnalyticEvent: (event) => {
console.log(event.type)
}
}

All events in DIVA's player are raised through a callback. You can then use your own Analytics plugin to track events.

All DIVA events are identified using the AnalyticsEvent object payload. This structure provides the following parameters:

  • type: String

    • type name of event.
  • interactive: boolean

    • if true, this specifies when the event is generated as a result of user interaction.
  • eventArguments: Map

    • dictionary which contains all the generic arguments (for instance videoMetaData parameters) and the specific event parameter. Arguments list

DIVA Events‚Äč

Here, all the available events tracked in DIVA's player are listed. If the platform is not mentioned, the event is available across all supported platforms.

360 player‚Äč

note

These events are available on: Android logo iOS logo

video360_open‚Äč

  • Description: Every time the 360 overlay appears
  • Interactive: False
  • EventArguments: N/A

video360_close‚Äč

  • Description: Every time the 360 overlay disappears
  • Interactive: False
  • EventArguments: N/A

video360_close_click‚Äč

  • Description: Every time a user selects the close button
  • Interactive: True
  • EventArguments: N/A

video360_list_open‚Äč

  • Description: Every time the 360 list overlay appears
  • Interactive: False
  • EventArguments: N/A

video360_list_close‚Äč

  • Description: Every time the 360 list overlay disappears
  • Interactive: False
  • EventArguments: N/A

video360_list_click‚Äč

  • Description: Every time a user selects a video from a list
  • Interactive: True
  • EventArguments: selected_video_id

video360_vr_button_click‚Äč

  • Description: Every time a user selects the VR/cardboard button
  • Interactive: True
  • EventArguments: N/A

video360_vr_button_close_click‚Äč

  • Description: Every time a user selects the close VR/cardboard button
  • Interactive: True
  • EventArguments: N/A

video360_vr_enable‚Äč

  • Description: Every time a user enters VR mode from the 360 module
  • Interactive: False
  • EventArguments: N/A

video360_vr_disable‚Äč

  • Description: Every time a user exits VR mode from the 360 module
  • Interactive: False
  • EventArguments: N/A

Advertising‚Äč

ad_start‚Äč

  • Description: When a train of ADs start
  • Interactive: False
  • EventArguments: ad_type

ad_stop‚Äč

  • Description: When a train of ADs stop
  • Interactive: False
  • EventArguments: ad_type

ad_manual_stop Android logo iOS logo Responsive Web logo‚Äč

  • Description: When the AD is stopped by a user via the back button
  • Interactive: False
  • EventArguments: ad_type

ad_single_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: When a user selects an AD
  • Interactive: True
  • WventArguments: ad_type

ad_single_mute Responsive Web logo‚Äč

  • Description: When an AD is muted
  • Interactive: False
  • EventArguments: ad_type

ad_play_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: When a user selects the controls to play a paused AD
  • Interactive: True
  • EventArguments: ad_type

ad_pause_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: When a user selects the controls to pause an AD
  • Interactive: True
  • EventArguments: ad_type

ad_single_resume Android logo iOS logo Responsive Web logo‚Äč

  • Description: When an AD resumes playback
  • Interactive: False
  • EventArguments: ad_type

ad_single_pause Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time an AD is paused
  • Interactive: False
  • EventArguments: ad_type

ad_single_fail‚Äč

ad_single_start‚Äč

  • Description: Every time an AD starts
  • Interactive: False
  • EventArguments: ad_type

ad_single_stop‚Äč

  • Description: When an AD stops
  • Interactive: False
  • EventArguments: ad_type

ad_single_skip Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time an AD is skipped by a user
  • Interactive: False
  • EventArguments: ad_type

Alert‚Äč

note

These events are NOT available for WebTV logo

alert_open‚Äč

alert_close‚Äč

alert_click‚Äč

alert_close_click‚Äč

multiview_goalalert_open (sidebyside_goalalert_open)Responsive Web logo‚Äč

  • Renamed from version 5.8
  • Description: Every time a user selects an alert notification and enters Side-by-Side view
  • Interactive: False
  • EventArguments: alert_type

multiview_goalalert_close (sidebyside_goalalert_close)Responsive Web logo‚Äč

  • Renamed from version 5.8
  • Description: Every time a user exits Side-by-Side view (goal alert)
  • Interactive: False
  • EventArguments: alert_type, section_time_spent

multiview_open (sidebyside_multiview_open) Responsive Web logo‚Äč

  • Renamed from version 5.8
  • Description: Every time a user opens a new video in Side-by-Side view (multi-view)
  • Interactive: False
  • EventArguments: N/A

multiview_close (sidebyside_multiview_close) Responsive Web logo‚Äč

  • Renamed from version 5.8
  • Description: Every time a user exits Side-by-Side view (mult-iview)
  • Interactive: False
  • EventArguments: section_time_spent

back_notification_open Responsive Web logo‚Äč

  • Description: Every time a back notification alert is displayed
  • Interactive: False
  • EventArguments: selected_video_id

back_notification_close Responsive Web logo‚Äč

  • Description: Every time a back notification alert is closed (automatically or by user)
  • Interactive: False
  • EventArguments: selected_video_id

back_notification_click Responsive Web logo‚Äč

  • Description: Every time a user selects a back notification alert to jump back to the original video
  • Interactive: True
  • EventArguments: selected_video_id

back_notification_close_click Responsive Web logo‚Äč

  • Description: Every time a user selects the close button
  • Interactive: True
  • EventArguments: selected_video_id

Alternate Timeline‚Äč

note

These events are NOT available for WebTV logo

alternate_timeline_open‚Äč

  • Description: Every time the Alternate Timeline is displayed
  • Interactive: False
  • EventArguments: N/A

alternate_timeline_close‚Äč

  • Description: Every time the Alternate Timeline is closed (automatically or by user)
  • Interactive: False
  • EventArguments: section_time_spent

alternate_timeline_item_click‚Äč

  • Description: Every time a user selects an Alternate Timeline item
  • Interactive: True
  • EventArguments: playbyplay_type

alternate_timeline_swipe_navigation‚Äč

  • Description: Every time a user swipes to navigate through the Alternate Timeline
  • Interactive: True
  • EventArguments: N/A

alternate_timeline_arrow_navigation‚Äč

  • Description: Every time a user selects arrows to navigate through the Alternate Timeline
  • Interactive: True
  • EventArguments: N/A

alternate_timeline_tooltip_open Responsive Web logo‚Äč

  • Description: Every time a user hovers over a play by play icon (event marker) and the tooltip appears
  • Interactive: False
  • EventArguments: playbyplay_type, playbyplay_time

alternate_timeline_tooltip_click Responsive Web logo‚Äč

alternate_timeline_tooltip_see_all_click Responsive Web logo‚Äč

  • Description: Every time a user selects a tooltip 'See all highlights' link to open the Alternate Timeline at that specific time
  • Interactive: True
  • EventArguments: playbyplay_type, playbyplay_time

Enhanced Timeline‚Äč

enhanced_timeline_list_open Android logo iOS logo‚Äč

  • Description: Every time the event list of the Enhanced Timeline is opened
  • Interactive: False
  • EventArguments: N/A

enhanced_timeline_list_close Android logo iOS logo‚Äč

  • Description: Every time the event list of the Enhanced Timeline is closed
  • Interactive: False
  • EventArguments: N/A

enhanced_timeline_list_close_click Android logo iOS logo‚Äč

  • Description: Every time a user closes the event list of the Enhanced Timeline
  • Interactive: True
  • EventArguments: N/A

enhanced_timeline_list_item_click Android logo iOS logo‚Äč

  • Description: Every time a user selects close on one of the event list items
  • Interactive: True
  • EventArguments: N/A

enhanced_timeline_item_click Android logo iOS logo‚Äč

  • Description: Every time a user selects close on one of the Enhanced Timeline event markers
  • Interactive: True
  • EventArguments: N/A

enhanced_timeline_arrow_navigation WebTV logo‚Äč

  • Description: Every time a user navigates through the Event List (which is done by using left/right directional keys on remote control while Event List is in focus)
  • Interactive: True
  • EventArguments: N/A

Buttons‚Äč

ccat_menu_button_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the user actions the "Audio and Subtitles" on-screen button, while the "Audio and Subtitles" main menu or any of its submenus are not yet opened/visible
  • Interactive: True
  • EventArguments: N/A

ccat_menu_open Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the "Audio and Subtitles" main menu is opened, as a result of user actioning the "Audio and Subtitles" on-screen button, or otherwise
  • Interactive: False
  • EventArguments: N/A

ccat_menu_close Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the "Audio and Subtitles" main menu closes, no matter if it was a result of user action or not
  • Interactive: False
  • EventArguments: N/A

audiotrack_list_open‚Äč

  • Description: Every time the "Audio" submenu is opened/expanded
  • Interactive: False
  • EventArguments: N/A

audiotrack_list_close‚Äč

  • Description: Every time the "Audio" submenu is closed/collapsed
  • Interactive: False
  • EventArguments: N/A

audiotrack_button_click‚Äč

  • Description:
    • Small screens : Every time the user actions the "Audio" menu item inside the consolidated CC/AD menu, intended to expand/open the "Audio" sub-menu. Android logo iOS logo Responsive Web logo
    • TV platforms : Description: Every time a user interacts with the Audio tracks button. AndroidTV logo Roku logo TvOS logo WebTV logo
  • Interactive: True
  • EventArguments: N/A

audiotrack_selection Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user applies a new audio track from the "Audio" submenu
  • Interactive: True
  • EventArguments: audio_value, audio_display_name

closed_caption_list_open‚Äč

  • Description: Every time the "Subtitles" submenu is opened/expanded
  • Interactive: False
  • EventArguments: N/A

closed_caption_list_close‚Äč

  • Description: Every time the "Subtitles" submenu is closed/collapse
  • Interactive: False
  • EventArguments: N/A

closed_caption_button_click‚Äč

  • Description:
    • Small screens : Every time the user actions the "Subtitles" menu item inside the consolidated CC/AD menu, intended to expand/open the "Audio" sub-menu Android logo iOS logo Responsive Web logo
    • TV platforms : Description: Every time a user interacts with the Close Captions button. AndroidTV logo Roku logo TvOS logo WebTV logo
  • Interactive: True
  • EventArguments: N/A

closed_caption_selection Android logo iOS logo Responsive Web logo‚Äč

relevant_commentary_button_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the Relevant Commentary toggle button
  • Interactive: True
  • EventArguments: active

custom_button_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects a custom button defined in a custom template
  • Interactive: True
  • EventArguments: active, action

pip_button_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the native PiP button
  • Interactive: True
  • EventArguments: N/A

multiview_button_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the multiview button
  • Interactive: True
  • EventArguments: N/A

settings_menu_button_click Responsive Web logo‚Äč

  • Description: Every time the user actions the "Settings" on-screen button, while the "Quality" main menu or any of its submenus are not yet opened/visible
  • Interactive: True
  • EventArguments: N/A

settings_menu_open Responsive Web logo‚Äč

  • Description: Every time the "Settings" main menu is opened, as a result of user actioning the "Settings" on-screen button, or otherwise
  • Interactive: False
  • EventArguments: N/A

settings_menu_close Responsive Web logo‚Äč

  • Description: Every time the "Settings" main menu closes, no matter if it was a result of user action or not
  • Interactive: False
  • EventArguments: N/A

quality_list_open Responsive Web logo‚Äč

  • Description: Every time the "Quality" submenu is opened/expanded
  • Interactive: False
  • EventArguments: N/A

quality_list_close Responsive Web logo‚Äč

  • Description: Every time the "Quality" submenu is closed/collapsed
  • Interactive: False
  • EventArguments: N/A

quality_button_click Responsive Web logo‚Äč

  • Description: Every time the user actions the "Quality" menu item inside the consolidated Settings menu, intended to expand/open the "Quality" sub-menu.
  • Interactive: True
  • EventArguments: N/A

quality_selection Responsive Web logo‚Äč

Commentary‚Äč

note

These events are NOT available for WebTV logo

commentary_open‚Äč

commentary_close‚Äč

commentary_click‚Äč

Control bar‚Äč

controlbar_open Android logo iOS logo‚Äč

  • Description: Every time the control bar appears
  • Interactive: False
  • EventArguments: controlbar_type

controlbar_close Android logo iOS logo‚Äč

  • Description: Every time the control bar disappears
  • Interactive: False
  • EventArguments: controlbar_type

controlbar_play‚Äč

  • Description: Every time a user selects the play button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_pause‚Äč

  • Description: Every time a user selects the pause button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_fullscreen Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the full-screen button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_seek_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user seeks by selecting the timeline
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_seek_back Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the seek back button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_seek_forward Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the seek forward button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_go_live‚Äč

  • Description: Every time a user selects the Go Live button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_mute Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the mute button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_unmute Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the the unmute button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_volume_change Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user changes the volume
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_commentary Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the Commentary button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_alternate_timeline Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the Alternate Commentary button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_chapter_list_click Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time a user selects the Chapter List button
  • Interactive: True
  • EventArguments: controlbar_type

controlbar_chapter_list_item_click Android logo iOS logo Responsive Web logo‚Äč

controlbar_chapter_list_open Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the chapter list opens
  • Interactive: False
  • EventArguments: controlbar_type

controlbar_chapter_list_close Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the chapter list closes
  • Interactive: False
  • EventArguments: controlbar_type

controlbar_collapse_click Responsive Web logo‚Äč

  • Dismissed from version 5.8
  • Description: Every time a user selects the Collapse button in multiview visualization mode
  • Interactive: True
  • EventArguments: controlbar_type

Chromecast‚Äč

note

These events are NOT available for WebTV logo

chromecast_click Android logo iOS logo‚Äč

  • Description: Every time a user selects the Chromecast icon
  • Interactive: True
  • EventArguments: N/A

chromecast_open Android logo iOS logo‚Äč

  • Description: Every time a user enters Chromecast mode
  • Interactive: False
  • EventArguments: N/A

chromecast_close Android logo iOS logo‚Äč

  • Description: Every time a user exits Chromecast mode
  • Interactive: False
  • EventArguments: N/A

chromecast_background Android logo iOS logo‚Äč

  • Description: Every time the app goes into the background
  • Interactive: False
  • EventArguments: N/A

chromecast_foreground Android logo iOS logo‚Äč

  • Description: Every time the app goes in the foreground
  • Interactive: False
  • EventArguments: N/A

E-commerce‚Äč

note

These events are NOT available for WebTV logo

ecommerce_notification_open Responsive Web logo‚Äč

  • Description: Every time an E-commerce notification alert is displayed
  • Interactive: False
  • EventArguments: N/A

ecommerce_notification_close Responsive Web logo‚Äč

  • Description: Every time a an E-commerce notification alert is closed (automatically, by a user or by selecting the E-commerce notification action button)
  • Interactive: False
  • EventArguments: N/A

ecommerce_notification_click Responsive Web logo‚Äč

  • Description: Every time a user selects an E-commerce notification action button
  • Interactive: True
  • EventArguments: extId

ecommerce_notification_close_click Responsive Web logo‚Äč

  • Description: Every time a user selects an E-commerce notification alert close button
  • Interactive: True
  • EventArguments: N/A

ecommerce_icon_click Responsive Web logo‚Äč

  • Description: Every time a user selects an E-commerce shop icon
  • Interactive: True
  • EventArguments: N/A

Errors‚Äč

videometadata_error‚Äč

  • Description: Every time an error on VideoMetaData is raised
  • Interactive: False
  • EventArguments: N/A

ssai_error‚Äč

  • Description: Error generated in case of failure of the DAI manifest request
  • Interactive: False
  • EventArguments: error_code, error_description

entitlement_error‚Äč

  • Description: Every time a ENTITLEMENT error is raised by the video component. This is considered a special sub-type of video_error.
  • Interactive: False
  • EventArguments: error_code, error_description Responsive Web logo WebTV logo

Highlights‚Äč

highlights_mode‚Äč

  • Description: Every time a user enters Highlights mode
  • Interactive: False
  • EventArguments: highlights_type

highlights_fullmatch_click‚Äč

  • Description: Every time a user selects the Full Match button
  • Interactive: True
  • EventArguments: N/A

highlights_next_click‚Äč

  • Description: Every time a user selects the next button
  • Interactive: True
  • EventArguments: N/A

highlights_close_on_pip‚Äč

  • Description: Every time a user selects the Live PiP to close the Highlights mode and return to the live video
  • Interactive: True
  • EventArguments: N/A

highlights_notification_open‚Äč

  • Description: Every time a Highlights notification alert is displayed
  • Interactive: False
  • EventArguments: N/A

highlights_notification_close‚Äč

  • Description: Every time a Highlights notification alert is closed (automatically or by a user)
  • Interactive: False
  • EventArguments: N/A

highlights_notification_click‚Äč

  • Description: Every time a user selects a Highlights notification alert to enter in Highlights mode
  • Interactive: True
  • EventArguments: N/A

LiveLike‚Äč

note

This event is NOT available for WebTV logo

influencer_chat_icon_click‚Äč

  • Description: Every time the icon of Influencer chat is selected
  • Interactive: True
  • EventArguments: N/A
note

These events are NOT available for WebTV logo

  • Description: Every time the menu appears
  • Interactive: False
  • EventArguments: N/A
  • Description: Every time the menu disappears
  • Interactive: False
  • EventArguments: N/A
  • Description: Every time a user selects on close menu button
  • Interactive: True
  • EventArguments: N/A
  • Description: Every time a user selects the menu button
  • Interactive: True
  • EventArguments: N/A
  • Description: Every time a user selects the menu item button
  • Interactive: True
  • EventArguments: overlay_id

Overlay‚Äč

note

These events are NOT available for WebTV logo

overlay_open‚Äč

overlay_close‚Äč

PiP view‚Äč

note

These events are NOT available for WebTV logo

pip_multiview_open‚Äč

  • Description: Every time a user opens a new video in PiP view
  • Interactive: False
  • EventArguments: N/A

pip_multiview_close‚Äč

  • Description: Every time the user exit from PiP view
  • Interactive: False
  • EventArguments: section_time_spent

pip_show_multiview_click‚Äč

  • Dismissed from version 5.8
  • Description: Every time a user selects to show (Side-by-side view) on relative PiP button
  • Interactive: True
  • EventArguments: default arguments

pip_swap_videos_click‚Äč

  • Description: Every time a user selects to swap Side-by-side on relative PiP button
  • Interactive: True
  • EventArguments: default arguments

pip_close_click‚Äč

  • Description: Every time a user selects to close PiP on relative PiP button
  • Interactive: True
  • EventArguments: default arguments

Player‚Äč

player_open‚Äč

  • Description: Every time that a user enters DIVA
  • Interactive: False
  • EventArguments: hdr_mode Android logo iOS logo

enter_fullscreen Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the player enters full-screen mode
  • Interactive: False
  • EventArguments: default arguments

exit_fullscreen Android logo iOS logo Responsive Web logo‚Äč

  • Description: Every time the player exits full-screen mode
  • Interactive: False
  • EventArguments: default arguments

enter_zoommode Android logo iOS logo‚Äč

  • Description: Every time the player enters zoom mode
  • Interactive: True
  • EventArguments: default arguments

exit_zoommode Android logo iOS logo‚Äč

  • Description: Every time the player exits zoom mode
  • Interactive: True
  • EventArguments: default arguments

modalvideo_open Android logo iOS logo‚Äč

  • Description: Every time a user enters DIVA modal mode
  • Interactive: False
  • EventArguments: N/A

modalvideo_close Android logo iOS logo‚Äč

  • Description: Every time a user closes DIVA modal mode
  • Interactive: False
  • EventArguments: section_time_spent

modalvideo_close_click Android logo iOS logo‚Äč

  • Description: Every time a user selects the close button in DIVA modal mode
  • Interactive: True
  • EventArguments: N/A

Recommendations‚Äč

note

These events are NOT available for WebTV logo

Recommendation_open‚Äč

  • Description: Every time the Recommendations panel is open
  • Interactive: False
  • EventArguments: default arguments

recommendation_close‚Äč

  • Description: Every time the Recommendations panel is closed
  • Interactive: False
  • EventArguments: default arguments

Recommendation_autoload‚Äč

  • Description: Every time DIVA automatically loads the next video
  • Interactive: False
  • EventArguments: default arguments

recommendation_replay_click‚Äč

  • Description: Every time a user selects the current video 'Watch again' button in the Recommendations panel
  • Interactive: True
  • EventArguments: default arguments

recommendation_next_click‚Äč

  • Description: Every time a user selects the current video 'Watch next' video link (under current video) in the Recommendations panel
  • Interactive: True
  • EventArguments: default arguments

recommendation_other_click‚Äč

  • Description: Every time a user selects a video from the videolist in the Recommendations panel
  • Interactive: True
  • EventArguments: default arguments

Settings‚Äč

settings_open‚Äč

  • Description: Every time a user opens the Settings panel
  • Interactive: False
  • EventArguments: default arguments

settings_close‚Äč

  • Description: Every time a user selects the close button in DIVA modal mode
  • Interactive: False
  • EventArguments: default arguments

settings_wizard_click Android logo iOS logo Responsive Web logo‚Äč

  • Dismissed since DIVA 5
  • Description: Every time a user opens the Wizard button via the Settings panel
  • Interactive: True
  • EventArguments: N/A

settings_audio_selection AndroidTV logo Roku logo TvOS logo WebTV logo‚Äč

  • Description: Every time a user selects the Audio panel to change Audio track
  • Interactive: True
  • EventArguments: audio_value

settings_closed_caption_selection AndroidTV logo Roku logo TvOS logo WebTV logo‚Äč

  • Description: Every time a user selects the Subtitles and Captioning panel to change/disable Subtitles and Captioning track
  • Interactive: True
  • EventArguments: closed_caption_value

settings_hdr_enable_click Android logo iOS logo WebTV logo‚Äč

  • Description: Every time a user enables HDR via the Settings panel
  • Interactive: True
  • EventArguments: N/A

settings_hdr_disable_click Android logo iOS logo WebTV logo‚Äč

  • Description: Every time a user disables HDR via the Settings panel
  • Interactive: True
  • EventArguments: N/A

settings_button_click WebTV logo‚Äč

  • Description: Every time the on-screen "Settings" button is actioned by user
  • Interactive: True
  • EventArguments: N/A

Start with two videos‚Äč

note

This event is NOT available for WebTV logo

two_video_start‚Äč

Timeline markers‚Äč

marker_open Responsive Web logo WebTV logo‚Äč

  • Description: Every time the tooltip or event marker appears
  • Interactive: False
  • EventArguments: marker_type, marker_time

marker_click Responsive Web logo‚Äč

  • Description: Every time a user selects an event marker
  • Interactive: True
  • EventArguments: marker_type, marker_time

Video‚Äč

video_open‚Äč

  • Description: Every time an user opens a new video
  • Interactive: False
  • EventArguments: video_protection

video_close‚Äč

video_start‚Äč

video_end‚Äč

video_play‚Äč

video_pause‚Äč

video_error‚Äč

video_drm_error‚Äč

video_seek‚Äč

video_playback_info_event‚Äč

video_milestone_25‚Äč

video_milestone_50‚Äč

video_milestone_75‚Äč

video_volume_change‚Äč

  • Description: When video volume changes
  • Interactive: False
  • EventArguments: player_volume

video_loopback‚Äč

  • Description: When player_mode is chromeless, loop is enabled and video is automatically restarted after video end
  • Interactive: False
  • EventArguments: default arguments

Video list‚Äč

videolist_item_click‚Äč

videolist_item_focus WebTV logo‚Äč

videolist_listmode_exit WebTV logo‚Äč

  • Description: Triggered every time user specifically exits the video list mode, returning to the currently loaded video without jumping / switching to another video stream, via one of the video list items. list item. Happens by as user returns to the main player controls, from within the video list mode.
  • Interactive: True
  • EventArguments: videolist_type, overlay_id

videolist_listmode_open WebTV logo‚Äč

  • Description: Triggered every-time video list mode is accessed / entered, regardless on what specific VL is shown first. Happens as user navigates down, from main controls, while at least one video list is available.
  • Interactive: True
  • EventArguments: videolist_type, overlay_id

multiview_videolist_open‚Äč

multiview_videolist_close‚Äč

multiview_videolist_close_click‚Äč

  • Description: Every time the user clicks on multiview videolist close button
  • Interactive: true
  • EventArguments: videolist_type, overlay_id

videolist_item_add_multiview‚Äč

videolist_item_remove_multiview‚Äč

multiview_exit_click‚Äč

  • Description: Every time a user clicks on the exit button in multiview mode
  • Interactive: True
  • EventArguments: N/A

multiview_exit_confirm_click‚Äč

  • Description: Every time a user clicks on confirm exit multiview button
  • Interactive: True
  • EventArguments: N/A

multiview_exit_cancel_click‚Äč

  • Description: Every time a user clicks on cancel exit multiview button
  • Interactive: True
  • EventArguments: N/A

Wizard‚Äč

Dismissed

Dismissed since DIVA 5

wizard_open‚Äč

  • Description: Every time the Wizard is opened (automatically or by a user)
  • Interactive: False
  • EventArguments: N/A

wizard_close‚Äč

  • Description: Every time the Wizard is closed
  • Interactive: False
  • EventArguments: section_time_spent Responsive Web logo

wizard_auto_open‚Äč

  • Description: Every time the Wizard is opened automatically
  • Interactive: False
  • EventArguments: N/A

End Of Play‚Äč

endofplay_open‚Äč

  • Description: Event triggered whenever the current time reaches the max duration (and so the video_end event has been tracked) and so the users get to the end of the playing video and the EoP view is presented.
  • Interactive: False
  • EventArguments: N/A

endofplay_replay_click‚Äč

  • Description: Event triggered when the "Replay" button, from within the EoP screen, is manually actioned by the end user. It will be naturally followed up by the EoP close event.
  • Interactive: True
  • EventArguments: N/A

endofplay_auto_videoplay‚Äč

  • Description: Event trigger whenever Diva automatically loads the next video from the EoP view. This applies to items in recommended video list or highlights list. It will be naturally followed up by the EoP close event.
  • Interactive: False
  • EventArguments: videolist_type, overlay_id, videolist_item_video_id

endofplay_close‚Äč

  • Description: Event triggered whenever the EoP screen closes down (no longer showing on-screen), regardless of reason (e.g. new video initiated, replay used, user is in highlights mode, EoP screen manually closed by user, Diva app exited, etc...). It will be naturally followed up by the EoP close event.
  • Interactive: False
  • EventArguments: N/A

endofplay_videolist_item_click‚Äč

  • Description: Every time a user actions a video list item/card, and therefore switching to the new video stream. It will be always followed up by the EoP close event. When a video in a video list is automatically played, then the "endofplay_auto_videoplay" event is applied instead. This is a clone of the "videolist_item_click" event, with just a different name to differentiate the place of origin. It will be naturally followed up by the EoP close event.
  • Interactive: True
  • EventArguments: videolist_type, overlay_id, videolist_item_video_id

endofplay_videolist_item_focus‚Äč

  • Description: Every time navigational focus is moved from one video list item to another, by user. Default focus when video list opens is not accounted here. This is a clone of the "videolist_item_focus" event, with just a different name to differentiate the place of origin.
  • Interactive: True
  • EventArguments: videolist_type, overlay_id, videolist_item_video_id

endofplay_highlights_mode‚Äč

  • Description: Triggered when Diva enters the Highlights mode, regardless if triggered by user (actioning a HL card in HL list), or automatically as part of EoP screen. It will be always followed up by the EoP close event. This is a clone of the "highlights_mode" event, with just a different name to differentiate the place of origin.
  • Interactive: True
  • EventArguments: highlights_type

endofplay_recommendation_other_click‚Äč

  • Description: Triggered when user selects (actions) a video from the recommendations video list. It will be always followed up by the EoP close event. This is a clone of the "recommendation_other_click" event, with just a different name to differentiate the place of origin.
  • Interactive: True
  • EventArguments: videolist_type, overlay_id, videolist_item_video_id

DIVA Events Arguments‚Äč

info

The mandatory arguments for all the events are videoId, video_display_mode and player_mode for all events and display_orientation for native mobile only

videoId‚Äč

  • Description: Unique ID of the video

player_mode‚Äč

  • Description: The mode in which the player is initialized.
info

Values:

  • fullscreen
  • embed
  • chromeless

video_display_mode‚Äč

  • Description: Type of video visualization, always in lowercase.
info

Values for Responsive Web logo:

  • single
  • 360
  • main_side
  • main_side_360
  • slave_side
  • slave_side_360
  • main_goalalert_side
  • main_goalalert_side_360
  • slave_goalalert_side
  • slave_goalalert_side_360
  • multiview_pip
  • multiview_pip_360

Values for Android logo iOS logo:

  • single
  • 360
  • modal
  • vr
  • airplay
  • chromecast

ad_type‚Äč

  • Description: Type of advertisement: "pre", "mid", "post"

selected_video_id‚Äč

  • Description: Video id selected to load

section_time_spent‚Äč

  • Description: How many seconds a view (e.g. goalalert, multiview ecc...) remains open

alert_type‚Äč

  • Description: The type of alert (if empty 'generic' string is used)

playbyplay_type‚Äč

  • Description: It contains the type of playbyplay if has a specific timeline icon associated (Goal, Yellow card, ...), 'generic' in other cases

playbyplay_time‚Äč

  • Description: It contains the time in seconds of the playbyplay relative to the video

overlay_id‚Äč

  • Description: The analytic identifier of the action, always in lowercase

overlay_template‚Äč

  • Description: The analytic identifier of the template used for the overlay All available templates for HTML5 player: fullVideo | fullPage | sideBySide | leftSideVideo | rightSideVideo All available templates for mobile platform Android iOS: fullVideo | mobileContextual
info

Values for Responsive Web logo:

  • fullVideo
  • fullPage
  • sideBySide
  • leftSideVideo
  • rightSideVideo

Values for Android logo iOS logo:

  • fullVideo
  • mobileContextual

All the other platforms have fullVideo as default value.

overlay_mode‚Äč

  • Description: The analytics identify the overlay mode Possible values are: default | contextual
info

Values:

  • default
  • contextual

action‚Äč

  • Description: Defines the action of the button, always in lowercase
info

Values:

  • alternate_timeline
  • audiotracks
  • chapters
  • chromecast
  • closed_captions
  • commentary
  • expand
  • fullscreen
  • pip
  • play_pause
  • relevant_commentary
  • seek_back
  • seek_forward
  • sideview
  • swap
  • volume

active‚Äč

  • Description: State of the button true | false

controlbar_type‚Äč

  • Description: Type of control bar
info

Values:

  • full = Main DIVA control bar
  • multiview = Controlbar used in multi-view (Side-by-side view)
  • simple = For small player size

audio_value‚Äč

  • Description: Value of the audio selected

audio_display_name‚Äč

  • Description: Label of the audio selected

closed_caption_value‚Äč

  • Description: Value of the Closed Caption of the audio selected

closed_caption_display_name‚Äč

  • Description: Label of the Closed Caption of the audio selected

quality_value‚Äč

  • Description: Value of the quality selected

quality_display_name‚Äč

  • Description: Label of the quality selected

chapter_title‚Äč

  • Description: Contains the title of the Chapter selected

chapter_starttime‚Äč

  • Description: Contains the absolute start time in milliseconds of the Chapter selected (Unix Timestamp)

chapter_endtime‚Äč

  • Description: Contains the absolute end time in milliseconds of the Chapter selected (Unix Timestamp)

commentary_notification_items‚Äč

  • Description: Defines the number of Commentary items not viewed by the user. It corresponds to the number of notifications in the badge of the Commentary button

extId‚Äč

  • Description: The E-commerce item ID

error_code‚Äč

  • Description: Contains the error code

error_description‚Äč

  • Description: Contains a brief description of the error

highlights_type‚Äč

  • Description: Contains the highlights filter (possible values: 'short', 'medium', 'long', 'live')
info

Values:

  • short
  • medium
  • long
  • live

hdr_mode‚Äč

  • Description: HDR mode
info

Values:

  • none
  • hdr10

video_protection‚Äč

  • Description: Type of video protection
info

Values:

  • none
  • widevine
  • playready
  • fairplay
  • aes

video_current_time‚Äč

  • Description: Time, in seconds, of the video at the moment of the event dispatch

video_duration‚Äč

  • Description: Duration, in seconds, of the video at the moment of the event dispatch

player_volume‚Äč

  • Description: The value of the volume. Values from 0 to 1.

video_current_bitrate‚Äč

  • Description: Bitrate, in Kbps, of the video at the moment of the event dispatch.
info

The HTML5 player is not available on iOS devices and on Safari desktop with Native Player. For the iOS player, this value is available only when the AVPlayer plugin exposes it - e.g., not available in the d3_vide_start event

video_total_time_view‚Äč

  • Description: Total time of video view, in seconds, by user for this video (time of videoPlayback). This could be larger than the duration.

video_total_time_paused‚Äč

  • Description: Total time of video on pause, in seconds, by user for this video (time of video on pause). This could be larger than the duration.

video_total_time_on_video‚Äč

  • Description: Total time over the video, in seconds. This could be larger than the duration

video_max_time_reach‚Äč

  • Description: Maximum time reached by the user, in seconds

video_max_percentage_reach‚Äč

  • Description: Maximum time reached by the user, as a percentage

video_current_status‚Äč

  • Description: Current status of video (play, pause, error)

video_seek_time‚Äč

  • Description: Time of seek request in seconds

marker_type‚Äč

  • Description: Contains the type of marker if it has a specific associated timeline icon (Goal, Yellow card, ...), generic in other cases

marker_time‚Äč

  • Description: Contains time in seconds of the event marker relative to the video

videolist_type‚Äč

  • Description: The type of videolist
info

Values:

  • switch
  • multiview
  • pipview
  • multistreamSwitch
  • multistreamMultiview
  • multistreamPipview
  • modal Android logo iOS logo

videolist_item_video_id‚Äč

  • Description: the vidoeId of the videolist item clicked

videolist_item_video_id‚Äč

  • Description: The video id of the item in the videolist was clicked

videoid2‚Äč

  • Description: The videoid of the second video

diva_display_mode‚Äč

  • Description: Template type of DIVA video visualization, always in lowercase
info

Values:

  • multiview
  • pipview