DCR Static Facebook Instant Articles Browser SDK - Revision history

Admin3 at 18:03, 27 July 2018

2018-07-27T18:03:41Z

← Older revision		Revision as of 18:03, 27 July 2018
Line 1:		Line 1:
	~~{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}~~
	~~[[Category:Digital]]~~

	~~This guide will show you how to enable Digital Content Ratings (DCR) measurement on your Facebook Instant Articles.~~

	{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}
	[[Category:Digital]]		[[Category:Digital]]

Admin3: Moved doc back to Static Lite Version

2018-07-27T18:03:22Z

Moved doc back to Static Lite Version

← Older revision		Revision as of 18:03, 27 July 2018
Line 1:		Line 1:
			{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}
			[[Category:Digital]]

			This guide will show you how to enable Digital Content Ratings (DCR) measurement on your Facebook Instant Articles.

	{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}
	[[Category:Digital]]		[[Category:Digital]]
Line 14:		Line 19:

	For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview \| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.		For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview \| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.


	The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:		The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:
	<syntaxhighlight lang="html">		<syntaxhighlight lang="html">// load Nielsen JS Library
	<script>		<script type="text/javascript">
	~~// Static Queue Snippet~~		function loadNielsen()
	!function(~~t,n~~){~~t[n]~~=~~t[n]\|\|~~{~~nlsQ~~:~~function(e~~,~~o,c,r,s,i){return s=t.document,r=s.createElement("script"),r.async=1,r.src=("http:"===t.~~location.~~protocol?"http~~:":~~"https:")+"~~//~~cdn-gl~~.~~imrworldwide.com~~/~~conf~~/~~"+e+".js#name~~=~~"+o+"&ns="+n,i=s.getElementsByTagName("script")[0],i.parentNode~~.~~insertBefore(r,i),t[n][o]=t[n][o]\|\|{g:c\|\|{},ggPM:function~~(~~e,c,r,s,i){(t[n][o].q=t[n][o].q\|\|[])~~.~~push([e,c,r,s,i])}},t[n][o]}}}(window,"NOLBUNDLE"~~);		{
			// create initialization object
	// SDK ~~Initialization~~		var _nolggGlobalParams =
	~~var nSdkInstance = NOLBUNDLE~~.~~nlsQ~~(~~"PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nsdkvOverride: "501", nol_sdkDebug: "debug"}~~);		{
			sfcode: 'XXX-cert', // location of collections environment. Value will be provided for testing
	// ~~Content Metadata~~		apid: 'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', // assigned App ID will be provided for testing
	var ~~nielsenMetadata~~ = {		apn: 'PublisherName Instant Articles' // name to identify integration. Can be custom value
	type: 'static',		};
	assetid: '', // ~~DYNAMIC METADATA~~: unique ID for each article ~~REQUIRED~~
	section: '', // ~~DYNAMIC METADATA~~: section of site REQUIRED		// create SDK instance
	segA: '', // ~~DYNAMIC METADATA~~: custom segment		var gg1 = NOLCMB.getInstance(_nolggGlobalParams.apid);
	segB: '', // ~~DYNAMIC METADATA~~: custom segment
	segC: 'Instant Articles'		// initialize SDK with initialization object
	};		gg1.ggInitialize(_nolggGlobalParams);

			// create object with metadata for Instant Article
			var staticmeta =
			{
			type: 'static',
			assetid: '', // UPDATE: unique ID for each article
			section: '', // UPDATE: section or category for article
			segA: '', // UPDATE: custom segment
			segB: '', // UPDATE: custom segment
			segC: 'Instant Articles'
			};

	// ~~Event 'staticstart' Call~~		// pass metadata for Instant Article when it is opened
	~~nSdkInstance~~.ggPM("staticstart", ~~nielsenMetadata~~);		gg1.ggPM("staticstart",staticmeta);
	</script></syntaxhighlight>		}
			</script>
			<script type="text/javascript" src="https://seccdn-gl.imrworldwide.com/novms/js/2/ggcmb501.js" onload="loadNielsen()"></script></syntaxhighlight>

	=== Configure Metadata ===		=== Configure Metadata ===
Line 50:		Line 67:
	\|-		\|-
	\| apid \|\| unique ID assigned by Nielsen \|\| <code>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</code> \|\| ✓		\| apid \|\| unique ID assigned by Nielsen \|\| <code>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</code> \|\| ✓
			\|-
			\| apv \|\| current version of the Nielsen implementation \|\| <code>1.0</code> \|\| ✓
	\|-		\|-
	\| section \|\| section of the site to be measured \|\| <code>Entertainment</code> \|\| ✓		\| section \|\| section of the site to be measured \|\| <code>Entertainment</code> \|\| ✓
Line 99:		Line 118:

	=== Going Live ===		=== Going Live ===
	Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation ~~after which~~ you ~~must disable Debug logging by deleting {nol_sdkDebug: 'DEBUG'} from~~ the ~~initialization call.~~		Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation. Following Nielsen testing, you will need to update the test values included in the tracking code:
			# <code>apid: 'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'</code>
	~~Example~~:		# <code>sfcode: 'XXX'</code>
	<~~syntaxhighlight lang="javascript"~~>		We will confirm the production values to use after testing is completed.
	~~var nSdkInstance = NOLBUNDLE.nlsQ("~~PXXXXXXXX-XXXX-XXXX-XXXX-~~XXXXXXXXXX","nlsnInstance", {nsdkvOverride~~: ~~"501"});~~
	</~~syntaxhighlight~~>

Admin at 21:01, 15 December 2017

2017-12-15T21:01:24Z

← Older revision		Revision as of 21:01, 15 December 2017
Line 13:		Line 13:
	</figure></syntaxhighlight>		</figure></syntaxhighlight>

	For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview\| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.		For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview \| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.

Admin: Move to 600

2017-12-15T21:00:50Z

Move to 600

← Older revision		Revision as of 21:00, 15 December 2017
Line 13:		Line 13:
	</figure></syntaxhighlight>		</figure></syntaxhighlight>

	For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview \| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.		For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview\| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.


	The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:		The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:
	<syntaxhighlight lang="html">~~// load Nielsen JS Library~~		<syntaxhighlight lang="html">
	<script ~~type="text~~/~~javascript">~~		<script>
	function ~~loadNielsen~~()		// Static Queue Snippet
	{		!function(t,n){t[n]=t[n]\|\|{nlsQ:function(e,o,c,r,s,i){return s=t.document,r=s.createElement("script"),r.async=1,r.src=("http:"===t.location.protocol?"http:":"https:")+"//cdn-gl.imrworldwide.com/conf/"+e+".js#name="+o+"&ns="+n,i=s.getElementsByTagName("script")[0],i.parentNode.insertBefore(r,i),t[n][o]=t[n][o]\|\|{g:c\|\|{},ggPM:function(e,c,r,s,i){(t[n][o].q=t[n][o].q\|\|[]).push([e,c,r,s,i])}},t[n][o]}}}(window,"NOLBUNDLE");
	~~// create initialization object~~
	~~var _nolggGlobalParams~~ =		// SDK Initialization
	{		var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nsdkvOverride: "501", nol_sdkDebug: "debug"});
	~~sfcode~~: ~~'XXX-cert'~~, // location ~~of collections environment~~. ~~Value will be provided for testing~~
	~~apid~~: ~~'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',~~ // ~~assigned App ID will be provided for testing~~		// Content Metadata
	~~apn: 'PublisherName Instant Articles'~~ // name ~~to identify integration~~. ~~Can be custom value~~		var nielsenMetadata = {
	};		type: 'static',
			assetid: '', // DYNAMIC METADATA: unique ID for each article REQUIRED
	~~// create SDK instance~~		section: '', // DYNAMIC METADATA: section of site REQUIRED
	~~var gg1~~ = ~~NOLCMB~~.~~getInstance~~(~~_nolggGlobalParams.apid~~);		segA: '', // DYNAMIC METADATA: custom segment
			segB: '', // DYNAMIC METADATA: custom segment
	// ~~initialize~~ SDK ~~with initialization object~~		segC: 'Instant Articles'
	~~gg1~~.~~ggInitialize~~(~~_nolggGlobalParams~~);		};

	// ~~create object with metadata for Instant Article~~
	var ~~staticmeta~~ =
	{
	type: 'static',
	assetid: '', // ~~UPDATE~~: unique ID for each article
	section: '', // ~~UPDATE~~: section ~~or category for article~~
	segA: '', // ~~UPDATE~~: custom segment
	segB: '', // ~~UPDATE~~: custom segment
	segC: 'Instant Articles'
	};

	// ~~pass metadata for Instant Article when it is opened~~		// Event 'staticstart' Call
	~~gg1~~.ggPM("staticstart",~~staticmeta~~);		nSdkInstance.ggPM("staticstart", nielsenMetadata);
	}		</script></syntaxhighlight>
	~~</script>~~
	~~<script type="text/javascript" src="https://seccdn-gl.imrworldwide.com/novms/js/2/ggcmb501.js" onload="loadNielsen()">~~</script></syntaxhighlight>

	=== Configure Metadata ===		=== Configure Metadata ===
Line 62:		Line 50:
	\|-		\|-
	\| apid \|\| unique ID assigned by Nielsen \|\| <code>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</code> \|\| ✓		\| apid \|\| unique ID assigned by Nielsen \|\| <code>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</code> \|\| ✓
	\|-
	~~\| apv \|\| current version of the Nielsen implementation \|\| <code>1.0</code> \|\| ✓~~
	\|-		\|-
	\| section \|\| section of the site to be measured \|\| <code>Entertainment</code> \|\| ✓		\| section \|\| section of the site to be measured \|\| <code>Entertainment</code> \|\| ✓
Line 113:		Line 99:

	=== Going Live ===		=== Going Live ===
	Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation~~. Following Nielsen testing,~~ you ~~will need to update~~ the ~~test values included in the tracking code~~:		Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation after which you must disable Debug logging by deleting {nol_sdkDebug: 'DEBUG'} from the initialization call.
	# <~~code~~>~~apid: '~~PXXXXXXXX-XXXX-XXXX-XXXX-~~XXXXXXXXXXXX'</code>~~
	~~# <code>sfcode: 'XXX'~~</~~code~~>		Example:
	~~We will confirm the production values to use after testing is completed.~~		<syntaxhighlight lang="javascript">
			var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nsdkvOverride: "501"});
			</syntaxhighlight>

Admin at 21:42, 5 December 2017

2017-12-05T21:42:31Z

← Older revision		Revision as of 21:42, 5 December 2017
Line 114:		Line 114:
	=== Going Live ===		=== Going Live ===
	Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation. Following Nielsen testing, you will need to update the test values included in the tracking code:		Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation. Following Nielsen testing, you will need to update the test values included in the tracking code:
	# <code>apid: ~~‘PXXXXXXXX~~-XXXX-XXXX-XXXX-~~XXXXXXXXXXXX’~~</code>		# <code>apid: 'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'</code>
	# <code>sfcode: ~~‘XXX’~~</code>		# <code>sfcode: 'XXX'</code>
	We will confirm the production values to use after testing is completed.		We will confirm the production values to use after testing is completed.

Admin: Broken FB Link

2017-11-17T00:23:28Z

Broken FB Link

← Older revision		Revision as of 00:23, 17 November 2017
Line 13:		Line 13:
	</figure></syntaxhighlight>		</figure></syntaxhighlight>

	For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview\| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.		For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview \| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.

	The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:		The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:

Admin at 13:17, 25 October 2017

2017-10-25T13:17:32Z

← Older revision		Revision as of 13:17, 25 October 2017
Line 24:		Line 24:
	{		{
	sfcode: 'XXX-cert', // location of collections environment. Value will be provided for testing		sfcode: 'XXX-cert', // location of collections environment. Value will be provided for testing
	apid: '~~TXXXXXXXX~~-XXXX-XXXX-XXXX-XXXXXXXXXXXX', // assigned App ID will be provided for testing		apid: 'PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX', // assigned App ID will be provided for testing
	apn: 'PublisherName Instant Articles' // name to identify integration. Can be custom value		apn: 'PublisherName Instant Articles' // name to identify integration. Can be custom value
	};		};

Admin at 01:51, 7 June 2017

2017-06-07T01:51:08Z

← Older revision		Revision as of 01:51, 7 June 2017
Line 1:		Line 1:
	{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|~~Digital Content Ratings~~}} {{CurrentBreadcrumb}}		{{Breadcrumb\|}} {{Breadcrumb\|Digital}} {{Breadcrumb\|DCR & DTVR}} {{CurrentBreadcrumb}}
	[[Category:Digital]]		[[Category:Digital]]

Admin at 01:50, 7 June 2017

2017-06-07T01:50:46Z

← Older revision		Revision as of 01:50, 7 June 2017
Line 13:		Line 13:
	</figure></syntaxhighlight>		</figure></syntaxhighlight>

	For more information on the Analytics element, you can refer to the [https:/~~/sdk~~/developers.facebook.com/docs/instant-articles/~~ads-~~analytics\| Analytics ~~Services~~] section of Facebook’s Instant Article Developer Documentation.		For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview\| Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.

	The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:		The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:

Admin: Admin moved page DCR Static - Facebook Instant Articles to DCR Static Facebook Instant Articles Browser SDK without leaving a redirect

2017-06-01T22:07:58Z

Admin moved page DCR Static - Facebook Instant Articles to DCR Static Facebook Instant Articles Browser SDK without leaving a redirect

← Older revision	Revision as of 22:07, 1 June 2017
(No difference)