YaminiKumawat: changed 86400 to 0 for live stream

2018-12-13T15:24:50Z

changed 86400 to 0 for live stream

← Older revision		Revision as of 15:24, 13 December 2018
Line 92:		Line 92:
	\| airdate \|\| The original airdate for linear TV \|\| <code>'20161013 20:00:00'</code> \|\| date \|\| No		\| airdate \|\| The original airdate for linear TV \|\| <code>'20161013 20:00:00'</code> \|\| date \|\| No
	\|-		\|-
	\| length \|\| Length of content in seconds \|\| <code>3600</code> (~~86400~~ for ~~lives tream~~)\|\| integer \|\| Yes		\| length \|\| Length of content in seconds \|\| <code>3600</code> (0 for live stream)\|\| integer \|\| Yes
	\|-		\|-
	\| segB \|\| Custom Reporting Segment \|\| <code>custom</code> \|\| string \|\| No		\| segB \|\| Custom Reporting Segment \|\| <code>custom</code> \|\| string \|\| No

Admin at 22:07, 14 March 2018

2018-03-14T22:07:05Z

← Older revision		Revision as of 22:07, 14 March 2018
Line 84:		Line 84:
	\| type \|\| Type of asset \|\| <code>'content'</code> \|\| string \|\| Yes		\| type \|\| Type of asset \|\| <code>'content'</code> \|\| string \|\| Yes
	\|-		\|-
	\| assetid \|\| Unique ID assigned to asset \|\| <code>custom</code> \|\| string \|\| Yes		\| assetid \|\| Unique ID assigned to asset \|\| <code>custom</code> <br>(no [[Special Characters]]) \|\| string \|\| Yes
	\|-		\|-
	\| program \|\| Program Name \|\| <code>custom</code> \|\| string \|\| Yes		\| program \|\| Program Name \|\| <code>custom</code> \|\| string \|\| Yes

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital The Nielsen Browser SDK (Software Development Kit) is the Nielsen..."

2017-09-29T20:40:44Z

Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital The Nielsen Browser SDK (Software Development Kit) is the Nielsen..."

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}}
[[Category:Digital]]

The Nielsen Browser SDK (Software Development Kit) is the Nielsen framework for measuring media consumption in browser environments.

{{PluginInfobox
|pluginImage=BrightcoveIcon
|osImage=BrowserIcon
|playerVersion=5.18.0 - 5.22.0
|SDKVersion=5.1.1
|supportedAdFrameworks=
}}.

This SDK has the following features:
* '''Multiple product support''': built-in capabilities to support Digital Content Ratings(DCR), VideoCensus(VC), Digital Program Ratings(DPR) and IAG.

<blockquote>'''Note''': This Plugin should not be used with Brightcove V5 player v5.18 - 5.22.0</blockquote>

== Getting Started ==
=== What You Will Need? ===
* '''Nielsen App ID (apid)''': a Unique ID that Nielsen assigns to the site / player. The 'apid' will be provided by your Technical Account Manager.
* '''BrightCove Plugin''': Plugin URLs are provided in the below [[#URL|section]].
* '''Test Environment Validation''': before you move into production, Nielsen must validate the SDK integration in a test environment.

=== Initial Configuration ===
Before integrating the plugin, configure the metadata, obtain Nielsen APID's, and review the Nielsen plugin URLs for Brightcove.

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen apid is required to enable SDK functionality. Your Technical Account Manager will provide two apids for each player configuration
* Test apid: use this apid during development and testing
* Production apid: use this apid in your production environment after Nielsen has tested and qualified the player.

=== Brightcove Plugin URL's ===
* BC Perform Player (JS)
** http://cdn-gl.imrworldwide.com/novms/bc/3/ggng510.js
** https://cdn-gl.imrworldwide.com/novms/bc/3/ggng510.js

=== Global Parameters ===
To initialize the Nielsen Browser SDK, pass four global parameters when adding the BC Perform plugin.
{| class="wikitable"
|-
! Keys !! Description !! Values
|-
| apid || Unique ID assigned to player/site. There are two IDs provided || <code>'XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'</code>
* Test: begins with 'T' and is used for testing
* Production: begins with 'P' and is used in live environment when testing and certification is completed.
|-
| sfcode || Location of collection environment. During testing, all traffic should be directed to 'dcr-cert'. || testing: <code>'dcr-cert'</code>

production: <code>'dcr'</code>
|-
| nsdkv || Nielsen SDK Version || <code>'511'</code>
|-
| apn || User-defined string value for describing the player / site. || custom
|}

The below parameter is optional but recommended when testing implementation.
{| class="wikitable"
|-
! Keys !! Description !! Values
|-
| nol_sdkDebug || Nielsen SDK console logging that should be used while testing. Make sure to disable before moving the implementation to production. || <code>'INFO'</code> – API calls

<code>'WARNING'</code> – System level logs

<code>'ERROR'</code> – Error logs

<code>'DEBUG'</code> – Full logs
|}

=== Configure Metadata ===
There are two types of metadata
* '''DCR Content Metadata''': identify content
* '''DCR Ad Metadata''': identify ad
Metadata can be passed through key-values using the Nielsen reserved keys.

The metadata received for each asset is used for classification and reporting. There are reserved Nielsen keys for collecting the required metadata.

=== Content Metadata ===
{| class="wikitable"
|-
! Keys !! Description !! Values !! Type !! Required
|-
| type || Type of asset || <code>'content'</code> || string || Yes
|-
| assetid || Unique ID assigned to asset || <code>custom</code> || string || Yes
|-
| program || Program Name || <code>custom</code> || string || Yes
|-
| title || Episode title || <code>custom</code> || string || Yes
|-
| airdate || The original airdate for linear TV || <code>'20161013 20:00:00'</code> || date || No
|-
| length || Length of content in seconds || <code>3600</code> (86400 for lives tream)|| integer || Yes
|-
| segB || Custom Reporting Segment || <code>custom</code> || string || No
|-
| segC || Custom Reporting Segment || <code>custom</code> || string || No
|-
| isfullepisode || Full Episode Flag ||
<code>'y'</code> - Full Episode

<code>'n'</code> - Non Full Episode
|| boolean || Yes
|-
| adloadtype || Distinguishes Dynamic vs Linear Ad Insertion ||
<code>'1'</code> - Linear

<code>'2'</code> - Dynamic
|| integer || Yes
|-
| crossId1 || Standard Episode ID || <code>custom</code> || string || Yes
|-
| crossId2 || Content Originator ID || <code>custom</code> || string || No
|-
| mediaURL || URL location of the content being streamed || <code>custom</code> || string || Yes
|-
| hasAds || Distinguishes when content includes Ads ||
<code>'0'</code> - No Ads

<code>'1'</code> - Includes Ads

<code>'2'</code> - Unknown
|| integer || Yes
|}

=== Ad Metadata ===
{| class="wikitable"
|-
! Keys !! Description !! Values !! Type !! Required
|-
| type || Type of ad ||
<code>'preroll'</code>

<code>'midroll'</code>

<code>'postroll'</code>
|| string || Yes
|-
| assetid || Unique ID assigned to ad || <code>custom</code> || string || Yes
|}
<blockquote>'''Note''':There is a URL character limit of 2000 characters imposed due to browser limitations. Exceeding this value can impair data delivery on particular browsers.</blockquote>

== Setup ==
In order to integrate the Nielsen plugin, follow the steps for setting up these players in the Brightcove user interface as they appear below by each player type.

=== Brightcove Player Setup ===
The new Brightcove Perform player allows two interchangeable ways to add the plugin: on the web site, so the player will come already configured, and programmatically on the client side.

These options, as well as the whole process of adding a plugin is common to the player and described here http://support.brightcove.com/en/perform/docs/configuring-player-plugins

==== For Nielsen SDK plugin, the integrator would need ====
* A list of initialization parameters (Application ID, App Name, sfcode, and nsdkv). Refer to [[#Global Parameters|Global Parameters]] section above.
* A link (URL) to SDK plugin (ggng510.js) for Brightcove
* A list of metadata fields with their names (Nielsen Key Mapping) to pass to the plugin. For more information, refer to [[#Configure Metadata|Configure Metadata]] section.
* Access to the Brightcove VideoCloud Perform Portal https://studio.brightcove.com/products/videocloud/home

==== To add Nielsen SDK plugin using UI do the following ====
Open Brightcove VideoCloud portal, open players list and open (or create) a player the plugin should be added to.
Scroll down to the 'Plugins' section in player configuration

[[File:Plugins-BC.jpg|link=]]

* Click "Edit" and enter the URL to plugin JS file. Click "+" to add the row.

[[File:js-BC.jpg|link=]]

* Then click "Name, Options (JSON)" row and enter "NielsenBC" for the plugin name and required initialization parameters provided by your Nielsen Technical Account Manager, as below:

[[File:Js-BC2.jpg|link=]]

Example Code:
<syntaxhighlight lang="json">{
"nol_sdkDebug": "DEBUG",
"sfcode": "dcr-cert",
"apn": "Test_player_name",
"nsdkv": "511",
"apid": "T4BFBFAC9-XXXX-XXXX-XXXX-22B092CBCC2B",
}</syntaxhighlight>

Adding <code>"nol_sdkDebug": "DEBUG"</code> will allow SDK events in the console.
<blockquote>'''Note''': <code>"nol_sdkDebug": "DEBUG"</code> must be removed when moving a player live to production to disable the debug logging.</blockquote>

==== Pass Content & Ad Metadata to The Brightcove Video Player ====
Pass the required content, and ad metadata to the Brightcove video player so that the Nielsen Plug-In is able to pick it up in order to populate the DCR crediting tags. The Nielsen Plug-In is preconfigured to automatically obtain metadata from Custom Fields. These can be set through the Brightcove User Interface (under ADMIN) or programmatically.

Information on creating Custom Metadatafields can be found on the [https://support.brightcove.com/en/video-cloud/docs/creating-custom-metadata-fields|Brightcove Support site].
<blockquote>'''Note:''' If you are using the Brightcove player with the PERFORM service, you will need to populate the media info. Please contact Brightcove support for details on this process.</blockquote>

[[File:Video-Fields.jpg|link=]]

For more information on how to pass the required metadata to the Brightcove [https://www.brightcove.com/en/online-video-platform VideoCloud] player, please reach out to your Brightcove Account Manager for further assistance.

==== To add Nielsen SDK programmatically ====
* Include plugin source<syntaxhighlight lang="html"><script src="//cdn-gl.imrworldwide.com/novms/bc/3/ggng510.js"></script></syntaxhighlight>
* Bind plugin to the player with inititalization parameters<syntaxhighlight lang="javascript">videojs("myPlayerID").NielsenBC(
{
"apid": "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"apn": "Your_player_name",
"sfcode": "dcr-cert",
"nsdkv": "511"
}
}</syntaxhighlight>
* For CMS data binding, the following rules apply
* The plugin automatically captures the following video data
* * Data from video duration is automatically capture by the plugin<syntaxhighlight lang="javascript">nielsenData.length = videoInfo.duration;</syntaxhighlight>
* * Field "type" is set to <code>"content"</code>, <code>"preroll"</code>, <code>"midroll"</code> or <code>"postroll"</code>.
* If video data contains custom fields, all those fields are copied over to Nielsen data: <code>nielsenData[i] = videoInfo.custom_fields[i]</code> (with 'i' iterated over all custom field names), which may override some of the default values or standard field values
* '''The plugin does not automatically assign a value to assetid'''. To pass programmatically, use the custom fields object. (See code example below)
* Parameter videoInfo.id must be a unique string to allow the plugin detecting the content change.

=== Notes ===
* If some CMS metadata values should be set for all videos played, those values can be passed as "defaults" field on the player level (in the player configuration), like this<syntaxhighlight lang="json">{
"apid": "PXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
"apn": "Your_player_name",
"sfcode": "dcr",
"nsdkv": "511",
"defaults": { "customValue": "true" }
}</syntaxhighlight>
* CMS metadata values can also be set at the asset level<syntaxhighlight lang="json">{
"sources" :
[ {
"src" : "http://solutions.brightcove.com/../videos/Sea_SeaHorse.mp4",
"type" : "video/mp4"
} ],
"custom_fields":
{
"assetid": "6475587654",
"mediaURL": "http://solutions.brightcove.com/bcls/../videos/Sea_Anemone.mp4",
"dataSrc": "cms",
"hasAds": "1"
},
"name": "Sea Anemone",
"thumbnail": "http://solutions.brightcove.com/bcls/assets/images/Sea_Anemone_poster.png",
"id": "5195888503001"
}
}</syntaxhighlight>

=== Ad Support ===
The plugin will also extract information about the number and length of advertisements played with the video.

== Opt-Out Implementation ==
The site must provide a means for the user to opt out of, or opt back into Nielsen Measurement. A user can opt out if preferring to not participate in any Nielsen online measurement research. To implement the Opt-Out option, include the following in the privacy policy page:
* A notice that the player includes proprietary measurement software that allows users to contribute to market research (such as Nielsen TV Ratings)
* A link to the Nielsen Digital Measurement Privacy Policy at http://www.nielsen.com/digitalprivacy
On the Nielsen Digital Measurement Privacy Policy page, users can click choices to read more detailed information about the measurement software and their options. The users can click a link to retrieve an Opt-Out cookie if they do not want to participate in Nielsen online measurement.

Nielsen properties may feature Nielsen proprietary measurement software, which will allow the users to contribute to market research, such as Nielsen TV Ratings.

To learn more about the information that Nielsen software may collect and your choices with regard to it, please see the Nielsen Digital Measurement Privacy Policy at http://www.nielsen.com/digitalprivacy.

=== Opt-In ===
Once users have opted out, they can choose to opt back into Nielsen Measurement at anytime by selecting the Opt-In link on the Nielsen Digital Privacy Policy page. When a user selects the link, their Opt-Out cookie will be deleted and they will be measured.

== Going Live ==
After the integration is certified, there is one update to be made to the existing code to ensure that the player will be measured properly:
*'''App ID''': Change the apid to the production ID starting with the letter 'P':<syntaxhighlight lang="console">'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'</syntaxhighlight>
* '''Collection Environment''': Change the value for <code>sfcode</code> from <code>dcr-cert</code> to <code>dcr</code> to point traffic to the Nielsen production collection environment. Do not use <code>dcr-cert</code> for production traffic
<blockquote>'''Note''': Ensure that the <code>nol_sdkDebug</code> parameter is not used.</blockquote>

Brightcove Plugin Browser (Draft) - Revision history

YaminiKumawat: changed 86400 to 0 for live stream

Admin at 22:07, 14 March 2018

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|DCR & DTVR}} {{CurrentBreadcrumb}} Category:Digital The Nielsen Browser SDK (Software Development Kit) is the Nielsen..."