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, Canal-digital, 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	mandatory for clients that have DAI service (Telia, Telenor, Allente, Canal-digital, 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: "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",
  film_code: "E1UMBR1001",
  is_programmatic: "yes",
  mms_thirdparty: "yes",
  mms_origin: "YuMe",
  break_position: "1/5"
};