ECO Events and Video Metrics
Conviva Video and Conviva ECO are powered by Conviva's high-scale, real-time, on-demand platform that provides fast data accessibility with detailed data granularity, one-click and combinatorial instant filtering, and real-time, continuous measurement of video stream and native/web application quality of experience and audience engagement.
Conviva Video displays video streaming metrics based on data sent from the Conviva video sensor module integrated with the video players. Conviva ECO displays application metrics based on the events collected from application processes and user in-app behaviors. In some cases, the Conviva ECO events can also be used to compile event-based metrics for video stream events, such as plays, attempts, start of rebuffering state, and bitrate switch events.
A single app session in Conviva ECO may have multiple video attempt and/or video play events due to recurring pause and play actions. As a result, several video metrics compiled from Conviva ECO events, such as plays and attempts, will show different metric values from the Conviva Video metrics.
Note: When using Conviva test accounts for ECO and Video session tests, keep in mind that the Video client ID updates every 24 hours, while ECO continues to consume the current client ID. To validate Video and ECO sessions that cross a 24 hour boundary, be sure to re-launch the application or restart the test device to refresh the ECO client IDs. This behavior applies only to Conviva test accounts.
Conviva ECO Event |
Generated from |
Tracks and Monitors |
Related Conviva Video Metric |
---|---|---|---|
c3.sdk.init |
Video SDK initialization |
Conviva SDK initialization | n/a |
c3.video.attempt |
Video player attempt events |
Video attempts Video attempts are typically higher than video plays, as not all attempts lead to successful plays, such as start failures and early exits. Also, a single app session may have multiple video attempt and/or video play events, due to recurring pause and play actions. |
Attempts Counts all attempts to play a video which are initiated when a viewer clicks play or a video auto-plays. |
c3.video.end |
Video session end events |
When a video play ends. |
Ended Plays Counts only video sessions that played and ended. |
c3.video.play |
Video play events |
Video plays Video plays are typically less than video attempts, as not all attempts lead to successful plays, such as start failures and early exits. Also, a single app session may have multiple video attempt and/or video play events, due to recurring pause and play actions. |
Plays Counts the number of plays that started in the current interval, and does not include unsuccessful play attempts. Playing states with less than 200ms of continuous playing time are not counted as plays. |
c3.video.pause |
Video pause events |
Pauses in video A single app session may have multiple video attempt and/or video play events, due to recurring pause and play actions. |
Paused Time Shows the total time the viewer paused the video play during the video session. |
c3.video.error |
c3.isFatal |
When fatal and non-fatal errors occur in the video stream. Video error events. True if fatal, false if not fatal. |
Video Start Failures (VSF, VSF-B, VSF-T) Measures how often Attempts terminated during video startup before the first video frame was played, and a fatal error was reported. Video Play Failures (VPF, VPF-B, VPF-T) Shows the cumulative Ended Plays that terminated with a VPF error. |
c3.video.buffering |
Start of video rebuffering events |
When buffering starts in a video stream. Conviva Video metrics remove continuous rebuffering of more than 90 seconds (extended continuous rebuffering). Micro rebuffering, continuous rebuffering less than 200 milliseconds, is included. |
Rebuffering Ratio Measures the percentage of total video viewing time (playTime + rebufferingTime) during which viewers experienced rebuffering. Connection Induced Rebuffering Ratio Measures the percentage of total video viewing time (playTime plus all rebuffering) during which viewers experienced nonseek rebuffering or connection induced rebuffering. |
c3.video.bitrate_switch |
Bitrate switch events |
When bitrate switches occur in a video stream. |
Bitrate Switches Displays the average number of the bitrate switches for the ended plays in the sessions. |
c3.video.set_content_info |
Video metadata change events |
When metadata changes in a video stream. |
n/a |
c3.sdk.custom_event c3.video.custom_event |
SDK and video custom events |
When custom events occur in a video stream. |
n/a |
c3.ad.ad_break_start |
Ad break start event | When an ad break starts in a video stream. |
n/a |
c3.ad.ad_break_end |
Ad break end event |
When an ad break ends in a video stream. |
n/a |
CWSStateChangeEvent |
Audio, subtitle, and closed captions change events |
When a change event occurs in a video stream. |
n/a |
Conviva video event abbreviations:
an: asset name.
avgbr: average bitrate in kbps.
br: bitrate in kbps.
cen: custom event name.
ced: custom event data.
cl: content length in seconds.
clid: client ID assigned by Conviva to the physical device.
err: error message.
ft: isFatal, a boolean value indicating whether the error is fatal.
fw: framework name in which the media player runs.
fwv: framework version.
iid: instance ID. When several players run on the same device, each player should have a unique instance ID.
lv: isLive, a boolean value indicating whether the content currently playing is Live.
mn: module name
mv: module version
name: device name
newsc: new state change
oldsc: old state change
pn: player name
sid: session id identifying the current session, unique on this client.
sst: session start time as UNIX epoch time in milliseconds.
st: session time from the session start in milliseconds.
tags: supported tags for metadata.
url: manifest URL of the media stream for the session.
vid: viewer ID.
Events Video Metrics Test Account Test Account Test Account Test Session Test Session Test Session Tests Client ID