DCR Sweden Video iOS SDK - Revision history

MichelFodjo at 12:12, 28 September 2023

2023-09-28T12:12:48Z

← Older revision		Revision as of 12:12, 28 September 2023
Line 47:		Line 47:

	== Setting up your iOS Development Environment ==		== Setting up your iOS Development Environment ==

			=== Special Notes regarding iOS17 or TVOS17 ===
			Beginning with iOS/TVOS 17, Apple is adding several requirements for App developers around tracking, use of Identifier For Advertisers (IDFA), and certain system APIs.

			This requirement entails users manually opting in to declare all domains employed for tracking purposes, which includes the collection of IDFAs (Identifier for Advertisers).
			Currently, even if users choose not to opt in for tracking, it's essential to note that our Nielsen Digital SDKs continue to carry out measurements and transmit data without relying on IDFA. However, this new privacy measure introduced by Apple necessitates that we bring this development to your attention, as it could potentially impact your Nielsen measurement and tracking for iOS app usage.

			In order to minimize the impact, we are asking that clients do the following:

			* '''Do not declare the Nielsen imrworldwide.com domain in the privacy manifest.'''
			* Update to the latest Nielsen SDK release >= 9.2.0.0 when compiling your app for iOS 17.

			For any additional information please refer to the Nielsen global page: [[DCR and DTVR with iOS17 or TVOS17]].

	=== Configuring Xcode Development Environment ===		=== Configuring Xcode Development Environment ===

FaraazAli: /* Use Case 2: Content has Ads */

2022-09-16T09:07:30Z

Use Case 2: Content has Ads

← Older revision		Revision as of 09:07, 16 September 2022
Line 405:		Line 405:
	<blockquote>Note: In case the individual ad details are not available, send ad pod (presence) details through the [[loadMetadata]] and playhead position through [[playheadPosition]].</blockquote>		<blockquote>Note: In case the individual ad details are not available, send ad pod (presence) details through the [[loadMetadata]] and playhead position through [[playheadPosition]].</blockquote>

	Call [[playheadPosition\|playheadPosition()]] every one second until a pause / another [[loadMetadata()]] is called. Playhead should be passed for the entire duration of ad pod, if the ad pod details are passed as part of [[loadMetadata()]].		Call [[playheadPosition\|playheadPosition()]] every one second until a pause / another [[loadMetadata()]] is called. Playhead should be passed for the entire duration of a ad pod, if the ad pod details are passed as part of [[loadMetadata()]].

	The sample API sequence can be used as a reference to identify the specific events that need to be called during content and ad playback.		The sample API sequence can be used as a reference to identify the specific events that need to be called during content and ad playback.

FaraazAli at 09:05, 16 September 2022

2022-09-16T09:05:37Z

Show changes

FaraazAli: /* Webview Element */

2022-08-04T07:51:37Z

Webview Element

← Older revision		Revision as of 07:51, 4 August 2022
Line 496:		Line 496:

	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>"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>		<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=sv for more information"</blockquote>

	==== Sample Code for Global Build ====		==== Sample Code for Global Build ====

FaraazAli: /* Create SDK Instance */

2021-12-13T11:05:58Z

Create SDK Instance

← Older revision		Revision as of 11:05, 13 December 2021
Line 114:		Line 114:
	\| 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 136:		Line 141:
	@"appname": "app name here",		@"appname": "app name here",
	@"nol_devDebug": @"DEBUG",		@"nol_devDebug": @"DEBUG",
	@"hem_unknown": @"924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."		@"hem_unknown": @"924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...",
			@"enableFpid": @"true"
	};		};
	return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];		return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
Line 169:		Line 175:
	"appname": "app name here",		"appname": "app name here",
	"nol_devDebug": "DEBUG",		"nol_devDebug": "DEBUG",
	"hem_unknown": "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."		"hem_unknown": "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8...",
			"enableFpid": "true"
	]		]
	return NielsenAppApi(appInfo:appInformation, delegate:delegate)		return NielsenAppApi(appInfo:appInformation, delegate:delegate)
Line 202:		Line 209:

	==== Life cycle of SDK instance ====		==== Life cycle of SDK instance ====
	~~Life~~ cycle of SDK instance includes four general states:		The 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.

FaraazAli: /* Retrieve current Opt-Out preference */

2021-12-13T10:55:01Z

Retrieve current Opt-Out preference

← Older revision		Revision as of 10:55, 13 December 2021
Line 679:		Line 679:
	<syntaxhighlight lang="objective-c">		<syntaxhighlight lang="objective-c">
	@property (readonly) BOOL optOutStatus		@property (readonly) BOOL optOutStatus
	</syntaxhighlight>		</syntaxhighlight> <br>
			<br>


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

FaraazAli: /* Retrieve current Opt-Out preference */

2021-12-13T10:54:17Z

Retrieve current Opt-Out preference

← Older revision		Revision as of 10:54, 13 December 2021
Line 680:		Line 680:
	@property (readonly) BOOL optOutStatus		@property (readonly) BOOL optOutStatus
	</syntaxhighlight>		</syntaxhighlight>

			=== 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 AirPlay ==		== Optional Step for AirPlay ==

FaraazAli: /* Create SDK Instance */

2021-11-09T15:24:51Z

Create SDK Instance

← Older revision		Revision as of 15:24, 9 November 2021
Line 112:		Line 112:
	\|\| Nielsen-specified \|\| NO \|\| "DEBUG"		\|\| Nielsen-specified \|\| NO \|\| "DEBUG"
	\|-		\|-
	\| hem_unknown \|\| Hashed email using SHA512. ~~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..."
	\|}		\|}

ShangningWang: /* Create SDK Instance */

2021-10-19T15:07:58Z

Create SDK Instance

← Older revision		Revision as of 15:07, 19 October 2021
Line 113:		Line 113:
	\|-		\|-
	\| hem_unknown \|\| Hashed email using SHA512. Used by MMS reach model.		\| hem_unknown \|\| Hashed email using SHA512. Used by MMS reach model.
	\|\| Client-defined \|\| Required if login feature \|\| "~~61f1121944dfb76f09540c59a99b4000~~"		\|\| Client-defined \|\| Required if login feature \|\| "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."
	\|}		\|}
	<br />		<br />
Line 136:		Line 136:
	@"appname": "app name here",		@"appname": "app name here",
	@"nol_devDebug": @"DEBUG",		@"nol_devDebug": @"DEBUG",
	@"hem_unknown": @"~~61f1121944dfb76f09540c59a99b4000~~"		@"hem_unknown": @"924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."
	};		};
	return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];		return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
Line 169:		Line 169:
	"appname": "app name here",		"appname": "app name here",
	"nol_devDebug": "DEBUG",		"nol_devDebug": "DEBUG",
	"hem_unknown": "~~61f1121944dfb76f09540c59a99b4000~~"		"hem_unknown": "924899b875ea6767ab790bd2f4852345fcfec5d203c49be8e8..."
	]		]
	return NielsenAppApi(appInfo:appInformation, delegate:delegate)		return NielsenAppApi(appInfo:appInformation, delegate:delegate)

ShangningWang: /* Create SDK Instance */

2021-10-19T15:02:40Z

Create SDK Instance

← Older revision		Revision as of 15:02, 19 October 2021
Line 112:		Line 112:
	\|\| Nielsen-specified \|\| NO \|\| "DEBUG"		\|\| Nielsen-specified \|\| NO \|\| "DEBUG"
	\|-		\|-
	\| ~~hem_md5~~ \|\| Hashed email using ~~md5~~. Used by MMS reach model.		\| hem_unknown \|\| Hashed email using SHA512. Used by MMS reach model.
	\|\| Client-defined \|\| Required if login feature \|\| "61f1121944dfb76f09540c59a99b4000"		\|\| Client-defined \|\| Required if login feature \|\| "61f1121944dfb76f09540c59a99b4000"
	\|}		\|}
Line 136:		Line 136:
	@"appname": "app name here",		@"appname": "app name here",
	@"nol_devDebug": @"DEBUG",		@"nol_devDebug": @"DEBUG",
	@"~~hem_md5~~": @"61f1121944dfb76f09540c59a99b4000"		@"hem_unknown": @"61f1121944dfb76f09540c59a99b4000"
	};		};
	return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];		return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
Line 169:		Line 169:
	"appname": "app name here",		"appname": "app name here",
	"nol_devDebug": "DEBUG",		"nol_devDebug": "DEBUG",
	"~~hem_md5~~": "61f1121944dfb76f09540c59a99b4000"		"hem_unknown": "61f1121944dfb76f09540c59a99b4000"
	]		]
	return NielsenAppApi(appInfo:appInformation, delegate:delegate)		return NielsenAppApi(appInfo:appInformation, delegate:delegate)