Sweden SDK Metadata

Engineering Portal / Digital / International DCR / Sweden SDK Metadata

Digital Metadata

Digital Metadata can pass through key values using the Nielsen reserved keys. The keys and values are listed by the product below.
Section 1 focuses on the content metadata
Section 2 focuses on the Ad metadata.

Content Metadata

Nielsen Key	MMS Attribute Name, MMS Field Name	Description	Values	Required
type		type of asset	"content"	✓
assetid	Content ID, mms_tid	unique ID assigned to an asset within the same media house.	For VoD use internal format. Length limit: 20 characters. No special characters For content on simulcast channels, this has a standard format: simulcast_channelnumber (Example for Channel TV4, the expected value is: simulcast_29). A complete list of channel reference libraries with channel numbers is on the MMS homepage tab "referensbandade kanaler".	✓
length	Clip Length, ns_st_cl	length of content in seconds	Length of content in seconds. for VoD, video length for event-Live stream, the planned length for simulcast and 24/7 live stream, 86400	✓
clientpassparam	MMS Values, mms_values	pass-through parameters	For clients that provide DAI (dynamic ad insertion) service, this has a standard format: origcode=channelnumber. Example: origcode=29 See the complete list of channel reference library with the channel number on MMS homepage tab "referensbandade kanaler". Please convert all JSON objects into strings.	mandatory for clients that have DAI service (Telia, Telenor, Allente, Comhem, Boxer, Sappa, Discovery, Cmore)
program	Program Name, ns_st_pr	program name	custom example: leif-och-billy Leave blank for simulcast.	✓
title	Episode Name, ns_st_ep	episode name	custom example: en-ny-tjej-i-byn Leave blank for simulcast.	✓
playlisttitle	Title Playlist, ns_st_pl	playlist reference as a string	string value with playlist name for example: barn
ispremiumsubscriber	MMS Premium, mms_premium	identify premium level via yes or no	"yes" or "no"	✓
isautoplay	Auto Start, mms_auto	identify if autoplay is enabled on the video	"yes" or "no"	✓
plugv	Player Version, ns_st_mv	player version. increment by 1 for each new version.	alphanumeric example: 1.0.1	✓
playerv	Mediaplayer, ns_st_mp	player identifier	alphanumeric example: HTML5, JW Player, Sonic	✓

Example of metadata object for content:

var contentMetadataObject = {
  type: "content", 
  assetid: "simulcast_29",
  length: "3359",
  clientpassparam: "origcode=29",
  program: "leif-och-billy",
  title: "en-ny-tjej-i-byn",
  playlisttitle: "barn",
  ispremiumcontent: "yes",
  isautoplay: "yes",
  plugv: "1.0.1",
  playerv: "Sonic"
};

Ad Metadata

Nielsen Key	MMS Attribute Name, MMS Field Name	Description	Values	Required
type	Ad Type, ns_st_ad	type of ad	"preroll", "midroll", "postroll", "ad" if specific ad type cannot be identified.	✓
assetid	Film Code, mms_customadid	custom Ad ID	Film code/Copy code. Custom examples: S1MYME202B, 51TRER1001, H1KYLE3032, E1UMBR1001	✓
length	Clip Length, ns_st_cl	length of ad in seconds	Length of ad in seconds.	✓
isprogrammatic	Programmatic, mms_programmatic	identify if the ad is bought prommatic.	"yes" or "no"
isthirdpartyad	MMS Thirdparty, mms_thirdparty	identify if the ad is from third party ad server	"yes" or "no"
adplatformorigin	MMS Origin, mms_origin	identify where an ad is originated. It is used when isprogrammatic=yes or isthirdpartyad=yes.	custom examples: Smartclip, YuMe
adidx	Position in Break, ns_st_an	placement in ad break. It is passed by ad servers.	Custom with the following format: {ad placement}/{total number of ads in an ad break} Example: 2/5, the second ad in an ad break with 5 ads.	✓

Example of metadata object for Ad:

var prerollMetadataObject = {
  type: "preroll",
  assetid: "E1UMBR1001", 
  length: "3359",
  isprogrammatic: "yes",
  isthirdpartyad: "yes",
  adplatformorigin: "YuMe",
  adidx: "1/5"
};