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
  • DASH VOD Manifest
  • HLS VOD Manifest
  • Ad-Server Parameter
  • MRSS
  1. Video Player/App

VOD - DASH/HLS

DASH VOD Manifest

POST https://live.serverside.ai/ad-aggregation-service/mrss/channel/:channelId

Get a VoD DASH Manifest for an existing MRSS playlist

Path Parameters

Name
Type
Description

channelId

string

Id of the channel in serverside.ai

Headers

Name
Type
Description

api-key

string

Get it from the channel in serverside.ai

Request Body

Name
Type
Description

deliverytypes

string

Static and always [ "dash" ]

url

string

URL to the mRSS feed

{
    "dash": {
        "url": "https://vodcms.blob.core.windows.net/mrss/serverside_mrss_dash_preroll_midroll.mrssd",
        "clips": [
            {
                "category": "intro",
                "titleId": null,
                "title": "intro",
                "duration": 4000
            },
            {
                "category": "ad",
                "titleId": "Ferrero_Love_Brands_WM_2018_4_Praemienmov",
                "title": "mov.ad instream ad via adition : 11244",
                "duration": 15000
            },
            {
                "category": "outro",
                "titleId": null,
                "title": "outro",
                "duration": 4000
            },
            {
                "category": null,
                "titleId": null,
                "title": "15 Fakten zu den MIGHTY MORPHIN POWER RANGERS!",
                "duration": 11520
            }
        ]
    }
}

Example Request Body:

{
  "url": "https://vodcms.blob.core.windows.net/mrss/serverside_mrss_dash_preroll_midroll.mrss"
  "deliverytypes": [ "dash" ]
}

HLS VOD Manifest

POST https://live.serverside.ai/ad-aggregation-service/mrss/channel/:channelId

Get a VoD HLS Manifest for an existing MRSS playlist

Path Parameters

Name
Type
Description

channelId

string

Id of the channel in serverside.ai

Headers

Name
Type
Description

api-key

string

Get it from the channel in serverside.ai

Request Body

Name
Type
Description

deliverytypes

string

static and always [ "hls" ]

url

string

URL to the mRSS feed

{
    "hls": {
        "url": "https://staging-live.serverside.ai/ad-stitcher/m3u8/89ecfca4-fff2-4141-9ead-c6f824bf66b2.m3u8",
        "clips": [
            {
                "category": "ad",
                "titleId": "httpscdnspotxcdncommediavideosorig1010fa3ca3af9f4600e3eb580eb4da5afcmp4",
                "title": "DH - TB - PS - HOUSEAD NAB19 WOK 30SEC - NOWTILUS - DE",
                "duration": 30071.708,
            },
            {
                "category": "content",
                "titleId": null,
                "title": "Cosmo_Laundromat",
                "duration": 30030
            },
            {
                "category": "ad",
                "titleId": "httpscdnspotxcdncommediavideosorig2a2a1a62db20be5d414bff66b6e7ae7e86mp4",
                "title": "DH - TB - PS - HOUSEAD NAB19 WOK 10SEC - NOWTILUS - DE",
                "duration": 10051.708,
            },
            {
                "category": "content",
                "titleId": null,
                "title": "Cosmo_Laundromat",
                "duration": 30030
            },
            {
                "category": "ad",
                "titleId": "httpscdnspotxcdncommediavideosorig1010fa3ca3af9f4600e3eb580eb4da5afcmp4",
                "title": "DH - TB - PS - HOUSEAD NAB19 WOK 30SEC - NOWTILUS - DE",
                "duration": 30071.708,
            },
            {
                "category": "content",
                "titleId": null,
                "title": "Cosmo_Laundromat",
                "duration": 653277.625
            }
        ]
    }
}

Example Request Body:

{
  "url": "https://vodcms.blob.core.windows.net/mrss/serverside_mrss_hls_preroll_midroll.mrss",
  "deliverytypes": [ "hls" ]
}

Ad-Server Parameter

Example Request Body for SpotX:

{
  "url": "https://vodcms.blob.core.windows.net/mrss/serverside_mrss_hls_preroll_midroll.mrss",
  "context": "web",
  "ifa": "ifa",
  "deliverytypes": [ "hls" ]
}

MRSS

The supported format for VoD based ad-insertion is MRSS.

In the item block a custom block ad:cuepoints is used, that holds the cuepoint information.

Parameter description

Field

Type

Mandatory

Description

cuepoint id

String

yes

splicetime

Integer

yes

0=pre-role | -1= post-role | splicetime in milliseconds for mid-roll

maxcount

Integer

no

Maximum number of ads for the given ad break

duration

Integer

yes

Ad break duration in seconds

intro

no

TBD

outro

no

TBD

MRSS XSD

MRSS Example

<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:ad="http://ssai.nowtilus.tv/mrss/" xmlns:media="http://search.yahoo.com/mrss/">
  <channel>
    <title>VoD Playlist</title>
    <link></link>
    <description>Intro</description>
    <item>
      <title>Hinter den Kulissen</title>
      <media:content url="https://hostname/6671a1574df08e28392a140713b9d7c5.jpeg" medium="image"></media:content>
      <media:content url="https://hostname/vod/L2QfSeA81Qg/playlist_hd.m3u8" type="application/vnd.apple.mpegurl"></media:content>
      <media:content url="https://hostname/vod/L2QfSeA81Qg/HD_manifest.mpd" type="application/dash+xml"></media:content>
      <ad:cuepoints>
        <cuepoint id="adpod-0">
          <splicetime>0</splicetime>
          <maxcount>2</maxcount>
          <duration>45</duration>
          <intro type="application/vnd.apple.mpegurl" url="https://hostname/vod/4O5_sMiF1Qg/playlist_hd.m3u8"></intro>
          <intro type="application/dash+xml" url="https://hostname/vod/4O5_sMiF1Qg/HD_manifest.mpd"></intro>
          <outro type="application/vnd.apple.mpegurl" url="https://hostname/vod/x7OmjR2I1Qg/playlist_hd.m3u8"></outro>
          <outro type="application/dash+xml" url="https://hostname/vod/x7OmjR2I1Qg/HD_manifest.mpd"></outro>
        </cuepoint>
      </ad:cuepoints>
    </item>
</channel>
</rss>

PreviousLive - DASH/HLSNextVAST Tracking

Last updated 1 year ago

You may have to add additional parameters for the ad-server you are using. For details see:

Detailed information can be found here:

Ad-Server Parameter
http://www.rssboard.org/media-rss
2KB
serverside_ai_vod.xsd
XSD for MRSS validation