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"	yes
assetid	Content ID, mms_tid	unique ID assigned to an asset within the same media house.	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". For VoD, it does not need to follow the simulcast_channelnumber format. Length limit: 20 characters. No special characters	yes
length	Clip Length, ns_st_cl	length of content in seconds	Length of content in seconds. for 24/7 live stream, 86400 for event-Live streams, the planned length for VoD, video length	yes
client_passthrough_parameters	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	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	yes
title	Episode Name, ns_st_ep	episode name	custom example: en-ny-tjej-i-byn	yes
title_playlist	Title Playlist, ns_st_pl	playlist reference as a string	string value with playlist name for example: barn
mms_premium	MMS Premium, mms_premium	identify premium level via yes or no	"yes" or "no"	yes
is_auto_play	Auto Start, mms_auto	identify if autoplay is enabled on the video	"yes" or "no"	yes
plugv	Player Version, ns_st_mv	player version. increment by 1 for each new version.	alphanumeric example: 1.0.1	yes
playerv	Mediaplayer, ns_st_mp	player identifier	alphanumeric example: HTML5, JW Player, Sonic	yes

Example of metadata object for content:

var contentMetadataObject = {
  type: "content", 
  assetid: "simulcast_29",
  length: "3359",
  client_passthrough_parameters: "origcode=29",
  program: "leif-och-billy",
  title: "en-ny-tjej-i-byn",
  title_playlist: "barn",
  mms_premium: "yes",
  is_auto_play: "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.	yes
assetid	Film Code, mms_customadid	custom Ad ID	custom examples: S1MYME202B, 51TRER1001, H1KYLE3032, E1UMBR1001	yes
assetid_content	Content ID, mms_tid	assetid of the content that the ad is linked to.	It has the same value as "assetid" in the "Content Metadata" list	yes
length	Clip Length, ns_st_cl	length of ad in seconds	Length of ad in seconds.	yes
client_passthrough_parameters	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".	mandatory for clients that have DAI service (Telia, Telenor, Allente, Comhem, Boxer, Sappa, Discovery, Cmore)
program	Program Name, ns_st_pr	program name of the content that the ad is linked to	custom example: leif-och-billy
title	Episode Name, ns_st_ep	episode name of the content that the ad is linked to	custom example: en-ny-tjej-i-byn
is_auto_play	Auto Start, mms_auto	identify if autoplay is enabled on the content that the ad is linked to	"yes" or "no"
plugv	Player Version, ns_st_mv	player version. increment by 1 for each new version.	alphanumeric example: 1.0.1	yes
playerv	Mediaplayer, ns_st_mp	player identifier	alphanumeric example: HTML5, JW Player, Sonic	yes
is_programmatic	Programmatic, mms_programmatic	identify if the ad is bought prommatic.	"yes" or "no"	yes
mms_thirdparty	MMS Thirdparty, mms_thirdparty	identify if the ad is from third party ad server	"yes" or "no"	yes
mms_origin	MMS Origin, mms_origin	identify where an ad is originated. It is used when is_programmatic=yes or mms_thirdparty=yes.	custom examples: Smartclip, YuMe	yes
break_position	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.	yes

Example of metadata object for Ad:

var prerollMetadataObject = {
  type: "preroll",
  assetid: "E1UMBR1001", 
  assetid_content: "simulcast_29",
  length: "3359",
  client_passthrough_parameters: "origcode=29",
  program: "leif-och-billy",
  title: "en-ny-tjej-i-byn",
  is_auto_play: "yes",
  mms_premium: "yes",
  plugv: "1.0.1",
  playerv: "Sonic",
  is_programmatic: "yes",
  mms_thirdparty: "yes",
  mms_origin: "YuMe",
  break_position: "1/5"
};