DCR Norway Audio Android App SDK - Revision history

FaraazAli: /* Required Privacy Links */

2022-08-04T09:09:55Z

Required Privacy Links

← Older revision		Revision as of 09:09, 4 August 2022
Line 593:		Line 593:
	In addition, the following text must be included in your app store description.		In addition, the following text must be included in your app store description.
	<blockquote>		<blockquote>
	'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research, like Nielsen’s TV Ratings. Please see ~~http~~://~~priv-policy.imrworldwide~~.com/~~priv~~/~~mobile~~/us/en~~/optout.html~~ for more information"'''</blockquote>		'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research, like Nielsen’s TV Ratings. Please see https://nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=en-no for more information"'''</blockquote>
	==== Webview Example ====		==== Webview Example ====
	The below code is an example of displaying the Nielsen Privacy page to the user.		The below code is an example of displaying the Nielsen Privacy page to the user.

FaraazAli: /* Google Play Services */

2022-04-04T12:16:22Z

Google Play Services

← Older revision		Revision as of 12:16, 4 April 2022
Line 52:		Line 52:
	Steps: Android Studio -> File -> Project Structure ->(In module selection) select App -> Dependencies (tab) -> Click "+" button and select <code>"com.google.android.gms:play-services"</code>.		Steps: Android Studio -> File -> Project Structure ->(In module selection) select App -> Dependencies (tab) -> Click "+" button and select <code>"com.google.android.gms:play-services"</code>.
	Ensure it is added in build.gradle (App level) file		Ensure it is added in build.gradle (App level) file

			==== Google AD ID Permissions ====
			The following is required if target API level is set to 31 (Android 12) with the Ad Version of the Nielsen SDK.

			<syntaxhighlight lang="java">
			<uses-permission android:name="com.google.android.gms.permission.AD_ID"/>
			</syntaxhighlight>
			</br>

	==== Manifest File ====		==== Manifest File ====

FaraazAli: /* Content metadata */

2021-09-09T10:08:06Z

Content metadata

← Older revision		Revision as of 10:08, 9 September 2021
Line 190:		Line 190:
	\| length \|\| length of content in seconds \|\| <code>seconds</code> ("0" for 24/7 Livestream if only one assetid is used for the whole stream. If reporting on program level, length of the program. For Event-Livestreams planned length. For on-demand stream length) \|\| ✓		\| length \|\| length of content in seconds \|\| <code>seconds</code> ("0" for 24/7 Livestream if only one assetid is used for the whole stream. If reporting on program level, length of the program. For Event-Livestreams planned length. For on-demand stream length) \|\| ✓
	\|-		\|-
	\| airdate \|\| the airdate in the linear over-the-air broadcast \|\| Supported formats are:		\| airdate \|\| the airdate in the linear over-the-air broadcast (publication date). <BR>This is required for both LIVE & VOD\|\| Supported formats are:


Line 205:		Line 205:
	MM-DD-YYYY		MM-DD-YYYY

	MM/DD/YYYY		MM/DD/YYYY
	\|\| ✓		\|\| ✓
	\|-		\|-
	\| scheduledEndDate \|\| the airdate when this particular asset ended in the linear over-the-air broadcast \|\| should be same format as airdate \|\| ✓		\| scheduledEndDate \|\| the airdate when this particular asset ended in the linear over-the-air broadcast. <BR>This is required for both LIVE & VOD. In the case of VOD, this will be the airdate + length. \|\| This should be the same format as airdate \|\| ✓
	\|-		\|-
	\| isfullepisode \|\| full episode flag \|\| <code>"y"</code>- full episode, <code>"n"</code>- non full episode \|\| ✓		\| isfullepisode \|\| full episode flag \|\| <code>"y"</code>- full episode, <code>"n"</code>- non full episode \|\| ✓

FaraazAli at 07:52, 26 May 2021

2021-05-26T07:52:21Z

← Older revision		Revision as of 07:52, 26 May 2021
Line 3:		Line 3:

	== Overview ==		== Overview ==
	The Nielsen software development kit (SDK) is one of multiple frameworks that Nielsen provides to enable measuring linear (live) and on-demand audio and video viewing using desktop computers, mobile devices, OTT devices, etc.		The Nielsen software development kit (SDK) is one of the multiple frameworks that Nielsen provides to enable measuring linear (live) and on-demand audio and video viewing using desktop computers, mobile devices, OTT devices, etc.
	The App SDK is the framework for mobile application developers to integrate Nielsen Measurement into their media player applications. It supports a variety of Nielsen Measurement Products like Digital in TV Ratings, Digital Content Ratings ([[DCR & DTVR]]), and [[Digital Ad Ratings]] (DAR). Nielsen SDKs are also equipped to measure static content and can track key life cycle events of an application like:		The App SDK is the framework for mobile application developers to integrate Nielsen Measurement into their media player applications. It supports a variety of Nielsen Measurement Products like Digital in TV Ratings, Digital Content Ratings ([[DCR & DTVR]]), and [[Digital Ad Ratings]] (DAR). Nielsen SDKs are also equipped to measure static content and can track key life cycle events of an application like:
	*Application launch events and how long app was running		*Application launch events and how long app was running
	*Time of viewing a ~~sub section~~ / page in the application.		*Time of viewing a subsection/page in the application.

	== Prerequisites ==		== Prerequisites ==
Line 37:		Line 37:
	*The Nielsen App SDK class is defined as the only public class belonging to the com.nielsen.app.sdk package.		*The Nielsen App SDK class is defined as the only public class belonging to the com.nielsen.app.sdk package.

	'''Nielsen App SDK is compatible with Android OS versions 2.3+. Clients can control / configure the protocol to be used – HTTPS or HTTP to suit their needs.'''		'''Nielsen App SDK is compatible with Android OS versions 2.3+. Clients can control/configure the protocol to be used – HTTPS or HTTP to suit their needs.'''

	The requirement for the Java ''AppSdk.jar'' library and the ''libAppSdk.so'' native library will depend on the type of host application that will make use of them.		The requirement for the Java ''AppSdk.jar'' library and the ''libAppSdk.so'' native library will depend on the type of host application that will make use of them.
Line 44:		Line 44:
	** If the player application uses a 3rd party media player implementing its own HLS, then the minimum Android version will be limited to version 2.3, since the SDK depends on Google Play support to work properly.		** If the player application uses a 3rd party media player implementing its own HLS, then the minimum Android version will be limited to version 2.3, since the SDK depends on Google Play support to work properly.

	Once SDK is downloaded ensure to unzip the Nielsen SDK and copy the AppSdk.jar in your app (Android Studio) libs folder, then right click the AppSdk.jar and select '''Add As Library'''.		Once SDK is downloaded ensure to unzip the Nielsen SDK and copy the AppSdk.jar in your app (Android Studio) libs folder, then right-click the AppSdk.jar and select '''Add As Library'''.
	Ensure the AppSdk.jar file is added in 'build.grade (App Level) file.		Ensure the AppSdk.jar file is added in 'build.grade (App Level) file.
	* App SDK 1.2 provides support for x86, mips, and armeabi-7a architecture.		* App SDK 1.2 provides support for x86, mips, and armeabi-7a architecture.

FaraazAli: /* Prerequisites */

2021-05-26T07:43:25Z

Prerequisites

← Older revision		Revision as of 07:43, 26 May 2021
Line 17:		Line 17:
	\|-		\|-
	\|\| '''App ID (appid)''' \|\| Unique ID assigned to the player/site and configured by product. \|\| Provided by Nielsen		\|\| '''App ID (appid)''' \|\| Unique ID assigned to the player/site and configured by product. \|\| Provided by Nielsen
	\|-
	~~\|\| '''sfcode''' \|\| Unique identifier for the environment that the SDK should point to. \|\| Provided by Nielsen~~
	\|-		\|-
	\|\| '''Nielsen SDK''' \|\| Includes SDK frameworks and '''sample implementation'''; ''See [[Android SDK Release Notes]]'' \|\| [[Special:Downloads\|Download]]		\|\| '''Nielsen SDK''' \|\| Includes SDK frameworks and '''sample implementation'''; ''See [[Android SDK Release Notes]]'' \|\| [[Special:Downloads\|Download]]
Line 24:		Line 22:

	If you do not have any of these prerequisites or if you have any questions, please contact our SDK sales support team.		If you do not have any of these prerequisites or if you have any questions, please contact our SDK sales support team.
	Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and ~~appid~~.		Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and appID.

	== Implementation ==		== Implementation ==

FaraazAli: /* SDK Initialization */

2021-05-26T07:42:52Z

SDK Initialization

← Older revision		Revision as of 07:42, 26 May 2021
Line 99:		Line 99:
	\|-		\|-
	\| appversion \|\| Release version of the client app. Not needed anymore.\|\| custom \|\| \|\| 0.1.1		\| appversion \|\| Release version of the client app. Not needed anymore.\|\| custom \|\| \|\| 0.1.1
	\|-
	~~\| sfcode \|\| Nielsen collection facility to which the SDK should connect.~~
	~~'''Norway RAM integrations'''~~
	* "nor"
	~~\|\| Nielsen-specified \|\| ✓ \|\| "nor"~~
	\|-		\|-
	\| nol_devDebug \|\| Enables Nielsen console logging. Only required for testing		\| nol_devDebug \|\| Enables Nielsen console logging. Only required for testing

ColinBrown: /* Privacy and Opt-Out */

2021-01-19T18:52:20Z

Privacy and Opt-Out

Show changes

ColinBrown: /* Interruptions during playback */

2021-01-19T18:51:39Z

Interruptions during playback

@@ Line 452: / Line 452: @@
 |Android = <syntaxhighlight lang="java">public void end();</syntaxhighlight>
 }}
 == Interruptions during playback ==

ColinBrown: /* Handling JSON Metadata */

2021-01-19T18:50:40Z

Handling JSON Metadata

← Older revision		Revision as of 18:50, 19 January 2021
Line 149:		Line 149:
	** All the Variable Names like appid, appname, sfcode, dataSrc, title, type, etc. are case-sensitive. Use the correct variable name as specified in the documentation.		** All the Variable Names like appid, appname, sfcode, dataSrc, title, type, etc. are case-sensitive. Use the correct variable name as specified in the documentation.
	* JSON string can be prepared using either raw NSString or serialized NSDictionary.		* JSON string can be prepared using either raw NSString or serialized NSDictionary.
	~~{{ExampleCode\|~~		<syntaxhighlight lang="java">
	~~\|Android =~~ <syntaxhighlight lang="java">
	JSONObject channelInfo = new JSONObject()		JSONObject channelInfo = new JSONObject()
	.put("channelname", "My Channel Name 1")		.put("channelname", "My Channel Name 1")
Line 165:		Line 164:
	.put("adloadtype", "2")		.put("adloadtype", "2")
	.put("airdate", "20161013 20:00:00")		.put("airdate", "20161013 20:00:00")
	</syntaxhighlight>		</syntaxhighlight>
	}}

	=== Configure metadata ===		=== Configure metadata ===

ColinBrown: /* Sample SDK Initialization Code */

2021-01-19T18:50:13Z

Sample SDK Initialization Code

← Older revision		Revision as of 18:50, 19 January 2021
Line 115:		Line 115:
	'''Initialization of App SDK object through a JSON object'''		'''Initialization of App SDK object through a JSON object'''
	<syntaxhighlight lang="java">		<syntaxhighlight lang="java">

	try		try
	{		{