DCR Denmark Video Browser SDK - Revision history

MichelFodjo: /* Disclose Nielsen Privacy Statement */

2022-08-04T13:02:46Z

Disclose Nielsen Privacy Statement

← Older revision		Revision as of 13:02, 4 August 2022
Line 388:		Line 388:
	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		* A link to the Nielsen Digital Measurement Privacy Policy located at https://nielsen.com/legal/privacy-principles/digital-measurement-privacy-statement/?lang=da .
	** For Danish: https://www.nielsen.com/dk/da/legal/privacy-statement/digital-measurement/
	** For English: https://~~www.~~nielsen.com~~/dk/en~~/legal/privacy-~~statement~~/digital-measurement-privacy-statement/

	=== Turning off the First Party ID for Opt-out Users ===		=== Turning off the First Party ID for Opt-out Users ===

MichelFodjo: /* Disclose Nielsen Privacy Statement */

2022-03-07T08:40:22Z

Disclose Nielsen Privacy Statement

@@ Line 391: / Line 391: @@
 ** For Danish: https://www.nielsen.com/dk/da/legal/privacy-statement/digital-measurement/
 ** For English: https://www.nielsen.com/dk/en/legal/privacy-statement/digital-measurement-privacy-statement/
 == Test your player by yourself ==

MichelFodjo: /* Disclose Nielsen Privacy Statement */

2022-02-10T08:59:21Z

Disclose Nielsen Privacy Statement

← Older revision		Revision as of 08:59, 10 February 2022
Line 387:		Line 387:

	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		* A link to the Nielsen Digital Measurement Privacy Policy located at
	** For Danish: https://www.nielsen.com/dk/da/legal/privacy-statement/digital-measurement/		** For Danish: https://www.nielsen.com/dk/da/legal/privacy-statement/digital-measurement/

ColinBrown: /* Disclose Nielsen Privacy Statement */

2022-01-06T19:10:19Z

Disclose Nielsen Privacy Statement

← Older revision		Revision as of 19:10, 6 January 2022
Line 389:		Line 389:
	* 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 with anonymous data.
	* A link to the Nielsen Digital Measurement Privacy Policy located at		* A link to the Nielsen Digital Measurement Privacy Policy located at
	** For Danish: https://~~sites~~.nielsen.com/~~priv~~/~~browser~~/dk/da/~~DigitalMeasurement.html~~		** For Danish: https://www.nielsen.com/dk/da/legal/privacy-statement/digital-measurement/
	** For English: https://www.nielsen.com/dk/en/legal/privacy-statement/digital-measurement-privacy-statement/		** For English: https://www.nielsen.com/dk/en/legal/privacy-statement/digital-measurement-privacy-statement/

ColinBrown: /* Disclose Nielsen Privacy Statement */

2022-01-06T19:08:20Z

Disclose Nielsen Privacy Statement

← Older revision		Revision as of 19:08, 6 January 2022
Line 388:		Line 388:
	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 with anonymous data.
	* 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
			** For Danish: https://sites.nielsen.com/priv/browser/dk/da/DigitalMeasurement.html
			** For English: https://www.nielsen.com/dk/en/legal/privacy-statement/digital-measurement-privacy-statement/

	== Test your player by yourself ==		== Test your player by yourself ==

MichelFodjo at 16:18, 22 September 2021

2021-09-22T16:18:22Z

← Older revision		Revision as of 16:18, 22 September 2021
Line 153:		Line 153:
	✓		✓
	\|-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 181:		Line 181:
	stationId: "TESTXXYYSSWWLL",		stationId: "TESTXXYYSSWWLL",
	islivestn: "y",		islivestn: "y",
	~~pbstarttime~~: "1631098029"		pbstarttm: "1631098029"
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 211:		Line 211:
	✓		✓
	\|-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 229:		Line 229:
	stationId: "TESTXXYYSSWWLL",		stationId: "TESTXXYYSSWWLL",
	islivestn: "y",		islivestn: "y",
	~~pbstarttime~~: "1631098029"		pbstarttm: "1631098029"
	};		};
	</syntaxhighlight>		</syntaxhighlight>

MichelFodjo at 10:35, 15 September 2021

2021-09-15T10:35:43Z

← Older revision		Revision as of 10:35, 15 September 2021
Line 136:		Line 136:
	* "1" Linear - matches TV ad load		* "1" Linear - matches TV ad load
	* "2" Dynamic - Dynamic Ad Insertion (DAI)		* "2" Dynamic - Dynamic Ad Insertion (DAI)
			\|\|
			✓
			\|-style="background-color:#d0f6f8;"
			\|stationId \|\| Unique Gracenote Station ID generated by Nielsen that uniquely identifies a live channel
			\|\|
			provided by Nielsen
			\|\|
			✓
			\|-style="background-color:#d0f6f8;"
			\|islivestn \|\| Indicates if a stream is playing on a live channel
			\|\|
			:
			* "y" playing on a live channel
			* "n" otherwise i.e. VoD
			\|\|
			✓
			\|-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)
			\|\|
			i.e. "1631098029" for live stream and ""(empty string) for a VoD.
	\|\|		\|\|
	✓		✓
	\|-		\|-
	\| 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
			\|\|
			✓
	\|}		\|}

Line 154:		Line 178:
	isfullepisode: "y",		isfullepisode: "y",
	adloadtype: "2",		adloadtype: "2",
			subbrand: "c05",
			stationId: "TESTXXYYSSWWLL",
			islivestn: "y",
			pbstarttime: "1631098029"
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 168:		Line 196:
	\|-		\|-
	\| assetid \|\| unique ID assigned to Ad \|\| custom<br>(no [[Special Characters]]) \|\| ✓		\| assetid \|\| unique ID assigned to Ad \|\| custom<br>(no [[Special Characters]]) \|\| ✓
			\|-style="background-color:#d0f6f8;"
			\|stationId \|\| Unique Gracenote Station ID generated by Nielsen that uniquely identifies a live channel
			\|\|
			provided by Nielsen
			\|\|
			✓
			\|-style="background-color:#d0f6f8;"
			\|islivestn \|\| Indicates if a stream is playing on a live channel
			\|\|
			:
			* "y" playing on a live channel
			* "n" otherwise i.e. VoD
			\|\|
			✓
			\|-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)
			\|\|
			i.e. "1631098029" for live stream and ""(empty string) for a VoD.
			\|\|
			✓
	\|-		\|-
	\| 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 \|\| ✓
Line 176:		Line 224:
	var adMetadataObject =		var adMetadataObject =
	{		{
	type: "preroll",		type: "preroll",
	assetid: "unique_preroll_ad_id"		assetid: "unique_preroll_ad_id",
			subbrand: "c05",
			stationId: "TESTXXYYSSWWLL",
			islivestn: "y",
			pbstarttime: "1631098029"
	};		};
	</syntaxhighlight>		</syntaxhighlight>
Line 195:		Line 247:
	\|-		\|-
	\| "loadMetadata" \|\| content/ad metadata object \|\| Needs to be called at the beginning of each asset		\| "loadMetadata" \|\| content/ad metadata object \|\| Needs to be called at the beginning of each asset
	\|-		\|--style="background-color:#d0f6f8;
	\| "setPlayheadPosition" \|\| playhead position as integer<br/>		\|"setPlayheadPosition" \|\| playhead position as integer<br/>
	VOD: \|\| current position in seconds <br/>		<pre style="background-color:#d0f6f8">
	Live: ~~current~~ Unix timestamp (seconds since Jan-1-1970 UTC) <br/>		</pre>
	~~Note: "setPlayheadPosition" has to be called every second~~		* VOD: current position in seconds. Pass whole number that increments only by 1 like 0,1,2,3... <br/>
			* Live: Unix timestamp matching the broadcast time for Content and Ad (seconds since Jan-1-1970 UTC). Pass whole number that increments only by 1 like 1631098029,1631098030,1631098031,1631098032,... <br/>
	\|\|		\|\|
	Pass playhead position every second during playback		Pass playhead position every second during playback, the value passed should match the broadcast time for live channel.
	\|-		\|-
	\| "sendID3" \|\| ID3 tag payload retrieved from the stream \|\| Call when the video player has read ID3 tag in the stream		\| "sendID3" \|\| ID3 tag payload retrieved from the stream \|\| Call when the video player has read ID3 tag in the stream
Line 312:		Line 365:

	[[File:nlsn-sdk-achitecture-diagram-content-v1.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 ====

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

2021-06-04T13:21:40Z

Create Ad Metadata (optional for DR)

← Older revision		Revision as of 13:21, 4 June 2021
Line 169:		Line 169:
	\| 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 \|\| ✓
	\|}		\|}

Line 182:		Line 182:
	<br/>		<br/>
	<blockquote> URL Character Limit: There is a URL character limit of 2K characters due to browser limitations. Exceeding this value could impair data delivery on particular browsers. </blockquote>		<blockquote> URL Character Limit: There is a URL character limit of 2K characters due to browser limitations. Exceeding this value could impair data delivery on particular browsers. </blockquote>


	=== Start the Measurement ===		=== Start the Measurement ===

MichelFodjo: /* For Ad Playback */

2021-04-20T10:57:53Z

For Ad Playback

← Older revision		Revision as of 10:57, 20 April 2021
Line 315:		Line 315:

	==== 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]]

	== Review the Reference Implementation for VoD and Live Streams ==		== Review the Reference Implementation for VoD and Live Streams ==

MichelFodjo: /* For Content Playback */

2021-04-20T10:56:29Z

For Content Playback

← Older revision		Revision as of 10:56, 20 April 2021
Line 312:		Line 312:
	==== 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 ====