Reports

Information about the various report options available through the serverside.ai API.

Introduction

Every serverside.ai setup comes with a set of built-in reports, that are described in this section. Other reports can be created - please contact our Professional Services division.

Key concepts

There are several key concepts that are to be understood in order to work with the reports API.

Systems

A serverside.ai instance can have various systems. Generally, these are links to external APIs or applications, which extend the functionality of serverside.ai in various ways, e.g. providing encoding or storage or the ad-stitching itself. The systems concept provides also settings, which enable you to flexibly describe any parameters needed to connect and operate each external application.

Each system is uniquely identified by an id(UUID), and the system API routes enable you to inspect them.

Two systems are installed by default, and we will use these as examples here.

  • AMS - Azure Media Services

  • SSAI - Serverside AI

Reports

Reports belong to a particular system, and show statistical information about that system. e.g. for AMS - "Encoding Jobs", "Encoding Minutes". For SSAI, reports include "Impressions per Ad", "Audience Share", and "Viewing Time". Reports are generally shown in the front end as preconfigured charts of various types, and it is also possible to download the data used to generate the charts from there.

For more programmatic control, there is the Reports API described here. This enables parameters to be set exactly as required, such as start and end times, sampling intervals, etc.

In order to fetch a report, you will need to know

  • the system id

  • the report id

  • your serverside.ai API key

Last updated