DCR Video & Static Cloud API - Revision history

AmySockanathan: /* Send UAID Ping */

2025-04-23T21:23:18Z

Send UAID Ping

← Older revision		Revision as of 21:23, 23 April 2025
Line 66:		Line 66:
	==== Send UAID Ping ====		==== Send UAID Ping ====
	An UAID Ping must be sent using the created unique Session ID <code>[sessionID]</code> upon start of the first stream playback.		An UAID Ping must be sent using the created unique Session ID <code>[sessionID]</code> upon start of the first stream playback.
	<~~code~~>https://[sessionID].redinuid.imrworldwide~~<nowiki/>~~.com/ </~~code~~>		<syntaxhighlight lang="javascript">https://[sessionID].redinuid.imrworldwide.com/ </syntaxhighlight>

	===Define URL Structure===		===Define URL Structure===

AmySockanathan: /* Send UAID Ping */

2025-04-23T21:20:56Z

Send UAID Ping

← Older revision		Revision as of 21:20, 23 April 2025
Line 66:		Line 66:
	==== Send UAID Ping ====		==== Send UAID Ping ====
	An UAID Ping must be sent using the created unique Session ID <code>[sessionID]</code> upon start of the first stream playback.		An UAID Ping must be sent using the created unique Session ID <code>[sessionID]</code> upon start of the first stream playback.
	https://~~[~~sessionID~~]~~.redinuid.imrworldwide<nowiki/>.com/		<code>https://[sessionID].redinuid.imrworldwide<nowiki/>.com/ </code>

	===Define URL Structure===		===Define URL Structure===

AmySockanathan: Send UAID ping documentation

2025-04-23T21:14:43Z

Send UAID ping documentation

← Older revision		Revision as of 21:14, 23 April 2025
Line 57:		Line 57:
	</syntaxhighlight>		</syntaxhighlight>

	===Create Session ID===		===Create Session ID and send UAID ping===
	A unique Session ID must be created upon app launch and provided in the URL. This will allow measurement to occur for the entire duration that a user is within the app.		A unique Session ID <code>[sessionID]</code> must be created upon app launch and provided in the URL. This will allow measurement to occur for the entire duration that a user is within the app.

	A Session ID needs to be completely unique so it is recommended to use a version 4 UUID or another method of your choosing to guarantee there are no repeats.		A Session ID needs to be completely unique so it is recommended to use a version 4 UUID or another method of your choosing to guarantee there are no repeats.

	Upon exiting the app, the session will need to be terminated using the delete event. Sessions will automatically expire after 30 minutes of cloud inactivity.		Upon exiting the app, the session will need to be terminated using the delete event. Sessions will automatically expire after 30 minutes of cloud inactivity.

			==== Send UAID Ping ====
			An UAID Ping must be sent using the created unique Session ID <code>[sessionID]</code> upon start of the first stream playback.
			https://[sessionID].redinuid.imrworldwide<nowiki/>.com/

	===Define URL Structure===		===Define URL Structure===

Admin: /* Configure Payload */

2023-05-11T16:59:07Z

Configure Payload

← Older revision		Revision as of 16:59, 11 May 2023
Line 87:		Line 87:
	payload = {		payload = {
	"devInfo": {		"devInfo": {
	"devId": "AD-ID",		"devId": "AD-ID",
			"hem_sha256": "55C06A30DAA5D5F382FDEB8C702EC57875CC9D91A7C78BB620053FD81DC4335C",
			"uid2": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=",
			"uid2_token": "7be25cf9-8c40-5cc2-871e-19bf41940288MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k=uid_token=AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8QlDSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeKQI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhCxG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&",
	"apn": "AppName",		"apn": "AppName",
	"apv": "1.0",		"apv": "1.0",

Admin: /* Configure Payload: devInfo */

2023-05-11T16:56:33Z

Configure Payload: devInfo

← Older revision		Revision as of 16:56, 11 May 2023
Line 134:		Line 134:
	\|-		\|-
	\| devId \|\| unique ID to identify user (e.g. Advertising ID, Roku Device ID) \|\| custom \|\| Yes		\| devId \|\| unique ID to identify user (e.g. Advertising ID, Roku Device ID) \|\| custom \|\| Yes
			\|-
			\| hem_sha256 \|\| SHA-256 hashed email Note: email normalization rules applied before hashing \|\| custom \|\| Yes
			\|-
			\| uid2 \|\| Trade Desk Unified ID 2.0 This should be the unencrypted, non-tokenized UID2.0 in the clear \|\| custom \|\| Yes
			\|-
			\| uid2_token \|\|Trade Desk Unified ID 2.0 UID2 token \|\| custom \|\| Yes
	\|-		\|-
	\| apn \|\| app name \|\| custom \|\| Yes		\| apn \|\| app name \|\| custom \|\| Yes
Line 148:		Line 154:
	"devInfo": {		"devInfo": {
	"devId": "AD-ID",		"devId": "AD-ID",
			"hem_sha256": "55C06A30DAA5D5F382FDEB8C702EC57875CC9D91A7C78BB620053FD81DC4335C",
			"uid2": "tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ=",
			"uid2_token": "7be25cf9-8c40-5cc2-871e-19bf41940288MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k=uid_token=AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8QlDSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeKQI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhCxG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&",
	"apn": "AppName",		"apn": "AppName",
	"apv": "1.0",		"apv": "1.0",

NickParrucci: /* Privacy Information Template To Include In Opt-Out Screen */

2023-04-04T18:58:07Z

Privacy Information Template To Include In Opt-Out Screen

← Older revision		Revision as of 18:58, 4 April 2023
Line 575:		Line 575:

	</blockquote>		</blockquote>
	~~'''''Disclosure Template'''''~~

	~~Additionally, you must update the App description information from the App Distribution Store with the Nielsen Measurement disclosure below:~~

	This app features Nielsen's proprietary measurement software which will allow you to contribute to market research, like Nielsen's TV Ratings. Please see https://www.nielsen.com/digitalprivacy for more information.

	== Testing ==		== Testing ==

NickParrucci: /* Privacy Information Template To Include In Opt-Out Screen */

2023-02-23T20:52:53Z

Privacy Information Template To Include In Opt-Out Screen

← Older revision		Revision as of 20:52, 23 February 2023
Line 579:		Line 579:
	Additionally, you must update the App description information from the App Distribution Store with the Nielsen Measurement disclosure below:		Additionally, you must update the App description information from the App Distribution Store with the Nielsen Measurement disclosure below:

	This app features Nielsen's proprietary measurement software which will allow you to contribute to market research, like Nielsen's TV Ratings. Please see ~~http~~://www.nielsen.com/digitalprivacy for more information.		This app features Nielsen's proprietary measurement software which will allow you to contribute to market research, like Nielsen's TV Ratings. Please see https://www.nielsen.com/digitalprivacy for more information.

	== Testing ==		== Testing ==

NickParrucci: /* Privacy Information Template To Include In Opt-Out Screen */

2023-02-23T20:52:22Z

Privacy Information Template To Include In Opt-Out Screen

← Older revision		Revision as of 20:52, 23 February 2023
Line 572:		Line 572:
	'''''YOUR CHOICES'''''		'''''YOUR CHOICES'''''

	Nielsen believes that you should have a choice about whether to contribute to our research and insights. To opt out or opt in to Nielsen measurement, please toggle your "Limit Ad Tracking" (or similar setting) on your device, or make the appropriate selection within the application's settings. If you have this app on more than one device, you will need to opt out of this app on each device. To learn more about our digital measurement products and your choices in regard to them, please visit ~~http~~://www.nielsen.com/digitalprivacy.		Nielsen believes that you should have a choice about whether to contribute to our research and insights. To opt out or opt in to Nielsen measurement, please toggle your "Limit Ad Tracking" (or similar setting) on your device, or make the appropriate selection within the application's settings. If you have this app on more than one device, you will need to opt out of this app on each device. To learn more about our digital measurement products and your choices in regard to them, please visit https://www.nielsen.com/digitalprivacy.

	</blockquote>		</blockquote>

Admin at 20:20, 26 August 2022

2022-08-26T20:20:18Z

← Older revision		Revision as of 20:20, 26 August 2022
Line 33:		Line 33:
	There are endpoints for testing and production:		There are endpoints for testing and production:

	*Testing: <code>https://~~sandbox~~-cloudapi.imrworldwide.com/nmapi/v2/</code>		*Testing: <code>https://sandbox2-cloudapi.imrworldwide.com/nmapi/v2/</code>
	*Production: <code>https://cloudapi.imrworldwide.com/nmapi/v2/</code>		*Production: <code>https://cloudapi.imrworldwide.com/nmapi/v2/</code>

Line 42:		Line 42:

	<syntaxhighlight lang="javascript">		<syntaxhighlight lang="javascript">
	https://~~sandbox~~-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=		https://sandbox2-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=
	{		{
	"devInfo": [deviceInfo],		"devInfo": [deviceInfo],
Line 67:		Line 67:
	Define the URL structure using your provided <code>[appid]</code> and a unique <code>[sessionID]</code>.		Define the URL structure using your provided <code>[appid]</code> and a unique <code>[sessionID]</code>.

	<syntaxhighlight lang="javascript">https://~~sandbox~~-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=[payload]</syntaxhighlight>		<syntaxhighlight lang="javascript">https://sandbox2-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=[payload]</syntaxhighlight>

	===Configure Payload===		===Configure Payload===
Line 422:		Line 422:

	// 2. Define URL Structure with App ID and Session ID		// 2. Define URL Structure with App ID and Session ID
	sessionURL = https://~~sandbox~~-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=		sessionURL = https://sandbox2-cloudapi.imrworldwide.com/nmapi/v2/[appid]/[sessionID]/a?b=

	// 3. Configure Payload		// 3. Configure Payload
Line 629:		Line 629:
	'''Change Endpoint:''' You will need to update to the production endpoint:		'''Change Endpoint:''' You will need to update to the production endpoint:

	*Testing: <code>https://~~sandbox~~-cloudapi.imrworldwide.com/nmapi/v2/</code>		*Testing: <code>https://sandbox2-cloudapi.imrworldwide.com/nmapi/v2/</code>
	*Production: <code>https://cloudapi.imrworldwide.com/nmapi/v2/</code>		*Production: <code>https://cloudapi.imrworldwide.com/nmapi/v2/</code>

LaMarHolmes: /* Example Request */

2021-12-10T18:05:21Z

Example Request

← Older revision		Revision as of 18:05, 10 December 2021
Line 473:		Line 473:
	(new Image).src = sessionURL+encodeURIComponent(JSON.stringify(payload));		(new Image).src = sessionURL+encodeURIComponent(JSON.stringify(payload));
	</syntaxhighlight>		</syntaxhighlight>

			To ensure that the GET request does not receive a CORS issue, make sure to use the IMAGE request in conjunction with the content-type "text/plain" so CORS preflight is not triggered, causing the request to be rejected.

	==== Enable Debug Logging ====		==== Enable Debug Logging ====