SERVERSIDE.AI
  • Welcome to serverside.ai
  • Getting Started
    • Prerequisites
    • Onboarding Guide
      • Serverside.ai: Create an account
      • Prepare content source
        • Encoding specification
        • Packaging specification
        • Ad-Marker specification
          • SSAI LIVE - SCTE35
          • SSAI VoD - AdCuePoints
      • Request SSAI enabled stream
    • Features
  • Content Source
    • Encoding
    • Packaging
      • HLS
      • DASH
    • Protection
    • Ad-Marker Specifications
  • Video Player/App
    • Live - DASH/HLS
    • VOD - DASH/HLS
    • VAST Tracking
      • Live - DASH
      • Live - HLS
      • VOD - DASH/HLS
      • ClientSideTracking SDK
    • Timeshift/Startover for LIVE
    • Playlist size for LIVE
    • PauseLiveTV
  • Ad-Server Integration
    • Ad-Server Parameter
      • Equativ/ SmartAdServer
      • Freewheel
      • Google Ad Manager
      • SpotX
    • GVA - Generic VAST Adapter
      • GVA - Configuration
    • 3rd Party Audience Data Integration/DMP
  • Ad Media Condition and Delivery
    • Ad Media - Origin integration
    • Ad Media - CDN integration
    • Prefetch API
  • Manual - User Interface
    • Account
    • Channels/Streams
    • Reports
    • Assets
  • REST API
    • Channels
      • API routes - Channels
      • VOD Channels
      • Detailed channel analysis errors
    • Reports
      • API Routes - reports
    • Playlists
    • Error responses for all routes
    • Further Documentation
  • Support
    • About support case management
    • Creating a case
    • Case language
    • Case processing
    • Booking a meeting
    • Requesting elevated attention
    • Closing a case
  • FAQ - Questionnaire - Glossary
    • Q&A
    • Questionnaire
    • Glossary
    • Files
  • Quality of Service
  • Release Notes
    • Version 2.1.0.x
    • Version 2.0.7.x
    • Version 2.0.6.x
    • Version 2.0.5.x
Powered by GitBook
On this page
  • Introduction
  • Key concepts
  1. REST API

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

PreviousDetailed channel analysis errorsNextAPI Routes - reports

Last updated 1 year ago