Viewer Tracking Report and Format Explained

With Viewer Tracking you can quickly get a sense of who watched your broadcasts and videos and generally how much they watched. However there are times when you need detailed viewership data, for example to confirm critical part of a video is watched by all participants.


That is when our detailed tracking report comes handy. It is accessible from all Viewer Tracking pages via the “Download full report” button, as shown in the below picture.

On pressing this button you’ll see a CSV (Comma-Separated Values) file downloaded to your computer. You can easily load this file to Excel. In addition this file format makes it possible to easily load into any reporting and analytics software you use. Just look for the respective CSV import feature.

Report structure

The rows (or records) of the report contain view segments and the associated metadata, including the viewer identification data as well as demographic data and technical data. One viewer during a single viewer session will generate multiple view segment records for each view.

      

The rows (or records) of the report contain view segments and the associated metadata, including the viewer identification data as well as demographic data and technical data. One viewer during a single viewer session (which can be seconds, minutes, even hours) will generate multiple, couple of seconds long view segment records which adds up to the full view session. This is due to the technology Ustream employs to deliver content to your viewers.

For example in order to determine a continuous view session for a viewer, you have to add the viewerSeconds for all view segments (records in the report) where the viewSessionId is the same.

You can easily build your own report based on this detailed data export and visualize the data as you see fit. See the next section for an explanation of the various columns available.

Available attributes

title

Contains the name of the Broadcast or Recorded which was watched by the viewer.

channelTitle The name of the channel where the content, identified by "title", belongs to.
type "live" or "recorded". Identifies the type of content. 
broadcastOrVideoId A Ustream-globally unique numeric content identifier.
deviceOrBrowserId An alphanumeric value identifying the browser window/tab or the mobile device of your viewer. This identifier will not change if the same browser/device is used to watch multiple videos/broadcast. 
viewSessionId An alphanumeric value identifying the current view session. A view session consist of one or many view segments, represented by the records or rows in this report. 
viewType  'onsite' or 'embed'. Identifies where the content was consumed, on your portal or in an embedded player.
startedAt  A date and time in Pacific Time timezone when the view segment (the particular row or record) started.
startedAtTimestamp A timestamp when the view segment (the particular row or record) started. 
finishedAt  A date and time in Pacific Time timezone when the view segment (the particular row or record) ended.
finishedAtTimestamp       A timestamp when the view segment (the particular row or record) ended. 
countryCode Two letter country code where the viewer resides
region Two letter state code where the viewer resides (if applies)
city City name where the viewer resides 
device Three letter device or OS identifier
isMobileView '1' or '0'. It is set to '1', it represents Align mobile app views. '0' means the content viewed from a web browser, be it mobile browser or desktop browser.
viewerSecond The view segment length in seconds.
viewerIdentificationString        The identifier sent by your SSO portal, Google Auth or email authentication for your viewer.
userAgentString  The device/user agent identification string sent by the device or browser.
Powered by Zendesk