Statistical Reports

Statistical reports are located in the “Reports” section and have a table view. If the report is too large to be displayed in the web interface, it is suggested to increase the data aggregation period or export the report to a CSV file. The primary data source for reports is the SmartCARE End-User Device API requests of client devices to streaming servers, proxied to the Collector module.

Channel Viewing Statistics

This report allows you to analyze the statistics of watching TV channels and includes the following data:

Parameter in UI

Parameter in CSV report

Description

Channel

channel_name

Channel name.

Note: the channel name is requested by its ID in the corresponding SmartTUBE dictionary.

Start period

period_start

Start time of the data aggregation period.

End period

period_end

End time of the data aggregation period (start time + user-defined aggregation frequency).

Number of viewers (live)

live_auditorium

Number of channel views by all subscribers in Live mode. View — playback of the channel / program by the subscriber device for at least 60 seconds.

If one device for the period played the channel stream 3 times for at least 60 seconds, the number of views will be 3, not 1.

Duration (live)

live_min (in seconds)

Duration of the channel playback in the Live mode by all subscribers (sec).

Number of viewers (DVR)

catchup_auditorium

Number of subscriber devices played the channel in the DVR mode.

If one device for the period played the channel stream 3 times for at least 60 seconds, the number of views will be 3, not 1.

Duration (DVR)

catchup_min

Duration of the channel playback in the DVR mode by all subscribers (sec).

Channel rating (live), %

live_rating

Channel rating by subscriber devices that played it in the Live mode (% of devices that played the channel of the total device number across all channels for the current aggregation period).

Channel rating (DVR), %

catchup_rating

Channel rating by subscriber devices that played it in the DVR mode (% of devices that played the channel of the total device number across all channels for the current aggregation period).

Percentage of channels viewings (live), %

live_viewing

Channel rating by viewing duration in the Live mode (% of the channel viewing duration of the total viewing duration of all channels for the current aggregation period).

Percentage of channels viewings (DVR), %

catchup_viewing

Channel rating by viewing duration in the DVR mode (% of the channel viewing duration of the total viewing duration of all channels for the current aggregation period).

Theoretical audience

theory_auditorium

Theoretical (potential) audience — the number of subscribers for whom the channel is available for viewing (the service is active).

Device type name

devicetype_name

Name of the client device type (if the filter was applied)

fact_auditorium

The sum of live_auditorium (Number of viewers (live)) and catchup_auditorium (Number of viewers (DVR)) fields

total_min

The sum of live_min (Duration (live)) and catchup_min (Duration (DVR)) fields

Channel Coverage

This report allows you to analyze the popularity of TV channels by the number of unique subscribers and includes the following data:

Parameter in UI

Parameter in CSV report

Description

Channel

channel_name

Channel name.

Note: the channel name is requested by its ID in the corresponding SmartTUBE dictionary.

Start period

period_start

Start time of the data aggregation period.

End period

period_end

End time of the data aggregation period (start time + user-defined aggregation frequency).

Unique channel views (live)

cnt_live

Number of unique channel views by all subscriber devices in the Live mode. View — playback of the channel / program by the subscriber device for at least 60 seconds.

If one device for the period played the channel stream 3 times for at least 60 seconds, the number of views will be 1, not 3.

Unique channel views (DVR)

cnt_nonlinear

Number of unique channel views3 by all subscriber devices in the DVR mode.

If one device for the period played the channel stream 3 times for at least 60 seconds, the number of views will be 1, not 3.

Theoretical audience

theory_auditorium

Theoretical (potential) audience — the number of subscribers for whom the channel is available for viewing (the service is active).

Duration (live)

duration_live

Channel playback duration in the Live mode by all subscriber devices (seconds).

Duration (DVR)

duration_nonlinear

The channel playback duration in the DVR mode by all subscriber devices (seconds).

Device type name

devicetype_name

Name of the client device type (if the filter was applied)

Authorization count

The report displays statistics of successful and unsuccessful authorizations of client devices and includes the following data:

Parameter in UI

Parameter in CSV report

Description

Start period

period_start

Start time of the data aggregation period.

End period

period_end

End time of the data aggregation period (start time + user-defined aggregation frequency).

Number of success auth

cnt_all_success

Number of successful authorizations total

Number of error auth

cnt_all_error

Number of failed authorizations total

Number of success auth (unique)

cnt_uniq_success

Number of successful authorizations, summed up by unique client devices. That is, if the client device was successfully authorized 3 times during the aggregation period, the number of unique successful authorizations will be equal to 1.

Number of error auth (unique)

cnt_uniq_error

Number of failed authorizations, summed up by unique client devices. That is, if the client device has failed the authorization 3 times during the aggregation period, the number of unique failed authorizations will be equal to 1.

Detailed viewing history

This report provides channel viewing statistics, detailed by unique client devices and the duration of viewing in various modes. Each row of the report represents one client session. Due to the huge amount of data, this report can only be exported to CSV.

Parameter in CSV report

Description

id

ID of the DB entry containing statistics of this viewing session. For debugging purposes.

uid

Unique ID of the subscriber device (UID)

start

Start time of the viewing session

duration

Duration of viewing (in seconds)

durationMin

Duration of viewing (in minutes, rounded to an integer)

isActive

Whether the client session is active at the time of generating the report:

  • 0 — the session is finished
  • 1 — the session is active

idc

Channel ID

mode

Type of the channel stream:

  • L — multicast
  • DVR — unicast

viewType

Viewing mode:

  • LIVE — viewing channel live
  • CATCHUP — viewing the recorded channel stream

Client Authorizations

This report contains end-user device authorization statistics detailing their UIDs and the number of authorization attempts during the report period. This report is designed to show devices that have some problems and have to re-authorize frequently. Therefore, you can limit the report to the total number of UIDs (default is 100). By clicking on the search results, you can dive into analyzing the device behavior.

VOD View Statistics

As the name implies, this report provides VoD content viewing statistics detailing the following data: Start period, End period, Content Type, Content ID, Name, Episode title, Season number, Episode number, Unique view count, View Count, Duration.

CONTENTS
Sign-in
Sign-in with your SmartLabs Support Portal account credentials to see non-public articles.