Smartsight Error API

Mediamelon's Smartsight Error API provides access to verbose data and dimensions associated with playback errors, helping you optimize your streaming services for a better user experience.

Welcome to the Error API documentation for Mediamelon, the premier provider of streaming analytics solutions. Our Smartsight Error API not only provides access to verbose data about playback errors during streaming, but also offers access to various dimensions associated with playback that can provide more context about the errors. By leveraging these dimensions, you can gain deeper insights into the nature of errors and better understand the factors that contribute to playback issues. This document will guide you through the process of integrating our Smartsight Error API into your system, and help you make the most of the dimensions and error data that it provides. With this information at your fingertips, you can optimize your streaming services and provide your users with a superior viewing experience.

The structure of the API is as follows

// Error API Structure

https://smartsight2.mediamelon.com/mm-apis/qbrData/getError/
<Customer ID>?period=start%3D<start epoch time stamp in mS> ,end%3D
<end epoch time stamp in mS>&filter=<dimension1>%3D<value1>,<dimension2>%3D<value2>&offset=<starting record number>&
limit=<total records to display>

An example would be

// Example API call

https://smartsight2.mediamelon.com/mm-apis/qbrData/getError/
159268936?period=start%3D1679769000,end%3D1679855400&
filter=key%3DAD_VAST_ERROR,player%3DiOSNativePlayer_10.0
&offset=0&limit=10

// The response would be in JSON

{
  "responseHeader":{
    "zkConnected":true,
    "status":0,
    "QTime":1,
    "params":{
      "q":"custId:159268936 AND timestamp:[1679769000 TO 1679855400] AND (key:\"AD_VAST_ERROR\") AND (player:\"iOSNativePlayer_10.0\")",
      "start":"0",
      "rows":"10",
      "wt":"javabin",
      "version":"2"}},
  "response":[
    {
      "id":"1257965666",
      "timestamp":1679778540,
      "custId":159268936,
      "ttl":"+8DAYS",
      "error":" Ad Error VAST ",
      "key":"AD_VAST_ERROR",
      "category":"AD_FATAL",
      "frequency":1,
      "player":"iOSNativePlayer_10.0",
      "device":"STB",
      "platform":"Android",
      "cdn":"Amazon",
      "adserver":"Facebook Audience Network",
      "adposition":"post",
      "assetId":"86563",
      "assetName":"Godfather_I",
      "episodeNumber":"unknown",
      "season":"unknown",
      "seriesTitle":"unknown",
      "domainName":"unknown",
      "subscriberid":"d0e034edbea54488a9457ad424eec388",
      "sessionid":"SIM2376608",
      "streamURL":"http://playertest.longtailvideo.com/mm3837/gf1/hd/master.m3u8",
      "videoID":"97546",
      "timestamp_dt":"Sat Mar 25 21:10:05 UTC 2023",
      "expire_at_dt":"Sun Apr 02 21:10:05 UTC 2023",
      "_version_":1761375530891870208},
      ...... 9 more responses
      ]
    }

Filter Dimensions

// Using adserver , player and videoID  as filters

https://smartsight2.mediamelon.com/mm-apis/qbrData/getError/159268936?period=start%3D1679769000,end%3D1679855400&filter=adserver%3DAdSense,player%3DiOSNativePlayer_10.0,videoID%3D1404&offset=0&limit=10

Last updated