DCR Italy Static App SDK - Revision history

ColinBrown at 01:41, 10 September 2020

2020-09-10T01:41:24Z

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

MarkTufano at 17:10, 16 June 2020

2020-06-16T17:10:55Z

← Older revision		Revision as of 17:10, 16 June 2020
Line 27:		Line 27:
	"type": "static",		"type": "static",
	"assetid": "vid345-67483",		"assetid": "vid345-67483",
	"section": "~~siteSection~~"		"section": "Home_EntityName_iOS"
	];		];
	self.nielsenAppApi?.loadMetadata(staticMetadata)		self.nielsenAppApi?.loadMetadata(staticMetadata)
Line 36:		Line 36:
	"type": "static",		"type": "static",
	"assetid": "vid345-67483",		"assetid": "vid345-67483",
	"section": "~~siteSection~~"		"section": "Home_EntityName_iOS"
	}		}
	– (void)loadMetadata:(id)staticMetadata;		– (void)loadMetadata:(id)staticMetadata;
Line 43:		Line 43:
	\|Android = <syntaxhighlight lang="java"> JSONObject staticMetadata = new JSONObject()		\|Android = <syntaxhighlight lang="java"> JSONObject staticMetadata = new JSONObject()
	.put("type", "static")		.put("type", "static")
	.put("section", "~~siteSection~~")		.put("section", "Home_EntityName_Android")
	.put("assetid", "vid345-67483")		.put("assetid", "vid345-67483")
	}		}
Line 63:		Line 63:
	\| assetid \|\| Unique ID for each article \|\| dynamic \|\| custom \|\| Yes		\| assetid \|\| Unique ID for each article \|\| dynamic \|\| custom \|\| Yes
	\|-		\|-
	\| section \|\| section of ~~each site (e.g. section value should~~ be ~~first level in page URL: website.com~~/~~section). Limit to 25 unique values~~ \|\| dynamic \|\| ~~custom~~ \|\| Yes		\| section \|\| section of the App to be measured </br> EntityName = brand name or sub-brand name\|\| dynamic \|\| <code>Home_EntityName_Android</code> for Android App </br><code>Home_EntityName_iOS</code> for iOS App \|\| Yes
	\|}		\|}

NielsSedat at 09:01, 14 November 2017

2017-11-14T09:01:15Z

← Older revision		Revision as of 09:01, 14 November 2017
Line 97:		Line 97:

	== Privacy and Opt-Out ==		== Privacy and Opt-Out ==
	Please follow the steps outlined in the [[DCR Italy Video App SDK]] documentation.		Please follow the steps outlined in the [[DCR Italy Video App SDK\|Privacy_and_Opt-Out]] documentation.

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

Admin3 at 18:40, 8 November 2017

2017-11-08T18:40:57Z

← Older revision		Revision as of 18:40, 8 November 2017
Line 103:		Line 103:

	# '''Debug Logging''': Disable logging by deleting <code>{nol_sdkDebug: 'DEBUG'}</code> from initialization call.		# '''Debug Logging''': Disable logging by deleting <code>{nol_sdkDebug: 'DEBUG'}</code> from initialization call.
	#* '''Example Production Initialization Call''' - Refer to the production initialization call below:<syntaxhighlight lang="~~javascript~~">~~var nSdkInstance~~ = ~~NOLBUNDLE~~.~~nlsQ~~("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "~~nlsnInstance~~");</syntaxhighlight>		#* '''Example Production Initialization Call''' - Refer to the production initialization call below:

			'''<big>iOS Example:</big>'''

			<syntaxhighlight lang="swift">
			class NielsenInit: NSObject {
			class func createNielsenAppApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{
			let appInformation:[String: String] = [
			"appid": "PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX",
			"sfcode": "it"
			// Remove Flag: "nol_devDebug": "DEBUG"
			]
			return NielsenAppApi(appInfo:appInformation, delegate:delegate)
			}
			}
			</syntaxhighlight>


			'''<big>Android Example:</big>'''
			<syntaxhighlight lang="java">
			try
			{
			// Prepare AppSdk configuration object (JSONObject)
			JSONObject appSdkConfig = new JSONObject()
			.put("appid", "PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")
			.put("sfcode", "it")
			// Remove Flag: "nol_devDebug": "DEBUG"

			// Pass appSdkConfig to the AppSdk constructor
			mAppSdk = new AppSdk(appContext, appSdkConfig, appSdkListener);
			}
			catch (JSONException e)
			{
			Log.e(TAG, "Couldn’t prepare JSONObject for appSdkConfig", e);
			}
			</syntaxhighlight>

Admin3 at 17:14, 8 November 2017

2017-11-08T17:14:36Z

@@ Line 82: / Line 82: @@
 === Using the Android SdkBgFbDetectionUtility Class ===
 For developers who are already using the application class, it is recommended that background/foreground state is implemented using the  [[Android_Background_Foreground|SdkBgFgDetectionUtility class]].  The  [[Android_Background_Foreground|SdkBgFgDetectionUtility class]] is compatible with Android 4+ and has been made available to Nielsen clients.
 Correct measurement of the foreground/background state is crucial to Static App measurement within Nielsen Digital Content Ratings (DCR).

Admin3: ForeGround/Background update

2017-11-08T17:09:58Z

ForeGround/Background update

@@ Line 69: / Line 69: @@
 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]:
-For Android devices,  Nielsen has has made available the [[Android_Background_Foreground|SdkBgFgDetectionUtility class]] for detection of the Foreground/Background state.
+Foreground/Background state measurement is a requirement of Nielsen AppSDK implementation which is especially crucial for static measurement. It may be implemented in multiple ways for Android. This includes
 Correct measurement of the foreground/background state is crucial to Static App measurement within Nielsen Digital Content Ratings (DCR).

Admin3 at 16:35, 8 November 2017

2017-11-08T16:35:56Z

← Older revision		Revision as of 16:35, 8 November 2017
Line 77:		Line 77:

	== Going Live ==		== Going Live ==
	~~Once the DCR Tracking Code is added to Instant Articles, Nielsen will validate the implementation.~~ Following Nielsen testing, users need to make one update to the initialization call to ensure that the site is being measured properly.		Following Nielsen testing, users need to make one update to the initialization call to ensure that the site is being measured properly.

	# '''Debug Logging''': Disable logging by deleting <code>{nol_sdkDebug: 'DEBUG'}</code> from initialization call.		# '''Debug Logging''': Disable logging by deleting <code>{nol_sdkDebug: 'DEBUG'}</code> from initialization call.
	#* '''Example Production Initialization Call''' - Refer to the production initialization call below:<syntaxhighlight lang="javascript">var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "nlsnInstance");</syntaxhighlight>		#* '''Example Production Initialization Call''' - Refer to the production initialization call below:<syntaxhighlight lang="javascript">var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "nlsnInstance");</syntaxhighlight>

Admin3 at 16:34, 8 November 2017

2017-11-08T16:34:08Z

← Older revision		Revision as of 16:34, 8 November 2017
Line 75:		Line 75:
	== Privacy and Opt-Out ==		== Privacy and Opt-Out ==
	Please follow the steps outlined in the [[DCR Italy Video App SDK]] documentation.		Please follow the steps outlined in the [[DCR Italy Video App SDK]] documentation.

			== Going Live ==
			Once the DCR Tracking Code is added to Instant Articles, Nielsen will validate the implementation. Following Nielsen testing, users need to make one update to the initialization call to ensure that the site is being measured properly.

			# '''Debug Logging''': Disable logging by deleting <code>{nol_sdkDebug: 'DEBUG'}</code> from initialization call.
			#* '''Example Production Initialization Call''' - Refer to the production initialization call below:<syntaxhighlight lang="javascript">var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", "nlsnInstance");</syntaxhighlight>

Admin3 at 16:31, 8 November 2017

2017-11-08T16:31:32Z

← Older revision		Revision as of 16:31, 8 November 2017
Line 26:		Line 26:
	let staticMetadata = [		let staticMetadata = [
	"type": "static",		"type": "static",
			"assetid": "vid345-67483",
	"section": "siteSection"		"section": "siteSection"
	];		];
Line 34:		Line 35:
	{		{
	"type": "static",		"type": "static",
			"assetid": "vid345-67483",
	"section": "siteSection"		"section": "siteSection"
	}		}

Admin3 at 16:30, 8 November 2017

2017-11-08T16:30:03Z

← Older revision		Revision as of 16:30, 8 November 2017
Line 26:		Line 26:
	let staticMetadata = [		let staticMetadata = [
	"type": "static",		"type": "static",
	"section": "siteSection",		"section": "siteSection"
	~~"segA":"CustomSegmentValueA", //Optional~~
	~~"segB":"CustomSegmentValueB", //Optional~~
	~~"segC":"CustomSegmentValueC" //Optional~~
	];		];
	self.nielsenAppApi?.loadMetadata(staticMetadata)		self.nielsenAppApi?.loadMetadata(staticMetadata)
Line 37:		Line 34:
	{		{
	"type": "static",		"type": "static",
	"section": "siteSection",		"section": "siteSection"
	~~"segA":"CustomSegmentValueA", //Optional~~
	~~"segB":"CustomSegmentValueB", //Optional~~
	~~"segC":"CustomSegmentValueC" //Optional~~
	}		}
	– (void)loadMetadata:(id)staticMetadata;		– (void)loadMetadata:(id)staticMetadata;
Line 49:		Line 43:
	.put("section", "siteSection")		.put("section", "siteSection")
	.put("assetid", "vid345-67483")		.put("assetid", "vid345-67483")
	~~.put("segA", "segmentA") //Optional~~
	~~.put("segB", "segmentB") //Optional~~
	~~.put("segC","segmentC") //Optional~~
	}		}
	public void loadMetadata(JSONObject staticMetadata);		public void loadMetadata(JSONObject staticMetadata);