thePlatform Plugin Browser
From Engineering Client Portal
Supported Ad Frameworks
- Google IMA
The Nielsen Browser SDK (Software Development Kit) is the Nielsen framework for measuring media consumption in browser environments.
This SDK has the following features:
- Multiple product support: built-in capabilities to support Digital Content Ratings (DCR), VideoCensus (VC), IAG and Digital in TV Ratings (DTVR).
Plugin Implementation
Pre-requisites
- Nielsen App ID (apid): A Unique ID that Nielsen assigns to the site / player. The 'apid' will be provided by your Nielsen Technical Account Manager.
- thePlatform Plugin: Plugin URLs are provided in below section
- Test Environment Validation: Before moving the app into production, Nielsen must validate the Plugin's integration in a test environment.
Initial Configuration
Before integrating the plugin, perform the following
- Configure metadata
- Obtain Nielsen APID's
- Review the Nielsen plugin URLs for thePlatform video players
Configure Metadata
You must configure your Metadata to send to the SDK. The required values are highlighted in the table below, and will need to be supplied through the "Nielsen Keys".
Note: For more information on setting up your Nielsen Keys & Metadata, please reach out to your Nielsen Technical Account Manager.
Content Metadata
| Keys | Description | Values | Type | Required |
|---|---|---|---|---|
| type | Type of asset | 'content' |
string | Yes |
| assetid | Unique ID assigned to asset | custom |
string | Yes |
| program | Program Name | custom |
string | Yes |
| title | Episode title | custom |
string | Yes |
| airdate | The original airdate for linear TV | '20161013 20:00:00' |
date | No |
| length | Length of content in seconds | 3600 (86400 for lives tream) |
integer | Yes |
| segB | Custom Reporting Segment | custom |
string | No |
| segC | Custom Reporting Segment | custom |
string | No |
| isfullepisode | Full Episode Flag |
|
boolean | Yes |
| adloadtype | Distinguishes Dynamic vs Linear Ad Insertion |
|
integer | Yes |
| crossId1 | Standard Episode ID | custom |
string | Yes |
| crossId2 | Content Originator ID | custom |
string | No |
| mediaURL | URL location of the content being streamed | custom |
string | Yes |
| hasAds | Distinguishes when content includes Ads |
|
integer | Yes |
Ad Metadata
| Keys | Description | Values | Type | Required |
|---|---|---|---|---|
| type | Type of ad |
|
string | Yes |
| assetid | Unique ID assigned to ad | custom |
string | Yes |
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.
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.
The Platform Plugin URLs
The URL to be used for thePlatform Plugin is as below
Javascript: http://cdn-gl.imrworldwide.com/novms/tp/3/ggtp510.js
Note: Supports flash version of thePlatform Plugin.
Global Parameters
To initialize the Nielsen Browser SDK, you must pass three global parameters, which will be created when configuring the plugin within thePlatform user interface
- apid: unique Nielsen-assigned identifier for the application. Nielsen provides you with the following two apid values
- Test apid: used during development, test, and certification processes
- Production apid: used only after Nielsen has certified the implementation.
- apn: a user-defined string value for describing your player (for example, "Client Name PrimeTime", or "Channel Name Player")
- sfcode: collections location setting. The SDK uses the sfcode value to manage traffic routing. During the Nielsen Beta Period, set sfcode to 'dcr-cert' for testing & 'cert' for production.
- Development: set sfcode to 'dcr-cert'
- Production: set sfcode to 'dcr'
- nsdkv: Nielsen SDK version required for US implementations.
- US Implementations: set nsdkv to '511'
- nol_sdkDebug: Nielsen SDK console logging that should be used while testing. Make sure to disable before moving the implementation to production.
- Set 'DEBUG' for all levels of logging enabled. 'INFO', 'WARN', & 'ERROR' can also be used for specific levels of debugging.
- Leave blank to disable.
Setup
In order to integrate the Nielsen plugin, you must create the plugin from thePlatform user interface, then integrate with your thePlatform video player.
The Platform Player Plugin Creation
- In order to create a plugin, go to the URL http://data.player.theplatform.com/player/client and login with valid credentials.
- Select the object as a 'Plugin' from the dropdown and check the option POST and type of FORM as 'json'.
- Create the body code similarly to the example body code provided below. You may refer the link for more help http://help.theplatform.com/display/plds/Updating+PlugIn+objects
Example in JSON form
- title : Title for plugin
- plplugin$jsUrl : URL for .js file which loads the plugin in
- plplugin$iconUrl : URL for showing icon of plugin
- plplugin$parameters: Parameters need to add with the Plugin
Integration file references
The URL for integration file references is as below
JavaScript: http://cdn-gl.imrworldwide.com/novms/tp/3/ggtp510.js
Note: The below body code uses the JavaScript Plugin reference
{
"$xmlns":
{
"plplugin": "http://xml.theplatform.com/player/data/PlugIn"
},
"title": "NielsenDCRJS510Plugin",
"plplugin$jsUrl": "http://cdn-gl.imrworldwide.com/novms/tp/3/ggtp510.js",
"plplugin$type": "plugin",
"plplugin$iconUrl": "http://engtestsite.com/nikita/nielsen.png",
"plplugin$componentType": "tpPlayer",
"plplugin$parameters": [
{
"plplugin$name": "apid",
"plplugin$type": "string",
"plplugin$label": "apid",
"plplugin$visibility": "basic",
"plplugin$description": "apid",
"plplugin$defaultValue": "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
},
{
"plplugin$name": "sfcode",
"plplugin$type": "string",
"plplugin$label": "sfcode",
"plplugin$visibility": "basic",
"plplugin$description": "sfcode",
"plplugin$defaultValue": "dcr-cert"
},
{
"plplugin$name": "nsdkv",
"plplugin$type": "string",
"plplugin$label": "nsdkv",
"plplugin$visibility": "basic",
"plplugin$description": "Nielsen SDK Version",
"plplugin$defaultValue": ""
},
{
"plplugin$name": "nol_sdkDebug",
"plplugin$type": "string",
"plplugin$label": "nol_sdkDebug",
"plplugin$visibility": "basic",
"plplugin$description": "nol_sdkDebug",
"plplugin$defaultValue": "DEBUG"
},
{
"plplugin$name": "apn",
"plplugin$type": "string",
"plplugin$label": "apn",
"plplugin$visibility": "basic",
"plplugin$description": "apn",
"plplugin$defaultValue": "defaultClientPlayerName"
}
]
}
Plugin Integration with Player
- Select the player and click on the plug-ins tab on the right hand side of the MPX UI
- Select the required plug-in from the drop-down
- For example, the created plug-in 'NielsenDCRJSPlugin' should now be available under the plugin drop-down.
The variables associated with the plug-in are shown as below, and the user needs to enter the correct values. Refer to your Nielsen Technical Account Manager if you have questions.
SDK / GlobalParameter Plug-in Variables
- apid: This value is given to you by your Nielsen Technical Account Manager. Example value: "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
- sfcode: During testing and QA this value should be "dcr-cert". In production this value should be "dcr".
- nsdkv: Required to specify US Code Base by using '511'
- apn: This is the name of the Player and is editable within the plug-in creation / update
- nol_sdkDebug: Used in test environment for console logging: 'DEBUG'.
Note: Make sure to disable before moving to production by leaving blank.