DCR Sweden Video Android SDK - Revision history

MichelFodjo: /* Implementation */

2023-02-10T12:34:47Z

Implementation

← Older revision		Revision as of 12:34, 10 February 2023
Line 33:		Line 33:
	\|-		\|-
	\| '''Android Ad Version'''		\| '''Android Ad Version'''
	\|* Opt-In and Opt-Out functionality managed by Opt out of Ads Personalization setting on the device. ~~<br />~~* The Nielsen SDK will collect the [https://developer.android.com/training/articles/ad-id Google Advertising ID] unless the user Opts out.~~<br>~~* If the Google Play Service is unavailable (ie, Amazon and Huawei devices), the Nielsen SDK will secure the Android ID.~~<br>~~		\|
			* Opt-In and Opt-Out functionality managed by Opt out of Ads Personalization setting on the device.
			* The Nielsen SDK will collect the [https://developer.android.com/training/articles/ad-id Google Advertising ID] unless the user Opts out.
			* If the Google Play Service is unavailable (ie, Amazon and Huawei devices), the Nielsen SDK will secure the Android ID.
	\|-		\|-
	\| '''Android No Ad Framework'''		\| '''Android No Ad Framework'''
	\|* Without the Google Play Services SDK, the Nielsen SDK cannot read the Google Advertising ID, so it will retrieve the Android ID.~~<br />~~* The Android ID is a 64-bit number (expressed as a hexadecimal string) unique to each combination of the app-signing key, user and device.~~<br />~~* The developer is required to present the User Choice Opt-Out page, which is described in the [[#Global_Android_SDK_No_Ad_Framework_Opt-out\|Global Android SDK No Ad Framework Opt-out]].		\|
			* Without the Google Play Services SDK, the Nielsen SDK cannot read the Google Advertising ID, so it will retrieve the Android ID.
			* The Android ID is a 64-bit number (expressed as a hexadecimal string) unique to each combination of the app-signing key, user and device.
			* The developer is required to present the User Choice Opt-Out page, which is described in the [[#Global_Android_SDK_No_Ad_Framework_Opt-out\|Global Android SDK No Ad Framework Opt-out]].
	\|-		\|-
	\| '''Android SDK noID'''		\| '''Android SDK noID'''
	\|* This version of the Nielsen SDK is perfect for Kid apps, or where no ID is required.~~<br>~~* For the requirement, please review the [[#Global_Android_SDK_No_ID_Opt-out\|Global Android SDK No ID Opt-out]].		\|
			* This version of the Nielsen SDK is perfect for Kid apps, or where no ID is required.
			* For the requirement, please review the [[#Global_Android_SDK_No_ID_Opt-out\|Global Android SDK No ID Opt-out]].
	\|}		\|}

MichelFodjo: /* Implementation */

2023-02-10T12:31:48Z

Implementation

← Older revision		Revision as of 12:31, 10 February 2023
Line 33:		Line 33:
	\|-		\|-
	\| '''Android Ad Version'''		\| '''Android Ad Version'''
	\|* Opt-In and Opt-Out functionality managed by Opt out of Ads Personalization setting on the device. <br />* The Nielsen SDK will collect the [https://developer.android.com/training/articles/ad-id Google Advertising ID] unless the user Opts out.<br>* If the Google Play Service is unavailable (ie, Amazon and Huawei devices), the Nielsen SDK will secure the Android ID.<br> * There are three versions available, starting with the Nielsen SDK 8.1.0.0.		\|* Opt-In and Opt-Out functionality managed by Opt out of Ads Personalization setting on the device. <br />* The Nielsen SDK will collect the [https://developer.android.com/training/articles/ad-id Google Advertising ID] unless the user Opts out.<br>* If the Google Play Service is unavailable (ie, Amazon and Huawei devices), the Nielsen SDK will secure the Android ID.<br>
	\|-		\|-
	\| '''Android No Ad Framework'''		\| '''Android No Ad Framework'''

FaraazAli at 09:17, 16 September 2022

2022-09-16T09:17:22Z

Show changes

FaraazAli: /* Required Privacy Links */

2022-08-04T07:53:36Z

Required Privacy Links

← Older revision		Revision as of 07:53, 4 August 2022
Line 631:		Line 631:
	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 https://~~sites~~.nielsen.com/~~priv~~/~~browser~~/se/sv~~/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://www.nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=sv for more information"'''</blockquote>

	=== First Party ID (FPID)===		=== First Party ID (FPID)===

FaraazAli: /* Setting up your Android Development Environment */

2022-04-04T12:12:31Z

Setting up your Android Development Environment

← Older revision		Revision as of 12:12, 4 April 2022
Line 59:		Line 59:
	Libraries:		Libraries:
	* com.google.android.gms:play-services		* com.google.android.gms:play-services
	~~Requiered~~ Google Play Service Classes and Packages :		Required Google Play Service Classes and Packages :
	* com.google.android.gms.ads.identifier.AdvertisingIdClient;		* com.google.android.gms.ads.identifier.AdvertisingIdClient;
	* com.google.android.gms.ads.identifier.AdvertisingIdClient.Info;		* com.google.android.gms.ads.identifier.AdvertisingIdClient.Info;

FaraazAli: /* Create SDK Instance */

2021-12-13T11:01:51Z

Create SDK Instance

← Older revision		Revision as of 11:01, 13 December 2021
Line 98:		Line 98:
	\| hem_unknown \|\| Hashed email using SHA512. This email is used by MMS reach model.		\| hem_unknown \|\| Hashed email using SHA512. This email is used by MMS reach model.
	\|\| Client-defined \|\| Required if login feature \|\| "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."		\|\| Client-defined \|\| Required if login feature \|\| "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."
			\|-
			\| enableFpid \|\| true/false value is required to set collection of first-party ID.
			\|\| Nielsen-specified \|\| NO \|\| <syntaxhighlight lang="javascript">
			{enableFpid: "true"} //alternative: false
			</syntaxhighlight>
	\|}		\|}
	<br />		<br />
Line 109:		Line 114:
	.put("appversion", "1.0")		.put("appversion", "1.0")
	.put("appname", "Sample App Name")		.put("appname", "Sample App Name")
	.put("nol_devDebug", "DEBUG"); // only for debug builds		.put("nol_devDebug", "DEBUG") // only for debug builds
	.put("hem_unknown", "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...");		.put("hem_unknown", "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...")
			.put("enableFpid", "true"); // alternative is false;

	// Pass appSdkConfig to the AppSdk constructor		// Pass appSdkConfig to the AppSdk constructor
Line 161:		Line 167:
	.put("appversion", "1.0")		.put("appversion", "1.0")
	.put("appname", "Sample App Name")		.put("appname", "Sample App Name")
	.put("nol_devDebug", "DEBUG"); // only for debug builds		.put("nol_devDebug", "DEBUG") // only for debug builds
	.put("hem_unknown", "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...");		.put("hem_unknown", "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...")
			.put("enableFpid", "true"); // alternative is false;

	// Pass appSdkConfig to the AppSdk constructor		// Pass appSdkConfig to the AppSdk constructor

FaraazAli: /* Required Privacy Links */

2021-12-13T10:52:38Z

Required Privacy Links

← Older revision		Revision as of 10:52, 13 December 2021
Line 626:		Line 626:
	'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research, like Nielsen’s TV Ratings. Please see https://sites.nielsen.com/priv/browser/se/sv/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://sites.nielsen.com/priv/browser/se/sv/optout.html for more information"'''</blockquote>

	==== First Party ID (FPID)====		=== First Party ID (FPID)===
	- The broadcaster must enableFPID in the initialization settings which is set to <code>true</code> or <code>false</code> depending on user consent. This is to be set by the broadcaster when initializing our SDK.<br>		- The broadcaster must enableFPID in the initialization settings which is set to <code>true</code> or <code>false</code> depending on user consent. This is to be set by the broadcaster when initializing our SDK.<br>

FaraazAli: /* Required Privacy Links */

2021-12-13T10:52:10Z

Required Privacy Links

← Older revision		Revision as of 10:52, 13 December 2021
Line 625:		Line 625:
	<blockquote>		<blockquote>
	'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research, like Nielsen’s TV Ratings. Please see https://sites.nielsen.com/priv/browser/se/sv/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://sites.nielsen.com/priv/browser/se/sv/optout.html for more information"'''</blockquote>

			==== First Party ID (FPID)====
			- The broadcaster must enableFPID in the initialization settings which is set to <code>true</code> or <code>false</code> depending on user consent. This is to be set by the broadcaster when initializing our SDK.<br>

			- The <code>enableFpid</code> flag is needed to enable/disable FPID usage for the AppID. The default value for this flag is true. If this flag is changed from true to false then the AppSDK should wipe out the stored FPID and use a blank value for FPID parameter in all the pings.<br>

			- Generated FPID value is stored in the persistent memory until the application is uninstalled from a device or until FPID is wiped out or until it is expired.<br>

			- The default value for this parameter is 180 days. Once this timeout is reached the FPID should be regenerated.<br>

	== Optional Step for DCR Chromecast Android SDK ==		== Optional Step for DCR Chromecast Android SDK ==

FaraazAli: /* Use Case 1: Content has no Ads */

2021-11-10T09:43:18Z

Use Case 1: Content has no Ads

← Older revision		Revision as of 09:43, 10 November 2021
Line 312:		Line 312:
	\| Interruption \|\| <code>mAppSdk.stop();</code> \|\| // call stop when content playback is interrupted		\| Interruption \|\| <code>mAppSdk.stop();</code> \|\| // call stop when content playback is interrupted
	\|-		\|-
	~~\| rowspan="2"~~ \| Resume Content \|~~\| <code>mAppSdk.loadMetadata(contentMetaDataObject);</code> \|\| // Call loadMetadata and pass content metadata object when content resumes~~		\| Resume Content \|\| <code>mAppSdk.setPlayheadPosition(playheadPosition);</code> \|\| // continue pasing playhead position every second starting from position where content is resumed
	\|-
	\|<code>mAppSdk.setPlayheadPosition(playheadPosition);</code> \|\| // continue pasing playhead position every second starting from position where content is resumed
	\|-		\|-
	\| End of Stream \|\| <code>mAppSdk.end();</code> \|\| // Content playback is completed.		\| End of Stream \|\| <code>mAppSdk.end();</code> \|\| // Content playback is completed.

FaraazAli: /* Life cycle of SDK instance */

2021-11-10T09:33:20Z

Life cycle of SDK instance

← Older revision		Revision as of 09:33, 10 November 2021
Line 187:		Line 187:
	==== Life cycle of SDK instance ====		==== Life cycle of SDK instance ====
	Life cycle of SDK instance includes four general states:		Life cycle of SDK instance includes four general states:
	# ""Initial state"" – The SDK is not initialized and hence, not ready to process playing information. Once the SDK is moved out of this state, it needs instantiation of the new SDK instance in order to get the instance in the ""Initial state"".		# '''Initial state''' – The SDK is not initialized and hence, not ready to process playing information. Once the SDK is moved out of this state, it needs instantiation of the new SDK instance in order to get the instance in the ""Initial state"".
	# ""Idle state"" – The SDK is initialized and is ready to process playing information. Once Initialized, the SDK instance is not processing any data, but is listening for the play event to occur.		# '''Idle state'''– The SDK is initialized and is ready to process playing information. Once Initialized, the SDK instance is not processing any data, but is listening for the play event to occur.
	# ""Processing state"" – The SDK instance is processing playing information. API calls "play" and "loadMetadata" move the SDK instance into this state. In this state, the SDK instance will be able to process the API calls (see below)		# '''Processing state''' – The SDK instance is processing playing information. API calls "play" and "loadMetadata" move the SDK instance into this state. In this state, the SDK instance will be able to process the API calls (see below)
	# ""Disabled state"" – The SDK instance is disabled and is not processing playing information. SDK instance moves into this state in one of the following scenarios.		# '''Disabled state''' – The SDK instance is disabled and is not processing playing information. SDK instance moves into this state in one of the following scenarios.
	## Initialization fails		## Initialization fails
	## <code>appDisableApi</code> is called		## <code>appDisableApi</code> is called