Digital Measurement SEI Audio Metadata

From Engineering Client Portal

Revision as of 15:54, 3 July 2024 by AbbyArgue (talk | contribs)

Engineering Portal / Digital / Digital Measurement SEI Audio Metadata
The Nielsen “server-2-server” method of collecting DTVR data requires the distributor to make available to Nielsen audio file for each live-streaming channel and each VoD asset that is eligible to DTVR crediting. Please contact your Nielsen Technical contact for a full description of what content is eligible for DTVR crediting.

In addition, to the audio files themselves, the DTVR ingestion process needs to some additional metadata for each audio file; this document specifies the additional “out-of-band” metadata that need to be provided.

The specification is defined using a JSON schema.

File Naming Convention and Location

File should be named with following convention: FileType_MVPDId_AssetId_UTCStart_UTCEnd

File type: DTVRAssetMetaData

MVPDid: unique identifier provided by Nielsen for each MVPD

AssetId: in-house assetId

UTCStart (time in 32-bit unsigned int UTC in seconds from first second of audio captured)

UTCEnd (time in 32-bit unsigned int UTC in seconds from first second of audio captured)

Files should be placed in S3 buckets with the following folder structure:

[To be determined during design phase]

Nielsen will move files to another location as they are processed so processing status is apparent.

In the case of a stream that has one version with blackouts and one without, one with mobile and one non-mobile, each stream would have its own unique asset id.

Nielsen recommends for live-streams that the audio track associated with the live feed be segmented into 15min chunks for delivery to Nielsen.

For VoD, Nielsen recommends using a single audio file, unless the total duration is greater than 6 hours, in which case the file should be broken up into smaller chunks.

For live-streams, the audio file does not need to break on a show boundary. Nielsen recommends breaking on a convenient wall-clock time, such as on the hour, 15past, 30past, 45past etc

Please check with the Nielsen Technical support to confirm the proposed audio format is supported, and if any compression, encryption algorithms or frequency band filters are going to be used to transport the audio files to Nielsen.

SLA

The files must be delivered into the proper S3 bucket within 2 hours of the broadcast. For example, files from 1:00 AM to 1:15 AM must be delivered before 3:00 AM. The metadata file should be delivered to an S3 bucket after the audio files described in this reference file are delivered, and before any Viewing file that would use these audio files has been delivered. Please refer to the associated specifications for the SLA’s of these other files.

JSON Param Definition

Header Record

Parameter Description Mandatory Specified by Format or Example
schemaversion Json Schema Version Yes Nielsen Example: S2SDTVRAssetMetaDataV2.0
apid Server App ID Yes Nielsen Example: A487421B-XXXX-YYYY-8343-E3BBB66E44F2
creationtime File creation time Yes Client Format: utc (time in 32-bit unsigned int UTC in seconds)
assetid In-House Asset Id Yes Client Format: alphanumeric,

Example: VID123456789

assetname In-House video asset name,

used for troubleshooting

Yes Client Format: alphanumeric, Example: "A&E High Def East" or GraceNote channel mnemonic or call station letters
webpageurl Website Identifier, used for diagnostics, can be turned off/on as needed No Client Format: alphanumeric  (max 2k)

Example:http://www.myapp.com/video.html

recordcount # of records in body of file Yes Client Format: numeric

Header JSON Schema:

{

 "$schema": "http://json-schema.org/draft-04/schema#",

 "type": "object",

 "properties": {

   "schemaversion": { "type": "string" },

   "apid": { "type": "string" },

   "creationtime": { "type": "string" },

   "assetid": { "type": "string" },

   "assetname": { "type": "string" },

   "webpageurl": { "type": "string" },

   "recordcount": { "type": "string" }

 },

 "required": [ "schemaversion", "apid", "creationtime", "assetid", "assetname", "recordcount" ]

}

Header Record - Example:

{

 "schemaversion":"S2SDTVRAssetMetaDataV2.0",

 "apid":"A487421B-XXXX-YYYY-8343-E3BBB66E44F2",

 "creationtime":"1473781507",

 "assetid":" VID123456789",

 "assetname":"A&E High Def East",

 "webpageurl":"http://www.myapp.com/video.html",

 "recordcount":"100"

}

Body

Parameter Description Mandatory Specified by Format or Example
audiofilename Audio file name Yes Client Example: aacFile1.aac

Audio files are assumed to be uploaded to the same directory/folder as the associated Asset Metadata file

referencestart Starting in-house reference point for the audio file Yes Client Format: utc (time in 32-bit unsigned int UTC in seconds)

For VoD, this will be an offset from the start of the asset

For Live stream, this will be the in-house time

referenceend End in-house reference point for the audio file Yes Client Format: utc (time in 32-bit unsigned int UTC in seconds)

For VoD, this will be an offset from the start of the asset

For Live stream, this will be the in-house time

Note: All parameters are case sensitive.

Body Message Schema:

{

 "$schema": "http://json-schema.org/draft-04/schema#",

 "type": "object",

 "properties": {

   "audiofilename": { "type": "string" },

   "referencestart": { "type": "string" },

   "referenceend": {  "type": "string" }

 },

 "required": [ "audiofilename", "referencestart", "referenceend" ]

}

Body - Example:

{"audiofilename":"aacFile1.aac","referencestart":"1489506887","referenceend":"1489506889"}