DCR Static iOS SDK - Revision history

Mywikis at 02:50, 27 March 2024

2024-03-27T02:50:22Z

← Older revision		Revision as of 02:50, 27 March 2024
Line 2:		Line 2:
	[[Category:Digital]]		[[Category:Digital]]

	~~== Overview ==~~
	The Nielsen SDK is one of multiple framework SDKs that Nielsen provides to enable measuring linear (live) and on-demand TV viewing using TVs, mobile devices, etc.		The Nielsen SDK is one of multiple framework SDKs that Nielsen provides to enable measuring linear (live) and on-demand TV viewing using TVs, mobile 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:

NickParrucci: /* DCR Static Duration Measurement per Section/Page/Asset */

2023-03-30T21:01:09Z

DCR Static Duration Measurement per Section/Page/Asset

← Older revision		Revision as of 21:01, 30 March 2023
Line 287:		Line 287:
	<span class="mw-customtoggle-myDivisionDiag" style="color: cornflowerblue"> Show flow diagram for above description </span>		<span class="mw-customtoggle-myDivisionDiag" style="color: cornflowerblue"> Show flow diagram for above description </span>
	<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionDiag">		<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionDiag">
	[[File:~~DCR static view flow.png~~.png\|500px]]		[[File:DCRstaticflow.png\|500px]]
	</div>		</div>
	<br>		<br>
Line 370:		Line 370:
	</div>		</div>
	'''Note:''' Even though the assetid has changed, a new view event would not be recognized unless staticEnd() is called in between loadMetadata calls, because the section name did not change.		'''Note:''' Even though the assetid has changed, a new view event would not be recognized unless staticEnd() is called in between loadMetadata calls, because the section name did not change.


	== Handling Foreground and Background states ==		== Handling Foreground and Background states ==

NickParrucci at 20:59, 30 March 2023

2023-03-30T20:59:45Z

@@ Line 281: / Line 281: @@
 | segC || Maximum number of unique values allowed across segA, segB, and segC is 25 (segA + segB + segC<= 25)
 |}
 == Handling Foreground and Background states ==
 For iOS, background/foreground detection is handled by the app lifecylce APIs which are provided by [https://developer.apple.com/library/content/documentation/iPhone/Conceptual/iPhoneOSProgrammingGuide/TheAppLifeCycle/TheAppLifeCycle.html Apple:]

NickParrucci: /* Overview */

2023-03-30T20:56:26Z

Overview

← Older revision		Revision as of 20:56, 30 March 2023
Line 6:		Line 6:
	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
			*How long each app page/section was viewed (if enabled by your Nielsen representative)

	== Prerequisites for Static Measurement==		== Prerequisites for Static Measurement==
	This Guide is for the Implementation of Static Measurement. For implementation of Static and Video, please refer to the [[DCR_Video_iOS_SDK\|iOS DCR Video Implementation Guide]]. <br>		This Guide is for the Implementation of Static Measurement. For implementation of Static and Video, please refer to the [[DCR_Video_iOS_SDK\|iOS DCR Video Implementation Guide]]. <br>

ColinBrown at 01:00, 10 September 2020

2020-09-10T01:00:37Z

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

ColinBrown at 21:32, 12 July 2019

2019-07-12T21:32:47Z

← Older revision		Revision as of 21:32, 12 July 2019
Line 130:		Line 130:

	Sample code using AVPlayer.		Sample code using AVPlayer.
	<code>~~ViewController~~.swift</code>		<code>LandingVC.swift</code>

	<syntaxhighlight lang="swift">		<syntaxhighlight lang="swift">
			import UIKit
			import NielsenAppApi


			class LandingVC: UIViewController, NielsenAppApiDelegate {

			var nielsenMain : NielsenAppApi!
			var sdkMethods : SDKMethods!
			var data : [String : Any]!

	class ViewController: UIViewController, NielsenAppApiDelegate, AVPlayerViewControllerDelegate {		class ViewController: UIViewController, NielsenAppApiDelegate, AVPlayerViewControllerDelegate {

Line 203:		Line 213:
	\|Swift =		\|Swift =
	<syntaxhighlight lang="swift">		<syntaxhighlight lang="swift">
			class SDKMethods : NSObject{
	let ~~staticMetadata~~ = [		func loadStaticMaster() -> [String : Any] {
			//Loading Static Main data
			let staticData =
			[
	"type": "static",		"type": "static",
	"assetid": "C77664",		"assetid": "C77664", //optional for static measurement
	"section": "siteSection",		"section": "siteSection",
	"segA": "segmentA",		"segA": "segmentA",
	"segB": "CustomSegmentValueB", //optional		"segB": "CustomSegmentValueB", //optional
	"segC": "CustomSegmentValueC", //optional		"segC": "CustomSegmentValueC", //optional
	];		]
			return staticData
			}
	</syntaxhighlight>		</syntaxhighlight>
	\|Objective C =		\|Objective C =
Line 217:		Line 232:
	NSDictionary * staticMetadata = @ {		NSDictionary * staticMetadata = @ {
	@ "type": @ "static",		@ "type": @ "static",
	@ "assetid": @ "C77664",		@ "assetid": @ "C77664", //optional for static measurement
	@ "section": @ "siteSection",		@ "section": @ "siteSection",
	@ "segA": @ "Segment A",		@ "segA": @ "Segment A",

ColinBrown at 21:22, 12 July 2019

2019-07-12T21:22:36Z

← Older revision		Revision as of 21:22, 12 July 2019
Line 139:		Line 139:
	override func viewDidLoad() {		override func viewDidLoad() {
	super.viewDidLoad()		super.viewDidLoad()

	//Getting the instance of NielsenApi		//Getting the instance of NielsenApi
	self.nielsenApi = NielsenInit.createNielsenApi(delegate: self)		self.nielsenApi = NielsenInit.createNielsenApi(delegate: self)

	}		}
	}		}

ColinBrown at 21:22, 12 July 2019

2019-07-12T21:22:14Z

← Older revision		Revision as of 21:22, 12 July 2019
Line 145:		Line 145:
	}		}
	}		}
	override func viewDidAppear(_ animated: Bool) {		override func viewDidAppear(_ animated: Bool) {
			self.data = sdkMethods.loadStaticMaster() // This is just an example of populating the metadata
	self.data = sdkMethods.loadStaticMaster()
	self.nielsenMain.loadMetadata(self.data)		self.nielsenMain.loadMetadata(self.data)

	}		}
	</syntaxhighlight>		</syntaxhighlight>

ColinBrown at 21:19, 12 July 2019

2019-07-12T21:19:43Z

← Older revision		Revision as of 21:19, 12 July 2019
Line 145:		Line 145:
	}		}
	}		}
			override func viewDidAppear(_ animated: Bool) {

			self.data = sdkMethods.loadStaticMaster()
			self.nielsenMain.loadMetadata(self.data)

			}
	</syntaxhighlight>		</syntaxhighlight>
	\|Objective C =		\|Objective C =
Line 224:		Line 230:
	}}		}}
	[[File:Sdk_dataflow.jpg\|link=]]		[[File:Sdk_dataflow.jpg\|link=]]

	=== Configure Metadata ===		=== Configure Metadata ===
	Map the Nielsen keys to variables so that the content metadata is dynamically updated.		Map the Nielsen keys to variables so that the content metadata is dynamically updated.

ColinBrown at 15:52, 5 June 2019

2019-06-05T15:52:43Z

← Older revision		Revision as of 15:52, 5 June 2019
Line 270:		Line 270:
	After the application is ready to be sent for Nielsen Certification, please go through the [[DCR_Pre-Certification_Checklist\|Pre-Certification Checklist]] and ensure the app behaves as expected, before submitting to Nielsen.		After the application is ready to be sent for Nielsen Certification, please go through the [[DCR_Pre-Certification_Checklist\|Pre-Certification Checklist]] and ensure the app behaves as expected, before submitting to Nielsen.

	=== Testing an Implementation - App ===		== Testing an Implementation - App ==
	See [[Digital Measurement Testing]].		See [[Digital Measurement Testing]].