DCR Denmark Video iOS SDK - Revision history

MichelFodjo: /* Special Notes regarding iOS17 or TVOS17 */

2023-09-28T12:06:03Z

Special Notes regarding iOS17 or TVOS17

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

	* '''Do not declare the Nielsen imrworldwide.com domain in the privacy manifest.'''		* '''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.		* 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]].		For any additional information please refer to the Nielsen global page: [[DCR and DTVR with iOS17 or TVOS17]].

MichelFodjo at 12:05, 28 September 2023

2023-09-28T12:05:10Z

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

	== Step 1: Setting up your iOS Development Environment ==		== Step 1: 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 ===

MichelFodjo: /* Step 7 : Disclose Nielsen Privacy Statement */

2022-08-04T13:01:11Z

Step 7 : Disclose Nielsen Privacy Statement

← Older revision		Revision as of 13:01, 4 August 2022
Line 488:		Line 488:
	In order to disclose Nielsen measurement privacy statement, please include the following items in your privacy policy:		In order to disclose Nielsen measurement privacy statement, please include the following items in your privacy policy:
	* A notice that the player includes third party measurement software that allows users to contribute to market research.		* A notice that the player includes third party measurement software that allows users to contribute to market research.
	* A link to the Nielsen Digital Measurement Privacy Policy located at https://~~sites.~~nielsen.com/~~priv~~/~~browser~~/dk/da~~/DigitalMeasurement.html~~ .		* A link to the Nielsen Digital Measurement Privacy Policy located at https://nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=da .

	== Step 8 : Review the Reference Implementation for VoD and Live Streams ==		== Step 8 : Review the Reference Implementation for VoD and Live Streams ==

MichelFodjo: /* Step 7 : Disclose Nielsen Privacy Statement */

2022-02-10T09:01:19Z

Step 7 : Disclose Nielsen Privacy Statement

← Older revision		Revision as of 09:01, 10 February 2022
Line 487:		Line 487:

	In order to disclose Nielsen measurement privacy statement, please include the following items in your privacy policy:		In order to disclose Nielsen measurement privacy statement, please include the following items in your privacy policy:
	* A notice that the player includes third party measurement software that allows users to contribute to market research ~~with anonymous data~~.		* A notice that the player includes third party measurement software that allows users to contribute to market research.
	* A link to the Nielsen Digital Measurement Privacy Policy located at https://sites.nielsen.com/priv/browser/dk/da/DigitalMeasurement.html .		* A link to the Nielsen Digital Measurement Privacy Policy located at https://sites.nielsen.com/priv/browser/dk/da/DigitalMeasurement.html .

MichelFodjo at 16:22, 22 September 2021

2021-09-22T16:22:17Z

← Older revision		Revision as of 16:22, 22 September 2021
Line 255:		Line 255:
	✓		✓
	\|-style="background-color:#d0f6f8;"		\|-style="background-color:#d0f6f8;"
	\|~~pbstarttime~~ \|\| Playback Start Time (UTC): Unix timestamp in seconds matching the broadcast time for Content and Ad when a user starts and joins a live stream (seconds since Jan-1-1970 UTC)		\|pbstarttm \|\| Playback Start Time (UTC): Unix timestamp in seconds matching the broadcast time for Content and Ad when a user starts and joins a live stream (seconds since Jan-1-1970 UTC)
	\|\|		\|\|
	i.e. "1631098029" for live stream and ""(empty string) for a VoD.		i.e. "1631098029" for live stream and ""(empty string) for a VoD.
Line 294:		Line 294:
	✓		✓
	\|-style="background-color:#d0f6f8;"		\|-style="background-color:#d0f6f8;"
	\|~~pbstarttime~~ \|\| Playback Start Time (UTC): Unix timestamp in seconds matching the broadcast time for Content and Ad when a user starts and joins a live stream (seconds since Jan-1-1970 UTC)		\|pbstarttm \|\| Playback Start Time (UTC): Unix timestamp in seconds matching the broadcast time for Content and Ad when a user starts and joins a live stream (seconds since Jan-1-1970 UTC)
	\|\|		\|\|
	i.e. "1631098029" for live stream and ""(empty string) for a VoD.		i.e. "1631098029" for live stream and ""(empty string) for a VoD.
Line 325:		Line 325:
	@"stationId" : "TESTXXYYSSWWLL",		@"stationId" : "TESTXXYYSSWWLL",
	@"islivestn" : "y",		@"islivestn" : "y",
	@"~~pbstarttime~~" : "1631098029"		@"pbstarttm" : "1631098029"
	}		}

Line 335:		Line 335:
	@"stationId" : "TESTXXYYSSWWLL",		@"stationId" : "TESTXXYYSSWWLL",
	@"islivestn" : "y",		@"islivestn" : "y",
	@"~~pbstarttime~~" : "1631098029"		@"pbstarttm" : "1631098029"
	}		}
	</syntaxhighlight>		</syntaxhighlight>
Line 357:		Line 357:
	"stationId" : "TESTXXYYSSWWLL",		"stationId" : "TESTXXYYSSWWLL",
	"islivestn" : "y",		"islivestn" : "y",
	"~~pbstarttime~~" : "1631098029"		"pbstarttm" : "1631098029"
	]		]

Line 366:		Line 366:
	"stationId" : "TESTXXYYSSWWLL",		"stationId" : "TESTXXYYSSWWLL",
	"islivestn" : "y",		"islivestn" : "y",
	"~~pbstarttime~~" : "1631098029"		"pbstarttm" : "1631098029"
	]		]

MichelFodjo at 10:43, 15 September 2021

2021-09-15T10:43:18Z

@@ Line 238: / Line 238: @@
 * "1" Linear - matches TV ad load
 * "2" Dynamic - Dynamic Ad Insertion (DAI)
 ||
 ✓
 |-
-| subbrand	|| vcid/sub-brand/Channel  ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App) 	|| provided by Nielsen ||
+| subbrand	|| vcid/sub-brand/Channel  ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App)
 |}
@@ Line 255: / Line 279: @@
 |-
 | assetid ||	unique ID assigned to Ad	|| custom<br>(no [[Special Characters]])	|| ✓
 |-
 | subbrand	|| vcid/sub-brand/Channel  ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App) 	|| provided by Nielsen || ✓
@@ Line 277: / Line 321: @@
    @"airdate" : "20161013 20:00:00",
    @"isfullepisode" : "y",
-   @"adloadtype" : "2"
+   @"adloadtype" : "2",
+}
@@ Line 283: / Line 331: @@
+   {
    @"assetid" : "unique_postroll_ad_id",
-   @"type" : "postroll"
+   @"type" : "postroll",
+}
 </syntaxhighlight>
@@ Line 301: / Line 353: @@
          "airdate" : "20200713 10:22:00",
          "isfullepisode" : "y",
-         "adloadtype" : "2"
+         "adloadtype" : "2",
+      ]
      let adMetadata = [
          "assetid" : "unique_postroll_ad_id",
-         "type" : "postroll"
+         "type" : "postroll",
+     ]
@@ Line 332: / Line 392: @@
 ==== playheadPosition ====
-Pass playhead position every second during playback. for VOD: pass current position in seconds. for Live: current Unix timestamp (seconds since Jan-1-1970 UTC) - if it is possible to seek back in Live content, then pass related Unix time (not current). Pass whole number that increments only by 1 like 1,2,3..
+<pre style="background-color:#d0f6f8">
 ===== Using Objective-C =====
 <syntaxhighlight lang="objective-c">

MichelFodjo at 11:53, 2 July 2021

2021-07-02T11:53:19Z

← Older revision		Revision as of 11:53, 2 July 2021
Line 79:		Line 79:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	! Parameter / Argument !! Description !! Source !! Required~~/Obligatory?~~ !! Example		! Parameter / Argument !! Description !! Source !! Required !! Example
	\|-		\|-
	\| appid \|\| Unique id for the application assigned by Nielsen. It is GUID data type.\|\| Nielsen-specified \|\| ~~YES~~ \|\| "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"		\| appid \|\| Unique id for the application assigned by Nielsen. It is GUID data type.\|\| Nielsen-specified \|\| ✓ \|\| "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
	\|-		\|-
	\| appname \|\| Name of the application \|\| ~~Client-defined~~ \|\| NO \|\| "Nielsen Sample App"		\| appname \|\| Name of the application \|\| '''value is automatically populated through App Name included in the App Resource File''' \|\| \|\| "Nielsen Sample App"
	\|-		\|-
	\| appversion \|\| Current version of the app used \|\| ~~Client-defined~~ \|\| NO \|\| "1.0.2"		\| appversion \|\| Current version of the app used \|\| '''value is automatically populated through App Version included in the App Resource File''' \|\| \|\| "1.0.2"
	\|-		\|-
	\| nol_devDebug \|\| Enables Nielsen console logging. Only required for testing		\| nol_devDebug \|\| Enables Nielsen console logging. Only required for testing
	\|\| Nielsen-specified \|\| NO \|\| "DEBUG"		\|\| Nielsen-specified \|\| \|\| "DEBUG"
	\|}		\|}
	<br />		<br />
Line 108:		Line 108:
	NSDictionary *appInformation = @{		NSDictionary *appInformation = @{
	@"appid": "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",		@"appid": "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
	~~@"appversion": "1.0",~~
	~~@"appname": "app name here",~~
	@"nol_devDebug": @"DEBUG"		@"nol_devDebug": @"DEBUG"
	};		};
Line 140:		Line 138:
	let appInformation:[String: String] = [		let appInformation:[String: String] = [
	"appid": "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",		"appid": "PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
	~~"appversion": "1.0",~~
	~~"appname": "app name here",~~
	"nol_devDebug": "DEBUG"		"nol_devDebug": "DEBUG"
	]		]

MichelFodjo: /* Create Ad Metadata (optional for DR) */

2021-06-04T13:16:15Z

Create Ad Metadata (optional for DR)

← Older revision		Revision as of 13:16, 4 June 2021
Line 260:		Line 260:
	\| assetid \|\| unique ID assigned to Ad \|\| custom<br>(no [[Special Characters]]) \|\| ✓		\| assetid \|\| unique ID assigned to Ad \|\| custom<br>(no [[Special Characters]]) \|\| ✓
	\|-		\|-
	\| subbrand \|\| vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App) \|\| provided by Nielsen \|\|		\| subbrand \|\| vcid/sub-brand/Channel ID – value is automatically populated through provided AppID. In order to override the sub-brand configured to the App ID, value can be passed here (e.g. multiple sub-brands/Channels in the App) \|\| provided by Nielsen \|\| ✓
	\|}		\|}

MichelFodjo: /* For Ad Playback */

2021-04-20T11:00:10Z

For Ad Playback

← Older revision		Revision as of 11:00, 20 April 2021
Line 419:		Line 419:

	=== For Ad Playback ===		=== For Ad Playback ===
	[[File:nlsn-sdk-achitecture-~~diagram_ad~~.png\|\|SDK Integration Architecture Diagram - Ad]]		[[File:nlsn-sdk-achitecture-diagram-ad-v1.png\|\|SDK Integration Architecture Diagram - Ad]]

	== Step 7 : Disclose Nielsen Privacy Statement ==		== Step 7 : Disclose Nielsen Privacy Statement ==

MichelFodjo: /* For Content Playback */

2021-04-20T10:59:29Z

For Content Playback

← Older revision		Revision as of 10:59, 20 April 2021
Line 416:		Line 416:
	=== For Content Playback ===		=== For Content Playback ===

	[[File:nlsn-sdk-achitecture-~~diagram_content~~.png\|\|SDK Integration Architecture Diagram - Content]]		[[File:nlsn-sdk-achitecture-diagram-content-v1.png\|\|SDK Integration Architecture Diagram - Content]]

	=== For Ad Playback ===		=== For Ad Playback ===