App Events and Video Metrics
Video and App 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.
Video displays video streaming metrics based on data sent from the Video Sensor integrated with the video players. App displays application metrics based on the events collected from application processes and user in-app behaviors. In some cases, App 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 App 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 App events, such as plays and attempts, will show different metric values from the Video metrics.
Note: When using Conviva test accounts for App and Video session tests, keep in mind that the Video client ID updates every 24 hours, while App continues to consume the current client ID. To validate App and Video sessions that cross a 24-hour boundary, re-launch the application or restart the test device to refresh the client IDs. This behavior applies only to Conviva test accounts.
|
App Event |
Generated from |
Tracks and Monitors |
Related Conviva SEI Metric |
|---|---|---|---|
|
c3.sdk.init |
SEI 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 Exits Before Video Start (EBVS). 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 EBVS. 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.