DCR India Video iOS SDK - Revision history

NickParrucci: /* Privacy and Opt-Out */

2023-02-23T21:07:08Z

Privacy and Opt-Out

← Older revision		Revision as of 21:07, 23 February 2023
Line 543:		Line 543:
	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.

	'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research. Please see ~~http~~://www.nielsen.com/digitalprivacy for more information"'''		'''"Please note: This app features Nielsen’s proprietary measurement software which contributes to market research. Please see https://www.nielsen.com/digitalprivacy for more information"'''

	== Going Live ==		== Going Live ==

ColinBrown at 01:43, 10 September 2020

2020-09-10T01:43:02Z

← Older revision		Revision as of 01:43, 10 September 2020
Line 1:		Line 1:
	{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|International}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|International DCR}} {{CurrentBreadcrumb}}
	[[Category:Digital]]		[[Category:Digital]]

YaminiKumawat: changed 86400 to 0 for live stream

2018-12-13T15:26:52Z

changed 86400 to 0 for live stream

← Older revision		Revision as of 15:26, 13 December 2018
Line 227:		Line 227:
	<td> '''length''' </td>		<td> '''length''' </td>
	<td> length of content in seconds </td>		<td> length of content in seconds </td>
	<td> <code>seconds</code> (~~86400~~ for live stream) </td>		<td> <code>seconds</code> (0 for live stream) </td>
	<td> Yes		<td> Yes
	</td></tr>		</td></tr>

Admin: Admin moved page BARC-iOS to DCR India Video iOS SDK without leaving a redirect: Bad title

2018-09-12T19:38:03Z

Admin moved page BARC-iOS to DCR India Video iOS SDK without leaving a redirect: Bad title

← Older revision	Revision as of 19:38, 12 September 2018
(No difference)

Admin3 at 16:48, 21 August 2018

2018-08-21T16:48:11Z

← Older revision		Revision as of 16:48, 21 August 2018
Line 518:		Line 518:
	In case of encountering one of the above interruptions, the player application needs to		In case of encountering one of the above interruptions, the player application needs to
	* Call [[#stop\|stop]] immediately (except when content is buffering) and withhold sending playhead position.		* Call [[#stop\|stop]] immediately (except when content is buffering) and withhold sending playhead position.
	* Start sending pings – [[loadMetadata]] and [[playheadPosition]] for the new viewing session, once the playback resumes.		* Start sending pings – [[#loadMetadata\|loadMetadata]] and [[playheadPosition]] for the new viewing session, once the playback resumes.
	Please see the [[Digital Measurement FAQ]] for more details		Please see the [[Digital Measurement FAQ]] for more details

Admin3 at 16:47, 21 August 2018

2018-08-21T16:47:29Z

Admin3 at 16:46, 21 August 2018

2018-08-21T16:46:07Z

← Older revision		Revision as of 16:46, 21 August 2018
Line 374:		Line 374:
	=== API Call sequence ===		=== API Call sequence ===
	==== Use Case 1: Content has no Advertisements ====		==== Use Case 1: Content has no Advertisements ====
	Call [[play()]] with channelName JSON as below.		Call [[#play\|play()]] with channelName JSON as below.
	<syntaxhighlight lang="json">{		<syntaxhighlight lang="json">{
	"channelName": "TheMovieTitle"		"channelName": "TheMovieTitle"
Line 403:		Line 403:

	==== Use Case 2: Content has Advertisements ====		==== Use Case 2: Content has Advertisements ====
	Call [[play()]] with channelName JSON as below.		Call [[#play\|play()]] with channelName JSON as below.
	<syntaxhighlight lang="json">{		<syntaxhighlight lang="json">{
	"channelName": "TheMovieTitle"		"channelName": "TheMovieTitle"
Line 471:		Line 471:

	=== play ===		=== play ===
	Use [[play]] to pass the channel descriptor information through channelName parameter when the user taps the '''Play''' button on the player.		Use [[#play\|play]] to pass the channel descriptor information through channelName parameter when the user taps the '''Play''' button on the player.
	<syntaxhighlight lang="swift">nielsenAppApi?.play(JSONObject channelInfo);</syntaxhighlight>		<syntaxhighlight lang="swift">nielsenAppApi?.play(JSONObject channelInfo);</syntaxhighlight>

Admin3 at 16:44, 21 August 2018

2018-08-21T16:44:23Z

← Older revision		Revision as of 16:44, 21 August 2018
Line 370:		Line 370:
	<blockquote>		<blockquote>
	'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.		'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.
	* As soon as the playback resumes, call [[play]], [[#Content_Metadata\|loadMetadata]] and [[playheadPosition]].</blockquote>		* As soon as the playback resumes, call [[#play\|play]], [[#Content_Metadata\|loadMetadata]] and [[playheadPosition]].</blockquote>

	=== API Call sequence ===		=== API Call sequence ===

Admin3 at 16:25, 21 August 2018

2018-08-21T16:25:16Z

← Older revision		Revision as of 16:25, 21 August 2018
Line 378:		Line 378:
	"channelName": "TheMovieTitle"		"channelName": "TheMovieTitle"
	}</syntaxhighlight>		}</syntaxhighlight>
	Call [[#~~Content_metadata~~\|loadMetadata()]] with JSON metadata for content as below.		Call [[#Content_Metadata\|loadMetadata()]] with JSON metadata for content as below.
	<syntaxhighlight lang="json">{		<syntaxhighlight lang="json">{
	"type": "content",		"type": "content",
Line 407:		Line 407:
	"channelName": "TheMovieTitle"		"channelName": "TheMovieTitle"
	}</syntaxhighlight>		}</syntaxhighlight>
	Call [[#~~Content_metadata~~\|loadMetadata()]] with JSON metadata for ad as below.		Call [[#Content_Metadata\|loadMetadata()]] with JSON metadata for ad as below.
	<syntaxhighlight lang="json">{		<syntaxhighlight lang="json">{
	"type": "preroll",		"type": "preroll",
	"assetid": "ad=123"		"assetid": "ad=123"
	}</syntaxhighlight>		}</syntaxhighlight>
	<blockquote>Note: In case the individual ad details are not available, send ad pod (presence) details through the [[#~~Content_metadata~~\|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 [[#Content_Metadata\|loadMetadata]] and playhead position through [[playheadPosition]].</blockquote>

	Call [[setPlayheadPosition()]] every one second until a pause / stop / another [[#~~Content_metadata~~\|loadMetadata()]] is called. Playhead should be passed for the entire duration of ad pod, if the ad pod details are passed as part of [[#~~Content_metadata~~\|loadMetadata()]].		Call [[setPlayheadPosition()]] every one second until a pause / stop / another [[#Content_Metadata\|loadMetadata()]] is called. Playhead should be passed for the entire duration of ad pod, if the ad pod details are passed as part of [[#Content_Metadata\|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.

Admin3 at 16:24, 21 August 2018

2018-08-21T16:24:30Z

← Older revision		Revision as of 16:24, 21 August 2018
Line 360:		Line 360:
	# '''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. [[#play\|play]] and [[#~~Content_metadata~~\|loadMetadata]] calls move the SDK instance into this state. In this state, the SDK instance will be able to process the following calls.		# '''Processing state''' – The SDK instance is processing playing information. [[#play\|play]] and [[#Content_Metadata\|loadMetadata]] calls move the SDK instance into this state. In this state, the SDK instance will be able to process the following calls.
	## [[#play\|playheadPosition]] – Call this API every one second when playhead position timer is fired.		## [[#play\|playheadPosition]] – Call this API every one second when playhead position timer is fired.
	## [[#play\|stop]] – Call this API when the playback is paused, switches between content and ad (within the same content playback) or encounters interruptions.		## [[#play\|stop]] – Call this API when the playback is paused, switches between content and ad (within the same content playback) or encounters interruptions.
Line 370:		Line 370:
	<blockquote>		<blockquote>
	'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.		'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.
	* As soon as the playback resumes, call [[play]], [[#~~Content_metadata~~\|loadMetadata]] and [[playheadPosition]].</blockquote>		* As soon as the playback resumes, call [[play]], [[#Content_Metadata\|loadMetadata]] and [[playheadPosition]].</blockquote>

	=== API Call sequence ===		=== API Call sequence ===

← Older revision		Revision as of 16:47, 21 August 2018
Line 362:		Line 362:
	# '''Processing state''' – The SDK instance is processing playing information. [[#play\|play]] and [[#Content_Metadata\|loadMetadata]] calls move the SDK instance into this state. In this state, the SDK instance will be able to process the following calls.		# '''Processing state''' – The SDK instance is processing playing information. [[#play\|play]] and [[#Content_Metadata\|loadMetadata]] calls move the SDK instance into this state. In this state, the SDK instance will be able to process the following calls.
	## [[#play\|playheadPosition]] – Call this API every one second when playhead position timer is fired.		## [[#play\|playheadPosition]] – Call this API every one second when playhead position timer is fired.
	## [[#~~play~~\|stop]] – Call this API when the playback is paused, switches between content and ad (within the same content playback) or encounters interruptions.		## [[#stop\|stop]] – Call this API when the playback is paused, switches between content and ad (within the same content playback) or encounters interruptions.
	## [[#play\|end]] – SDK instance exits from Processing state when this API is called.		## [[#play\|end]] – SDK instance exits from Processing state when this API is called.
	# '''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.
Line 369:		Line 369:

	<blockquote>		<blockquote>
	'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.		'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[#stop\|stop]] to stop the measurement.
	* As soon as the playback resumes, call [[#play\|play]], [[#Content_Metadata\|loadMetadata]] and [[playheadPosition]].</blockquote>		* As soon as the playback resumes, call [[#play\|play]], [[#Content_Metadata\|loadMetadata]] and [[playheadPosition]].</blockquote>

Line 517:		Line 517:
	* Unplugging of headphone		* Unplugging of headphone
	In case of encountering one of the above interruptions, the player application needs to		In case of encountering one of the above interruptions, the player application needs to
	* Call [[stop]] immediately (except when content is buffering) and withhold sending playhead position.		* Call [[#stop\|stop]] immediately (except when content is buffering) and withhold sending playhead position.
	* Start sending pings – [[loadMetadata]] and [[playheadPosition]] for the new viewing session, once the playback resumes.		* Start sending pings – [[loadMetadata]] and [[playheadPosition]] for the new viewing session, once the playback resumes.
	Please see the [[Digital Measurement FAQ]] for more details		Please see the [[Digital Measurement FAQ]] for more details