Admin at 21:20, 14 March 2018

2018-03-14T21:20:39Z

← Older revision		Revision as of 21:20, 14 March 2018
Line 100:		Line 100:

	The data for content contains		The data for content contains
	* Assetid : unique id assigned to asset		* Assetid : unique id assigned to asset (no [[Special Characters]])
	* Program : program name		* Program : program name
	* Title : episode title – only applicable to video content		* Title : episode title – only applicable to video content

Admin at 21:53, 20 October 2017

2017-10-20T21:53:54Z

← Older revision		Revision as of 21:53, 20 October 2017
Line 10:		Line 10:
	\|SDKVersion=5.1.0.4		\|SDKVersion=5.1.0.4
	\|supportedAdFrameworks=Google IMA		\|supportedAdFrameworks=Google IMA
			\|downloadLink=https://engineeringportal.nielsen.com/w/downloads/digital/plugins/native/mediaplayer/Nielsen-App-SDK-Native-Plugin-Android-1.0.0.zip
	}}		}}

Admin at 13:48, 1 September 2017

2017-09-01T13:48:26Z

← Older revision		Revision as of 13:48, 1 September 2017
Line 4:		Line 4:
	'''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with necessary data for streaming measurement based on the MediaPlayer events received.		'''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with necessary data for streaming measurement based on the MediaPlayer events received.

	~~'''Supported Ad Frameworks'''~~		{{PluginInfobox
	* Google IMA		\|pluginImage=AndroidLogoIcon
			\|osImage=AndroidIcon
			\|playerVersion=Android 6+
			\|SDKVersion=5.1.0.4
			\|supportedAdFrameworks=Google IMA
			}}

	== Component Diagram ==		== Component Diagram ==

Admin at 07:47, 25 May 2017

2017-05-25T07:47:34Z

← Older revision		Revision as of 07:47, 25 May 2017
Line 1:		Line 1:
	{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}
	[[Category:Digital]]		[[Category:Digital]]

	'''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with necessary data for streaming measurement based on the MediaPlayer events received.		'''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with necessary data for streaming measurement based on the MediaPlayer events received.

Admin: /* Nielsen App SDK */

2017-05-23T07:59:53Z

Nielsen App SDK

← Older revision		Revision as of 07:59, 23 May 2017
Line 50:		Line 50:

	==== Nielsen App SDK ====		==== Nielsen App SDK ====
	* Download the Nielsen App SDK jar file from [[Downloads]]		* Download the Nielsen App SDK jar file from [[Digital Downloads]]
	Follow the steps below, to build the Nielsen Plugin and sample app in to the player application project		Follow the steps below, to build the Nielsen Plugin and sample app in to the player application project
	* Unzip the Nielsen MediaPlayer Plugin’s zip file		* Unzip the Nielsen MediaPlayer Plugin’s zip file

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}} Category:Digital '''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with n..."

2017-05-22T22:53:39Z

Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}} Category:Digital '''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with n..."

New page

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
'''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with necessary data for streaming measurement based on the MediaPlayer events received.

'''Supported Ad Frameworks'''
* Google IMA

== Component Diagram ==
[[File:Component-native-andr.png|link=]]

The component diagram above shows the interaction of the Plugin with various components.

=== App ===
The App is the Android application implemented by the client. The application
* Creates the Plugin and the Player Fragment VideoView. The Player Fragment VideoView has a reference to the player.
* Instantiates the Plugin. A reference of the application context and a JSON object containing the Nielsen AppSdk config parameters are passed during instantiation.
* Interacts with the Plugin to provide metadata for the content and / or Ad to the Nielsen App SDK for measurement.

=== Plugin ===
The Nielsen App SDK Plugin is instantiated by the application. The Plugin
* Initializes the NielsenAppSDK and calls the appropriate NielsenAppSDK API’s based on the events / states from the player.
* Is also a wrapper for the Nielsen AppSDK.

=== IPlayerObservable ===
This Nielsen interface is implemented by third party players and notifies the Nielsen Plugin about the various player events / states.

=== IPlayerObserver ===
This interface is implemented by the Nielsen Plugin to subscribe to the player notification events. Events from the MediaPlayer are notified to the Plugin using the IPlayer Observerable interface. It uses the PlayerNotification object to provide the event data to the Plugin.

=== Nielsen AppSdk ===
This is the Nielsen AppSDK which handles the content and ad measurement based on the information provided by the Plugin.

=== MediaPlayerVideoFragmentView ===
This Fragment VideoView is instantiated by the Android application from the layout XML. There are 2 fragments, one for rendering the video and the other for displaying the videolist (refer VideoMetaData.java). The App should implement the IPlayerObserverable interface. Eg. VideoPlayerWithAdPlayback in MediaPlayerSampleApp receives the player events/states from MediaPlayer VideoView and passes it on to the NielsenPlugin which implements the IPlayerObserver.

== Plugin Implementation ==
=== Pre-requisites ===
* '''Nielsen SDK Configuration Form''': Complete this form to receive the appid(s). The information on this form is required to set up the Content Management System (CMS) mapping for the app.
* '''Nielsen App ID (appid)''': A unique ID that Nielsen assigns to the site/player.
* '''Nielsen App SDK Plugin for MediePlayer''': The download link for the Plugin Packages are provided with the Nielsen appid(s).
* '''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, make sure to download the following:

==== Nielsen App SDK Plugin for MediaPlayer Package ====
The Nielsen App SDK Plugin for MediaPlayer package includes
* The Nielsen App SDK Plugin for MediaPlayer source code and
* The sample application source code which supports Google IMA ad Plugin.

==== Nielsen App SDK ====
* Download the Nielsen App SDK jar file from [[Downloads]]
Follow the steps below, to build the Nielsen Plugin and sample app in to the player application project
* Unzip the Nielsen MediaPlayer Plugin’s zip file
* Build the Plugin’s aar file as follows.
** Import the module NielsenMediaPlayerPlugin into the project.
** Create a /libs directory in NielsenMediaPlayerPlugin.
** Copy the Nielsen AppSDK jar file in this /libs directory.
** Build the NielsenMediaPlayerPlugin module and this should produce the NielsenMediaPlayerPlugin.aar file.
* Build the NielsenSampleAppForMediaPlayer with the Plugin
** Import the module NielsenSampleAppForMediaPlayer into the project.
** Include the following in the build.gradle to compile with the MediaPlayerPlugin<syntaxhighlight lang="java">compile project(':NielsenMediaPlayerPlugin')</syntaxhighlight>
** Build the NielsenSampleAppForMediaPlayer and this should produce the NielsenSampleAppForMediaPlayer.apk file.

=== Initialization with Global Parameters ===
To initialize the Plugin that initializes the App SDK, pass the global parameters in JSON string format. Some of the global parameters are
* Nielsen App ID (appid)
* appversion
* appname
* sfcode
* dma
* ccode
* CMS Metadata
For more details refer to the Nielsen [[Android SDK API Reference]].

== Setup ==
The steps for setting up the Nielsen App SDK Plugin for MediaPlayer are as follows.

===Nielsen App SDK Plugin Creation===
The Nielsen App SDK Plugin for MediaPlayer integrates with the MediaPlayer by listening for and emitting events. It listens to events from the player and invokes the appropriate NielsenAppSdk API’s. It is also a wrapper for the Nielsen App SDK.

The App creates the Plugin as mentioned below.
<syntaxhighlight lang="java">plugin = new Plugin(context, config);</syntaxhighlight>

where:
* context refers to the application context,
* config contains the parameters to initialize the App SDK in the JSONObject.
Please refer to the [[Android SDK API Reference]] for more details on the App SDK configuration parameters.

===Passing Metadata===
The Plugin provides a public method that is used by the client to provide the metadata.
<syntaxhighlight lang="java">public void loadMetadata(JSONObject metadataObj)</syntaxhighlight>

The data for content contains
* Assetid : unique id assigned to asset
* Program : program name
* Title : episode title – only applicable to video content
* Length – length of content in seconds
* segA – segment A will be episode title for video content
* segB – Segment B
* segC – Segment C
For more information on the Nielsen App SDK metadata refer to the [[Android SDK API Reference]].

=== Calling the methods ===
The application can communicate with the Plugin for functions such as appDisable, OptIn / OptOut, static content, demographic id and OTT update via the API’s provided by the Plugin.

{| class="wikitable"
|-
! Function !! Name
|-
| AppDisable || <syntaxhighlight lang="java>public void appDisableApi(boolean disableApi)</syntaxhighlight>
|-
| OptOut Status || <syntaxhighlight lang="java>public boolean getOptOutStatus()</syntaxhighlight>
|-
| OptIn/OptOut || <syntaxhighlight lang="java>public String userOptOutURLString()</syntaxhighlight>
|-
| Demographic ID || <syntaxhighlight lang="java>public String getDemographicId()</syntaxhighlight>
|-
| Update OTT || <syntaxhighlight lang="java>public void updateOTT(JSONObject ottInfo)</syntaxhighlight>
|-
| Static Content || <syntaxhighlight lang="java>public void loadMetadata(JSONObject metadataObj)</syntaxhighlight>
|}

For more information on these functionalities refer to the [[Android SDK API Reference]].

=== Static content ===
StaticContent is used to provide the metadata required for measuring static content.

Static content usage
<syntaxhighlight lang="java">JSONObject staticMetadata = new JSONObject();
try
{
staticMetadata.put("type","static");
staticMetadata.put("segA","S07E04:VideoListFragment-MainActivity");
staticMetadata.put("assetId","Static1″);
staticMetadata.put("segB","segBStatic");
staticMetadata.put("segC","segCStatic");
staticMetadata.put("crossId1″,"Reference1");
staticMetadata.put("crossId2″,"Reference2");
}
catch (JSONException e)
{
e.printStackTrace();
}
plugin.loadMetadata(staticMetadata); // Sending Static Metadata</syntaxhighlight>

== Known Issues ==

Player fails to resume the video once network connectivity is resumed after network loss scenarios like Wifi ON / OFF, airplane mode ON / OFF etc. This effects the user experience but not the Nielsen measurement.

== Releases ==
{| class="wikitable"
|-
! Name !! Version # !! Date !! Comments
|-
| Nielsen AppSDK Plugin for MediaPlayer with Google IMA ad support || 1.0.0 || 09/23/2016 || Initial version of the Nielsen App SDK Plugin for MediaPlayer with support for Google IMA ads. This Plugin can be used only with Android 6 plus. It has been tested with AppSdk build 5.1.1.7.
|}

MediaPlayer Plugin Android - Revision history

Admin at 21:20, 14 March 2018

Admin at 21:53, 20 October 2017

Admin at 13:48, 1 September 2017

Admin at 07:47, 25 May 2017

Admin: /* Nielsen App SDK */

Admin: Created page with "{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}} Category:Digital '''Nielsen App SDK Plugin for MediaPlayer''' interacts with Nielsen App SDK to provide with n..."