Engineering Client Portal - User contributions [en]

SDK Integration Assistance & Diagnostic Tool (IADT)

2026-06-09T20:35:48Z

AmySockanathan: Initial changes to the SDK IADT page

== {{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}} ==

== SDK Integration Assistance & Diagnostic Tool ==
The SDK Integration Assistance & Diagnostic Tool (IADT) is a step-by-step integration wizard and an integration validation tool. This tool support DCR static, DCR video and DTVR products. It can be used for integration of apps on Android and iOS platforms and web pages on browsers.

After you have read and agreed to the Nielsen SDK license agreement, you can download the tool from [https://github.com/NielsenDigitalSDK/sdk-diagnostic-tool?tab=readme-ov-file here].
[[Category:Digital]]

SDK Integration Assistance & Diagnostic Tool (IADT)

2026-06-09T20:26:59Z

AmySockanathan: Create the page for the SDK Integration Assistance & Diagnostic Tool

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
SDK Integration Assistance & Diagnostic Tool

US DCR & DTVR

2026-06-09T20:24:14Z

AmySockanathan:

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
{{CategoryIcon|DCR.png|US Digital Content Ratings (DCR) & Digital in TV Ratings (DTVR)}}

__NOTOC__

{| class="wikitable"
! colspan="3"| Start Here
|-
| rowspan="7" | {{SmallIcon|thePlatformIcon.png}}
| '''Step-By-Step SDK Integration Guides ([[BSDK Step By Step|Browser]], [[Android Step By Step|Android]], [[iOS Step By Step|iOS]])'''
| '''API Reference Tables ([[Browser_SDK_API_Table|Browser]], [[Android_SDK_API_Table|Android]], [[iOS_SDK_API_Table|iOS]])'''
|-
| '''[[DCR_vs_DTVR|DCR vs. DTVR Implementation - Key Differences]]'''
| '''Product Information - [https://markets.nielsen.com/us/en/solutions/capabilities/digital-content-ratings/ DCR], [https://www.nielsen.com/solutions/audience-measurement/national-tv/ DTVR]'''
|}

{| class="wikitable"
! colspan="3"| General Reference
|-
| '''[[Digital Measurement Onboarding]]'''
| '''[[Digital Measurement Metadata]]'''
| '''[[Digital Measurement Testing]]'''
|-
| '''[[Digital Measurement Interruption Scenarios]]'''
| '''[[Digital Measurement FAQ]]'''
| '''SDK Release Notes - [[Browser_SDK_Release_Notes|Browser]], [[Android_SDK_Release_Notes|Android]], [[iOS_SDK_Release_Notes|iOS]], [[TVOS_SDK_Release_Notes|TVOS]], [[DOMless SDK Release Notes|Domless]]'''
|-
| '''[[Digital Pre-Certification Checklist App SDK]]'''
| '''[[Digital Pre-Certification Checklist Browser SDK]]'''
| '''[[Digital Measurement Persistent Identifiers]]'''
|-
|[[Dual Instances of SDK|'''Dual Instances of SDK''']]
|'''[[SDK Integration Assistance & Diagnostic Tool (IADT)]]'''
|
|}

== SEI ==
{| class="wikitable"
| colspan="3" |Single Endpoint Integration (SEI) - log-file based data transaction mechanism
|-
!Type
!
!Implementation Guide
|-
| rowspan="5" |{{SmallIcon|DigitalIcon.png}}
|-
| rowspan="5" |{{OSIcon|VideoIcon.png|alt=Video}}
|'''[[Digital Measurement SEI Streaming Content Viewing]]'''
|-
|'''[[Digital Measurement Content Asset Metadata]]'''
|-
|'''[[Digital Measurement Content Audit Beacon]]'''
|-
|'''[[Digital Measurement SEI Audio File]](Only for DTVR)'''
|}

== SDK - Video ==
{| class="wikitable"
| colspan="6" | Maintaining an existing ''DCR'' or ''DTVR'' App integration? Continue to reference the API you're already using with the guides below.
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 30%;" | DCR Implementation Guide
! style="width: 25%;" | DTVR Implementation Guide
!| SDK Documentation
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Video iOS SDK]]'''
| '''[[DTVR iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Video Android SDK]]'''
| '''[[DTVR Android SDK]]'''
| [[Android SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Browser SDK]]'''
| '''[[DTVR Browser SDK]]'''
| [[Browser SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Domless SDK]]'''
| '''[[DTVR Domless SDK]]'''
| [[Domless SDK API Reference]]
|}

== SDK - Static ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 55%;" | DCR Implementation Guide
!| SDK Documentation
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
| rowspan="9" | {{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Static iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Static Android SDK]]'''
| [[Android SDK API Reference]]
|-
| rowspan="2" | {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Static Browser SDK]]'''
| rowspan="5" | [[Browser SDK API Reference]]
|-
| '''[[DCR Static Lite Browser SDK]]'''
|-
| {{OSIcon|GoogleTagManagerIcon.png|alt=Google Tag Manager}}
| '''[[DCR Static Google Tag Manager]]'''
|-
| {{OSIcon|FacebookIcon.png|alt=Facebook Instant Articles}}
| '''[[DCR Static Facebook Instant Articles Browser SDK]]'''
|-
| {{OSIcon|Tealium_Icon.png|alt=Tealium}}
| '''[[DCR Static Tealium]]'''
|-
| {{OSIcon|AMPIcon.png|alt=Google AMP}}
| '''[[DCR Static Google AMP Cloud API]]'''
|
|-
|{{OSIcon|BrowserIcon.png|alt=Browser}}
|'''[[DCR Static Domless SDK]]'''
|[[Domless SDK API Reference]]
|}

== Xamarin ==
{| class="wikitable"
| colspan="6" | Xamarin Integration Guides (Xamarin support is part of [[Special:Downloads|Nielsen's AppSDK V8]] and above.)
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|APIIcon.png|alt=Xamarin}}
| colspan="2" | '''[[DCR_%26_DTVR_Xamarin_Integration|DCR & DTVR Xamarin Integration]]'''
|}

== Cloud API ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| DCR Implementation Guide
|-
| rowspan="3" | {{SmallIcon|CloudAPIIcon.png|alt=Cloud API}}
| rowspan="3" |
{{OSIcon|VideoIcon.png|alt=Video}}
 
{{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Cloud API ]]'''
|-
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Mobile Cloud API ]]'''
|-
| {{OSIcon|RokuIcon.png|alt=Roku}}
| '''[[DCR Video & Static Roku Cloud API]]'''
|}

== Adobe Launch Extensions ==
{| class="wikitable"
| colspan="6" | Leverage Launch by Adobe? The guides below describe how to integrate DCR and DTVR with Nielsen's Adobe Launch extension
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
|
|
| colspan="2" | '''[[Digital Measurement Onboarding Adobe ]]'''
|-
| rowspan="3" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR & DTVR iOS Adobe Launch Extension]]'''
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR & DTVR Android Adobe Launch Extension]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR & DTVR Browser Adobe Launch Extension]]'''
|}

== SmartTV Integrations ==
{| class="wikitable"
| colspan="6" | The guides below describe how to integrate DCR and DTVR with Smart tv's
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! | Implementation Guide
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[TizenTv]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[webOS]]'''
|
|-
|{{OSIcon|AndroidIcon.png|alt=Android}}
|'''[[AndroidTV]]'''
|
|}

US DCR & DTVR

2026-06-09T20:23:08Z

AmySockanathan: Add SDK Integration Assistance & Diagnostic Tool

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
{{CategoryIcon|DCR.png|US Digital Content Ratings (DCR) & Digital in TV Ratings (DTVR)}}

__NOTOC__

{| class="wikitable"
! colspan="3"| Start Here
|-
| rowspan="7" | {{SmallIcon|thePlatformIcon.png}}
| '''Step-By-Step SDK Integration Guides ([[BSDK Step By Step|Browser]], [[Android Step By Step|Android]], [[iOS Step By Step|iOS]])'''
| '''API Reference Tables ([[Browser_SDK_API_Table|Browser]], [[Android_SDK_API_Table|Android]], [[iOS_SDK_API_Table|iOS]])'''
|-
| '''[[DCR_vs_DTVR|DCR vs. DTVR Implementation - Key Differences]]'''
| '''Product Information - [https://markets.nielsen.com/us/en/solutions/capabilities/digital-content-ratings/ DCR], [https://www.nielsen.com/solutions/audience-measurement/national-tv/ DTVR]'''
|}

{| class="wikitable"
! colspan="3"| General Reference
|-
| '''[[Digital Measurement Onboarding]]'''
| '''[[Digital Measurement Metadata]]'''
| '''[[Digital Measurement Testing]]'''
|-
| '''[[Digital Measurement Interruption Scenarios]]'''
| '''[[Digital Measurement FAQ]]'''
| '''SDK Release Notes - [[Browser_SDK_Release_Notes|Browser]], [[Android_SDK_Release_Notes|Android]], [[iOS_SDK_Release_Notes|iOS]], [[TVOS_SDK_Release_Notes|TVOS]], [[DOMless SDK Release Notes|Domless]]'''
|-
| '''[[Digital Pre-Certification Checklist App SDK]]'''
| '''[[Digital Pre-Certification Checklist Browser SDK]]'''
| '''[[Digital Measurement Persistent Identifiers]]'''
|-
|[[Dual Instances of SDK|'''Dual Instances of SDK''']]
|'''SDK Integration Assistance & Diagnostic Tool (IADT)'''
|
|}

== SEI ==
{| class="wikitable"
| colspan="3" |Single Endpoint Integration (SEI) - log-file based data transaction mechanism
|-
!Type
!
!Implementation Guide
|-
| rowspan="5" |{{SmallIcon|DigitalIcon.png}}
|-
| rowspan="5" |{{OSIcon|VideoIcon.png|alt=Video}}
|'''[[Digital Measurement SEI Streaming Content Viewing]]'''
|-
|'''[[Digital Measurement Content Asset Metadata]]'''
|-
|'''[[Digital Measurement Content Audit Beacon]]'''
|-
|'''[[Digital Measurement SEI Audio File]](Only for DTVR)'''
|}

== SDK - Video ==
{| class="wikitable"
| colspan="6" | Maintaining an existing ''DCR'' or ''DTVR'' App integration? Continue to reference the API you're already using with the guides below.
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 30%;" | DCR Implementation Guide
! style="width: 25%;" | DTVR Implementation Guide
!| SDK Documentation
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Video iOS SDK]]'''
| '''[[DTVR iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Video Android SDK]]'''
| '''[[DTVR Android SDK]]'''
| [[Android SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Browser SDK]]'''
| '''[[DTVR Browser SDK]]'''
| [[Browser SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Domless SDK]]'''
| '''[[DTVR Domless SDK]]'''
| [[Domless SDK API Reference]]
|}

== SDK - Static ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 55%;" | DCR Implementation Guide
!| SDK Documentation
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
| rowspan="9" | {{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Static iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Static Android SDK]]'''
| [[Android SDK API Reference]]
|-
| rowspan="2" | {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Static Browser SDK]]'''
| rowspan="5" | [[Browser SDK API Reference]]
|-
| '''[[DCR Static Lite Browser SDK]]'''
|-
| {{OSIcon|GoogleTagManagerIcon.png|alt=Google Tag Manager}}
| '''[[DCR Static Google Tag Manager]]'''
|-
| {{OSIcon|FacebookIcon.png|alt=Facebook Instant Articles}}
| '''[[DCR Static Facebook Instant Articles Browser SDK]]'''
|-
| {{OSIcon|Tealium_Icon.png|alt=Tealium}}
| '''[[DCR Static Tealium]]'''
|-
| {{OSIcon|AMPIcon.png|alt=Google AMP}}
| '''[[DCR Static Google AMP Cloud API]]'''
|
|-
|{{OSIcon|BrowserIcon.png|alt=Browser}}
|'''[[DCR Static Domless SDK]]'''
|[[Domless SDK API Reference]]
|}

== Xamarin ==
{| class="wikitable"
| colspan="6" | Xamarin Integration Guides (Xamarin support is part of [[Special:Downloads|Nielsen's AppSDK V8]] and above.)
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|APIIcon.png|alt=Xamarin}}
| colspan="2" | '''[[DCR_%26_DTVR_Xamarin_Integration|DCR & DTVR Xamarin Integration]]'''
|}

== Cloud API ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| DCR Implementation Guide
|-
| rowspan="3" | {{SmallIcon|CloudAPIIcon.png|alt=Cloud API}}
| rowspan="3" |
{{OSIcon|VideoIcon.png|alt=Video}}
 
{{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Cloud API ]]'''
|-
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Mobile Cloud API ]]'''
|-
| {{OSIcon|RokuIcon.png|alt=Roku}}
| '''[[DCR Video & Static Roku Cloud API]]'''
|}

== Adobe Launch Extensions ==
{| class="wikitable"
| colspan="6" | Leverage Launch by Adobe? The guides below describe how to integrate DCR and DTVR with Nielsen's Adobe Launch extension
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
|
|
| colspan="2" | '''[[Digital Measurement Onboarding Adobe ]]'''
|-
| rowspan="3" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR & DTVR iOS Adobe Launch Extension]]'''
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR & DTVR Android Adobe Launch Extension]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR & DTVR Browser Adobe Launch Extension]]'''
|}

== SmartTV Integrations ==
{| class="wikitable"
| colspan="6" | The guides below describe how to integrate DCR and DTVR with Smart tv's
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! | Implementation Guide
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[TizenTv]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[webOS]]'''
|
|-
|{{OSIcon|AndroidIcon.png|alt=Android}}
|'''[[AndroidTV]]'''
|
|}

Dual Instances of SDK

2026-06-09T20:20:06Z

AmySockanathan: Align the multiple instance page content with Production.

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

== Multiple SDK Instances ==

=== SDK Initialization ===

==== App SDK ====
The latest version of the Nielsen App SDK allows instantiating multiple instances of the SDK object, which can be used simultaneously without any issue. The sharedInstance API that creates a singleton object was deprecated prior to version 5.1.1. (Version 4.0 for Android)

A maximum of four SDK instances per appid are supported.
When four SDK instances exist, you must destroy an old instance before creating a new one.

==== Browser SDK ====
The Browser SDK allows instantiating multiple instances of the object, which can be used simultaneously without any problems, however they must be instantiated with their own unique instance names. There is no maximum number of instances that is enforced in the browser.

=== App SDK Examples ===

==== Example using Swift ====
 In this example we create a swift file called NielsenInit where I store our SDK Initialization code. The example uses 2 APPIDS to keep everything organized.

<syntaxhighlight lang="swift">
self.nielsenStaticApi = NielsenInit.createStaticNielsenApi(delegate: self)
self.nielsenApi = NielsenInit.createNielsenApi(delegate: self)
</syntaxhighlight>
 Here are the methods in the NielsenInit class.

<syntaxhighlight lang="swift">
class NielsenInit : NSObject {

class func createNielsenApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{
let appInformation:[String: String] = [

"appid": "PDA7D5EE6-B1B8-4123-9277-2A788BC65XXX",
"appname": "Standard SDK Swift Sample",
"appversion": "1.0",
"sfcode": "dcr",
"nol_devDebug": "INFO"
]
return NielsenAppApi(appInfo:appInformation, delegate:delegate)
}

class func createStaticNielsenApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{

let appInformation:[String: String] = [

"appid": "PE4A57F64-878D-4D69-8EFB-4E87C27BXXXX",
"appname": "Standard SDK Swift Sample",
"appversion": "1.0",
"sfcode": "dcr",
"nol_devDebug": "INFO"
]
return NielsenAppApi(appInfo:appInformation, delegate:delegate)
}
}
</syntaxhighlight>
 We then load up the Static and Content metadata in our sample:

<syntaxhighlight lang="swift">
func loadStatic() -> [String : Any] {
//Loading Static data
let staticData =
[
"type": "static",
"section": "siteSection",
"segA": "segmentA",
"segB": "segmentB",
"segC": "segmentC"
]
return staticData
}

func loadContent() -> [String : Any] {
//Loading Content data
url = NSURL(string: "http://www.nielseninternet.com/NielsenConsumer/prog_index.m3u8")
let content = [
"type":"content",
"assetid":"C77664",
"length":"3600",
"program":"MyProgram",
"segB":"CustomSegmentValueB",
"segC":"segmentC",
"title":"S2,E3",
"section":"cloudApi_app",
"airdate":"20180221 10:00:00",
"isfullepisode":"y",
"adloadtype":"2",
"channelName":"My Channel 1",
"pipMode":"false" ] as [String : Any]

return content
}
</syntaxhighlight>

 In AppDelegate, we initialize the 1st instance of the SDK for Static Measurement when the App launches.
 
<syntaxhighlight lang="swift">
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
// Override point for customization after application launch.

//Getting the instance of NielsenApi
self.nielsenStaticApi = NielsenInit.createStaticNielsenApi(delegate: self)
sdkMethods = SDKMethods()
self.data = sdkMethods.loadStatic()
self.nielsenStaticApi.loadMetadata(self.data)
return true
}
</syntaxhighlight>
 Now for the Player Instance, we initialize in the ViewController, but only after the View has loaded: 
<syntaxhighlight lang="swift">
override func viewDidLoad() {
super.viewDidLoad()
self.view.backgroundColor = UIColor(patternImage: UIImage(named: "new_ios_bg.png")!)
//In NielsenInit class we are initialising the NielsenApi.

//Getting the instance of NielsenApi
self.nielsencontentApi = NielsenInit.createNielsenApi(delegate: self)
</syntaxhighlight>

Now you can just call them separately:

For example, App goes into the background:
<syntaxhighlight lang="swift">
func applicationDidEnterBackground(_ application: UIApplication) {

// Use this method to release shared resources, save user data, invalidate timers, and store enough application state information to restore your application to its current state in case it is terminated later.

// If your application supports background execution, this method is called instead of applicationWillTerminate: when the user quits.
self.nielsenStaticApi.loadMetadata(self.data)
}
</syntaxhighlight>
 Or sending the playhead position to the second instance: 
<syntaxhighlight lang="swift">
nielsencontentApi.play(sdkMethods.loadChannelInfo())
self.nielsencontentApi?.playheadPosition(pos);
</syntaxhighlight>

==== Example using Android Studio ====
[https://engineeringportal.nielsen.com/w/downloads/digital/sampleapplications/SimplePlayerStandardWithStaticAndroidSDK.zip Download Project Files] The below is an example of Initializing two instances of the Nielsen SDK. One for Static Measurement, and the other for Video Measurement.
 

<syntaxhighlight lang=java>
public class NielsenInit {

private AppSdk mAppSdk = null;
private AppSdk mStaticAppSdk = null;

public AppSdk initAppSdk(Context mContext, IAppNotifier appNotifier){
try {
//Initialising the NielsenAppSDK class by passing app information which returns the instance of AppSdk.

JSONObject appInformation = new JSONObject()

.put("appid", "PDA7D5EE6-B1B8-4123-9277-2A788BC65XXX")
.put("appversion", "1.0")
.put("sfcode", "dcr")
.put("nol_devDebug", "INFO");

mAppSdk = new AppSdk(mContext, appInformation, appNotifier);
} catch (JSONException e) {
e.printStackTrace();
}
return mAppSdk;
}

public AppSdk initStaticAppSdk(Context mContext, IAppNotifier appNotifier){
try {
//Initialising the NielsenAppSDK class by passing app information which returns the instance of AppSdk.

JSONObject appInformation = new JSONObject()

.put("appid", "PE4A57F64-878D-4D69-8EFB-4E87C27BAXXX")
.put("appversion", "1.0")
.put("sfcode", "dcr")
.put("nol_devDebug", "INFO");

mStaticAppSdk = new AppSdk(mContext, appInformation, appNotifier);
} catch (JSONException e) {
e.printStackTrace();
}
return mStaticAppSdk;
}
}
</syntaxhighlight>
 
<syntaxhighlight lang=java>
NielsenInit nielsenInit = new NielsenInit();

//3rd parameter "this" referes to IAppNotifier interface which is needed to initialise NielsenSDK.
staticAppSdk = nielsenInit.initStaticAppSdk(MyApplication.getContext(), this);
data = sdkMethods.loadStaticData();

if(this.b == 0) {
AppLaunchMeasurementManager.appInBackground(app.getApplicationContext());
staticAppSdk.loadMetadata(data);
Log.d("SdkBgFgDetectionUtility", "App going to background");
}

</syntaxhighlight>
 
<syntaxhighlight lang=java>
//Getting the instance of NielsenSDK.
NielsenInit nielsenInit = new NielsenInit();

//3rd parameter "this" referes to IAppNotifier interface which is needed to initialise NielsenSDK.
appSdk = nielsenInit.initAppSdk(getApplicationContext(), this);

</syntaxhighlight>

=== Browser SDK Examples ===
The below examples will make use of the same AppId, however using different AppIds will work as well. The principles below follow the same initialization rules as a single instance and simply require a unique instance name and variable name with which the returned instance is assigned.

For more information around the possible parameters that can be passed as well as deeper descriptions for the API calls, please refer to our API documentation here: [[Browser SDK API Reference]]

==== Example of 2 instances on the same page ====
<syntaxhighlight lang="javascript">
//Add Static Queue Snippet
<script>
!function (e, n) {
function t(e) {
return "object" == typeof e ? JSON.parse(JSON.stringify(e)) : e
}
e[n] = e[n] ||
{
nlsQ: function (o, r, c) {
var s = e.document,
a = s.createElement("script");
a.async = 1,
a.src = ("http:" === e.location.protocol ? "http:" : "https:") + "//cdn-gl.imrworldwide.com/conf/" + o + ".js#name=" + r + "&ns=" + n;
var i = s.getElementsByTagName("script")[0];
return i.parentNode.insertBefore(a, i),
e[n][r] = e[n][r] || {
g: c || {},
ggPM: function (o, c, s, a, i) { e[n][r].q = e[n][r].q || []; try { var l = t([o, c, s, a, i]); e[n][r].q.push(l) } catch (e) { console && console.log && console.log("Error: Cannot register event in Nielsen SDK queue.") } },
trackEvent: function (o) { e[n][r].te = e[n][r].te || []; try { var c = t(o); e[n][r].te.push(c) } catch (e) { console && console.log && console.log("Error: Cannot register event in Nielsen SDK queue.") } }
},
e[n][r]
}
}
}(window, "NOLBUNDLE");

//Create SDK Instance(s)
// Notice the unique instance name given to each instance below and the unique variable name for each instance
var nSdkInstanceLive = NOLBUNDLE.nlsQ("XXXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX", "instanceLive", {
nol_sdkDebug: 'debug',
optout: 'false'
});

var nSdkInstanceVod = NOLBUNDLE.nlsQ("XXXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX", "instanceVod", {
nol_sdkDebug: 'debug',
optout: 'false'
});

</script>
</syntaxhighlight>

==== Example of 2 instances using a parent page and iFrame ====

===== Parent Page (index.html) =====
<syntaxhighlight lang="html">
<!DOCTYPE html>
<html lang="en">

<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<meta http-equiv="X-UA-Compatible" content="ie=edge">
<title>DCR Static/DCR Video</title>
<script>
/* NLSQUEUE build v*/
!function(e,n){
function t(e){
return"object"==typeof e?JSON.parse(JSON.stringify(e)):e
}
e[n]=e[n]||
{
nlsQ:function(o,r,c){
var s=e.document,
a=s.createElement("script");
a.async=1,
a.src=("http:"===e.location.protocol?"http:":"https:")+"//cdn-gl.imrworldwide.com/conf/"+o+".js#name="+r+"&ns="+n;
var i=s.getElementsByTagName("script")[0];
return i.parentNode.insertBefore(a,i),
e[n][r]=e[n][r]||{g:c||{},
ggPM:function(o,c,s,a,i){e[n][r].q=e[n][r].q||[];try{var l=t([o,c,s,a,i]);e[n][r].q.push(l)}catch(e){console&&console.log&&console.log("Error: Cannot register event in Nielsen SDK queue.")}},
trackEvent:function(o){e[n][r].te=e[n][r].te||[];try{var c=t(o);e[n][r].te.push(c)}catch(e){console&&console.log&&console.log("Error: Cannot register event in Nielsen SDK queue.")}}},
e[n][r]
}
}
}(window,"NOLBUNDLE");

// SDK Initialization
var nSdkInstance = NOLBUNDLE.nlsQ("XXXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX", "staticPage", {
nol_sdkDebug: 'debug',
});

// Static Metadata
var staticMetadata = {
assetid: 'staticTestPage',
type: 'static'
};

// Event 'staticstart' call
nSdkInstance.ggPM(14, staticMetadata);
</script>
</head>

<body>
<h1>DCR Static on Parent/DCR Video in iFrame</h1>
Static measurement is current on parent page when window is in focus
<iframe src="./dcr-video.html" frameborder="0" width="650" height="500" style="background-color: rgb(42, 217, 248);" id="video-iframe"></iframe>
</body>

</html>
</syntaxhighlight>

===== Nested iFrame Referenced on Parent Page (dcr-video.html) =====
<syntaxhighlight lang="html">
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta http-equiv="X-UA-Compatible" content="ie=edge" />
<title>iFrame Same Source</title>
<script>
/* NLSQUEUE build v*/
!function(e,n){
function t(e){
return"object"==typeof e?JSON.parse(JSON.stringify(e)):e
}
e[n]=e[n]||
{
nlsQ:function(o,r,c){
var s=e.document,
a=s.createElement("script");
a.async=1,
a.src=("http:"===e.location.protocol?"http:":"https:")+"//cdn-gl.imrworldwide.com/conf/"+o+".js#name="+r+"&ns="+n;
var i=s.getElementsByTagName("script")[0];
return i.parentNode.insertBefore(a,i),
e[n][r]=e[n][r]||{g:c||{},
ggPM:function(o,c,s,a,i){e[n][r].q=e[n][r].q||[];try{var l=t([o,c,s,a,i]);e[n][r].q.push(l)}catch(e){console&&console.log&&console.log("Error: Cannot register event in Nielsen SDK queue.")}},
trackEvent:function(o){e[n][r].te=e[n][r].te||[];try{var c=t(o);e[n][r].te.push(c)}catch(e){console&&console.log&&console.log("Error: Cannot register event in Nielsen SDK queue.")}}},
e[n][r]
}
}
}(window,"NOLBUNDLE");

// SDK Initialization
var nSdkInstance = NOLBUNDLE.nlsQ("XXXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX", "videoPlayer", {
nol_sdkDebug: 'debug',
});

var contentMetadata = {
type: "content",
length: "300",
title: "Skydiving Across Europe",
program: "latacg",
censuscategory: "Enlisted",
assetid: "204558915992",
section: "ProgramAsset8",
tv: "true",
adModel: "0",
dataSrc: "cms",
segA: "S07E04:NBC",
segB: "teams",
segC:"AtlanataFalcons",
}
</script>
</head>
<body>
I'm iframe SDK DCR Video measurement, DCR static measurement should continue when clicking "play" on video
<main>
<video
controls
src="https://archive.org/download/BigBuckBunny_124/Content/big_buck_bunny_720p_surround.mp4"
poster="https://peach.blender.org/wp-content/uploads/title_anouncement.jpg?x11217"
width="620">
Sorry, your browser doesn't support embedded videos, but don't worry, you can
<a href="https://archive.org/details/BigBuckBunny_124">download it</a>
and watch it with your favorite video player!
</video>
</main>
<script src="../player.js"></script>
</body>
</html>
</syntaxhighlight>

US DCR & DTVR

2026-06-09T19:46:42Z

AmySockanathan: Align the staging documentation with production

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
{{CategoryIcon|DCR.png|US Digital Content Ratings (DCR) & Digital in TV Ratings (DTVR)}}

__NOTOC__

{| class="wikitable"
! colspan="3"| Start Here
|-
| rowspan="7" | {{SmallIcon|thePlatformIcon.png}}
| '''Step-By-Step SDK Integration Guides ([[BSDK Step By Step|Browser]], [[Android Step By Step|Android]], [[iOS Step By Step|iOS]])'''
| '''API Reference Tables ([[Browser_SDK_API_Table|Browser]], [[Android_SDK_API_Table|Android]], [[iOS_SDK_API_Table|iOS]])'''
|-
| '''[[DCR_vs_DTVR|DCR vs. DTVR Implementation - Key Differences]]'''
| '''Product Information - [https://markets.nielsen.com/us/en/solutions/capabilities/digital-content-ratings/ DCR], [https://www.nielsen.com/solutions/audience-measurement/national-tv/ DTVR]'''
|}

{| class="wikitable"
! colspan="3"| General Reference
|-
| '''[[Digital Measurement Onboarding]]'''
| '''[[Digital Measurement Metadata]]'''
| '''[[Digital Measurement Testing]]'''
|-
| '''[[Digital Measurement Interruption Scenarios]]'''
| '''[[Digital Measurement FAQ]]'''
| '''SDK Release Notes - [[Browser_SDK_Release_Notes|Browser]], [[Android_SDK_Release_Notes|Android]], [[iOS_SDK_Release_Notes|iOS]], [[TVOS_SDK_Release_Notes|TVOS]], [[DOMless SDK Release Notes|Domless]]'''
|-
| '''[[Digital Pre-Certification Checklist App SDK]]'''
| '''[[Digital Pre-Certification Checklist Browser SDK]]'''
| '''[[Digital Measurement Persistent Identifiers]]'''
|-
|[[Dual Instances of SDK|'''Dual Instances of SDK''']]
|
|
|}

== SEI ==
{| class="wikitable"
| colspan="3" |Single Endpoint Integration (SEI) - log-file based data transaction mechanism
|-
!Type
!
!Implementation Guide
|-
| rowspan="5" |{{SmallIcon|DigitalIcon.png}}
|-
| rowspan="5" |{{OSIcon|VideoIcon.png|alt=Video}}
|'''[[Digital Measurement SEI Streaming Content Viewing]]'''
|-
|'''[[Digital Measurement Content Asset Metadata]]'''
|-
|'''[[Digital Measurement Content Audit Beacon]]'''
|-
|'''[[Digital Measurement SEI Audio File]](Only for DTVR)'''
|}

== SDK - Video ==
{| class="wikitable"
| colspan="6" | Maintaining an existing ''DCR'' or ''DTVR'' App integration? Continue to reference the API you're already using with the guides below.
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 30%;" | DCR Implementation Guide
! style="width: 25%;" | DTVR Implementation Guide
!| SDK Documentation
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Video iOS SDK]]'''
| '''[[DTVR iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Video Android SDK]]'''
| '''[[DTVR Android SDK]]'''
| [[Android SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Browser SDK]]'''
| '''[[DTVR Browser SDK]]'''
| [[Browser SDK API Reference]]
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Video Domless SDK]]'''
| '''[[DTVR Domless SDK]]'''
| [[Domless SDK API Reference]]
|}

== SDK - Static ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! style="width: 55%;" | DCR Implementation Guide
!| SDK Documentation
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
| rowspan="9" | {{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR Static iOS SDK]]'''
| [[iOS SDK API Reference]]
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR Static Android SDK]]'''
| [[Android SDK API Reference]]
|-
| rowspan="2" | {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR Static Browser SDK]]'''
| rowspan="5" | [[Browser SDK API Reference]]
|-
| '''[[DCR Static Lite Browser SDK]]'''
|-
| {{OSIcon|GoogleTagManagerIcon.png|alt=Google Tag Manager}}
| '''[[DCR Static Google Tag Manager]]'''
|-
| {{OSIcon|FacebookIcon.png|alt=Facebook Instant Articles}}
| '''[[DCR Static Facebook Instant Articles Browser SDK]]'''
|-
| {{OSIcon|Tealium_Icon.png|alt=Tealium}}
| '''[[DCR Static Tealium]]'''
|-
| {{OSIcon|AMPIcon.png|alt=Google AMP}}
| '''[[DCR Static Google AMP Cloud API]]'''
|
|-
|{{OSIcon|BrowserIcon.png|alt=Browser}}
|'''[[DCR Static Domless SDK]]'''
|[[Domless SDK API Reference]]
|}

== Xamarin ==
{| class="wikitable"
| colspan="6" | Xamarin Integration Guides (Xamarin support is part of [[Special:Downloads|Nielsen's AppSDK V8]] and above.)
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|APIIcon.png|alt=Xamarin}}
| colspan="2" | '''[[DCR_%26_DTVR_Xamarin_Integration|DCR & DTVR Xamarin Integration]]'''
|}

== Cloud API ==
{| class="wikitable"
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| DCR Implementation Guide
|-
| rowspan="3" | {{SmallIcon|CloudAPIIcon.png|alt=Cloud API}}
| rowspan="3" |
{{OSIcon|VideoIcon.png|alt=Video}}
 
{{OSIcon|StaticIcon.png|alt=Static Content}}
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Cloud API ]]'''
|-
| {{OSIcon|APIIcon.png|alt=Cloud API}}
| '''[[DCR Video & Static Mobile Cloud API ]]'''
|-
| {{OSIcon|RokuIcon.png|alt=Roku}}
| '''[[DCR Video & Static Roku Cloud API]]'''
|}

== Adobe Launch Extensions ==
{| class="wikitable"
| colspan="6" | Leverage Launch by Adobe? The guides below describe how to integrate DCR and DTVR with Nielsen's Adobe Launch extension
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
!| Implementation Guide
|-
| rowspan="8" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
|
|
| colspan="2" | '''[[Digital Measurement Onboarding Adobe ]]'''
|-
| rowspan="3" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|macOSIcon.png|alt=iOS}}
| '''[[DCR & DTVR iOS Adobe Launch Extension]]'''
|-
| {{OSIcon|AndroidIcon.png|alt=Android}}
| '''[[DCR & DTVR Android Adobe Launch Extension]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[DCR & DTVR Browser Adobe Launch Extension]]'''
|}

== SmartTV Integrations ==
{| class="wikitable"
| colspan="6" | The guides below describe how to integrate DCR and DTVR with Smart tv's
|-
! style="width: 90px;" | Type
! style="width: 45px;" |
! style="width: 45px;" | OS
! | Implementation Guide
|-
| rowspan="9" | {{SmallIcon|SDKIcon.png|alt=SDK}}
|-
| rowspan="4" | {{OSIcon|VideoIcon.png|alt=Video}}
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[TizenTv]]'''
|-
| {{OSIcon|BrowserIcon.png|alt=Browser}}
| '''[[webOS]]'''
|
|-
|{{OSIcon|AndroidIcon.png|alt=Android}}
|'''[[AndroidTV]]'''
|
|}

MediaWiki:Privacy

2026-05-15T20:47:22Z

AmySockanathan:

Privacy Notice

MediaWiki:Privacypage

2026-05-15T20:47:03Z

AmySockanathan:

Project:Privacy Notice

MediaWiki:Privacypage

2026-05-15T20:30:58Z

AmySockanathan:

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/ Privacy policy]

MediaWiki:Privacypage

2026-05-15T20:29:34Z

AmySockanathan:

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/ Privacy Notice]

MediaWiki:Privacypage

2026-05-15T20:28:30Z

AmySockanathan:

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/]

MediaWiki:Privacy

2026-05-15T20:26:36Z

AmySockanathan:

MediaWiki:Privacy

2026-05-15T20:20:26Z

AmySockanathan:

Privacy Notice

MediaWiki:Privacy

2026-05-15T19:46:42Z

AmySockanathan: Link to Privacy Notice

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/ Privacy Notice]

Browser SDK Release Notes

2026-05-15T19:35:28Z

AmySockanathan: Add R2 release notes

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
__NOTOC__

== Release R2(v6.0.0.748) (05-12-2026) ==

* Fall back to the standard setInterval option if Web Workers are not allowed

== Release R1(v6.0.0.747) (03-04-2026) ==

* Added support for Viewability & Audibility
* Last DTVR Subminute ping for iOS-Safari browser was not fired through the POST request.
* Fix for some RTVOD sceanrios
* Fix to not fire a DTVR Subminute timer ping with the evdata containing 00000 offset when FD channel transitions from a valid CID to null

== Release R1(v6.0.0.734) (07-08-2025) ==

* Support for DTVR Subminute feature

== Release V1(v6.0.110) (05-21-2024) ==

* Suppression of v60/v52/v53 legacy pings

== Release R2(v6.0.0.702) (10-30-2024) ==

* 2nd release of DOMless SDK
* Support DCR Static
* Support Debug interface which can be used to view API calls and SDK pings
* Support caching of pings when network is not available

== Release R1(v6.0.0.692) (07-31-2024) ==

* DOMless SDK Release with support for Amazon, ReactNative and other DOM less platforms

== Release R6(v6.0.0.673) (09-05-2023) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R5(v6.0.0.673) (08-14-2023) (AGF Release) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R4(v6.0.0.672) (08-01-2023) ==

* Viewability build with support for Viewability and Audibility features

== Release R3(v6.0.0.663) (05-30-2023) ==

* Support to measure static on hbbtv with the iFrame fixes.

== Release R2(v.6.0.0.648) (05-03-2023) (AGF Release) ==

* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Fix to propagate correct starttm value in postroll content trailing ping
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R1.2(v6.0.0.662) (04-19-2023) ==
* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Support to measure DCR static on a Single Page Application when staticEnd is not called while navigating from one page to another

== Release R1(v6.0.0.648) (03-06-2023) ==
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R4(v6.0.0.623) (05-02-2022) ==
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters

== Release R3(v6.0.0.618) (03-29-2022) ==
* Fix to measure dcr static while video is in focus and within an iFrame
* Fix to propagate correct starttm value in postroll content trailing ping

== Release v6.0.0.355 ==
* Performance improvements through the use of cachable configuration via the Static Queue Snippet.
* Dynamic Configuration File
* Session Ping/UAID - A unique identifier of the device which allows for a single facebook ping per session.
* Support for iOS 12.2

== Release 5.1.0 (Build 2) ==
*Support for DCR Static Lite Measurement
*Advanced Dynamic Script Initialization
*Removal of Configuration file dependency

== Release 5.0.0 (Build 17) ==
*Support for Nielsen Digital Content Ratings (DCR) product
*Support for measurement of static content
*Support for Ad measurement
*Support for Facebook Pings
*Support for multiple instances of the SDK
*General bug fix and performance improvements

MediaWiki:Privacy

2026-05-15T16:16:00Z

AmySockanathan: Change Privacy Policy to Privacy Notice

Privacy Notice

MediaWiki:Privacy

2026-05-15T16:12:28Z

AmySockanathan: Adding link directly to Privacy Notice

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/ Privacy Notice]

MediaWiki:Privacy

2026-05-15T16:08:00Z

AmySockanathan: Pulled back the change

Privacy Notice

MediaWiki:Privacy

2026-05-15T16:07:18Z

AmySockanathan: Directly go to the Privacy notice

[https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/ Privacy Notice]

MediaWiki:Privacypage

2026-05-14T14:54:28Z

AmySockanathan: Change Project:Privacy policy to Project:Privacy Notice

Project:Privacy Notice

MediaWiki:Privacy

2026-05-14T14:52:45Z

AmySockanathan: Change Privacy Policy to Privacy Notice

Privacy Notice

Engineering Client Portal:Privacy policy

2026-05-13T19:04:29Z

AmySockanathan: Update the website privacy page

Please see: https://www.nielsen.com/legal/privacy-principles/website-privacy-statement/

TVOS SDK Release Notes

2026-03-24T14:14:32Z

AmySockanathan: Update TVOS page with all release notes.

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
__NOTOC__
== Release 10.2.0.0 (03-24-2026) ==

* iOS Digital Signature Certificate Renewal
* Fixes for Viewabiity defects
* Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.
* SDK Code Signature fix (Global Flavor only) - The Global direct binary available on the Engineering Portal now correctly includes the SDK code signature for manual integrations.

== Release 10.1.0.0 (10-17-2025) ==

* Support for FPID multi-instance integrations.
* Support for Flutter cross-platform plugin.
* Support for Apple's iOS26/tvOS26 Log Visibility Changes.
* Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==

* Support for DTVR Subminute product.
* Support for DCR video playhead bridging.
* Support for VisionOS platform.
* Change in DemographicID behavior for Chromecast.
* Other bug fixes and enhancements.

== Release 9.4.0.0 (07-09-2024) ==

* Support for privacy manifest with content tracking domain for Ad flavors.
* Support for content tracking and no-tracking domains across sdk flavors and products.
* Other bug fixes and enhancements.

== Release 9.3.0.0 (05-10-2024) ==

* Support for privacy manifest with tracking domain for Ad flavors.
* Support for capturing user opt-out during initialization.
* Other bug fixes and enhancements.

== Release 9.2.0.0 (9-27-2023) ==
*Support for privacy manifest and required reason API introduced in XCode 15.
*Digitally signed SDK framework per Apple recommendation
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF).
*Removed use of iOS keychains, started using NSUserDefaults for persistent storage.
*Viewability: allow enabling by product (DCR, DTVR).
*Other bug fixes and enhancements.

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* SDK built with XCode 14.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Adopting Swift language internally, built on a mixed model (Swift+Objective C).
* Support for Swift markers to help Swift developers.
* Removed the usage of deprecated iOS network reachability class.
* Disabled iCloud backup/synchronization of SDK keychain items.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for XCFramework build distribution.
* Support for MacOS Catalyst platform framework.
* Fixed the device classification for MacOS M1 measurement.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* iOS 14 App Transparency Framework support.
* FPID and VendorID support.
* Fixed the device classification for iPADOS measurement.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==
* Removed usage of deprecated class UIWebView
* Offline viewing measurement enhancements
* Fixed deadlock on SDK shutdown
* Revisited precedence logic for sfcode parameter
* Fix for DCR individual ad pings parameters after channel change
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==
* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Introduced Dynamic framework for SDK.
* Removal of Location Module from SDK Code.
* Increased SDK log file size for Debug mode.
* Removed OTT Airplay/mirroring detection that caused crashes in AVAudioSession class.
* DCR performance improvements.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other Bug Fixes/Enhancements.

== Release 6.1.0.1 (9-13-2018) ==
*Nielsen SDK support for Xcode 10 and tvOS 12

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.17 (1-23-2017) ==
*Added "seconds" place to the launch ping
*Ability to opt-out using "Limit Ad Tracking" feature
*Improved CPU Performance while apps are running in background
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.12 (12-14-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Opt-out pages based on locale and country
*Opt-out policy based on the "Limit Ad Tracking" flag
*Collection of additional device information
*Issue a warning in client developer’s console when ad is played for more than 5 minutes
*Removed the requirement for “type” parameter
*Limit the duration reported for App launch

== Release 5.1.1.7 (9-13-2016) ==
*General bug fix and performance improvements

== Release 5.1.1.5 (7-12-2016) ==
*Includes a sample TVOS application used to assist during integration.
*Support for TVML based optout pages
*General bug fix and performance improvements

== Release 5.1.0.7 (6-15-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Support for Pause timeout
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature

iOS SDK Release Notes

2026-03-23T14:25:37Z

AmySockanathan: Changed the release date of 10.2 to 3/24/2026

[[Category:Digital]]
__NOTOC__

{{Breadcrumb|}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}

== Release 10.2.0.0 (03-24-2026) ==
*iOS Digital Signature Certificate Renewal
*Fixes for Viewabiity defects
*Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.
*SDK Code Signature fix (Global Flavor only) - The Global direct binary available on the Engineering Portal now correctly includes the SDK code signature for manual integrations.

== Release 10.1.0.0 (10-17-2025) ==
*Support for FPID multi-instance integrations.
*Support for Flutter cross-platform plugin.
*Support for Apple's iOS26/tvOS26 Log Visibility Changes.
*Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==
*Support for DTVR Subminute product.
*Support for DCR video playhead bridging.
*Support for VisionOS platform.
*Change in DemographicID behavior for Chromecast.
*Other bug fixes and enhancements.

== '''Release 9.4.0.0 (07-09-2024)''' ==
*Support for privacy manifest with content tracking domain for Ad flavors.
*Support for content tracking and no-tracking domains across sdk flavors and products.
*Other bug fixes and enhancements.
== Release 9.3.0.0 (05-10-2024) ==
*Support for privacy manifest with tracking domain for Ad flavors.
*Support for capturing user opt-out during initialization.
*Other bug fixes and enhancements.
== Release 9.2.0.0 (9-27-2023) ==
*Support for privacy manifest and required reason API introduced in XCode 15.
*Digitally signed SDK framework per Apple recommendation
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF).
*Removed use of iOS keychains, started using NSUserDefaults for persistent storage.
*Viewability: allow enabling by product (DCR, DTVR).
*Other bug fixes and enhancements.

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* SDK built with XCode 14.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Adopting Swift language internally, built on a mixed model (Swift+Objective C).
* Support for Swift markers to help Swift developers.
* Removed the usage of deprecated iOS network reachability class.
* Disabled iCloud backup/synchronization of SDK keychain items.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for XCFramework build distribution.
* Support for MacOS Catalyst platform framework.
* Fixed the device classification for MacOS M1 measurement.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* iOS 14 App Transparency Framework support.
* FPID and VendorID support.
* Fixed the device classification for iPADOS measurement.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==
* Removed usage of deprecated class UIWebView
* Offline viewing measurement enhancements
* Fixed deadlock on SDK shutdown
* Revisited precedence logic for sfcode parameter
* Fix for DCR individual ad pings parameters after channel change
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==
* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Introduced Dynamic framework for SDK.
* Removal of Location Module from SDK Code.
* Increased SDK log file size for Debug mode.
* Removed OTT Airplay/mirroring detection that caused crashes in AVAudioSession class.
* DCR performance improvements.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other Bug Fixes/Enhancements.

== Release 6.1.0.1 (9-13-2018) ==
*Support added for Video On Demand in TV Ratings
*Support for Xcode 10 and iOS 12

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.29 (7-31-2017) ==
*Genre parameter will be a part of DCR pings and the value will be reflected as part of c44 parameter.
*Merged adModel and adLoadType flags
*Fix for stop event data carried to next session’s duration ping

== Release 5.1.1.25 (5-31-2017) ==
*Enhanced support for Digital Audio
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for App crash when multiple threads are accessing the SQLite

== Release 5.1.1.23 (5-5-2017) ==
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for App crash when multiple threads are accessing the SQLite

== Release 5.1.1.19 (4-3-2017) ==
*Fix for muting background music apps

== Release 5.1.1.18 (2-3-2017) ==
*Minor bug fixes and performance improvement

== Release 5.1.1.17 (1-23-2017) ==
*Added “seconds” place to the launch ping
*Ability to opt-out using “Limit Ad Tracking” feature
*Improved CPU Performance while apps are running in background
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.12 (12-14-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Opt-out pages based on locale and country
*Opt-out policy based on the ‘Limit Ad Tracking’ flag
*Collection of additional device information
*Issue a warning in client developer’s console when ad is played for more than 5 minutes
*Removed the requirement for “type” parameter
*Limit the duration reported for App launch

== Release 5.1.1.9 (10-18-2016) ==
*Fixed Linker error duplicate symbols for Reachability notification in iOS.

== Release 5.1.1.7 (9-13-2016) ==
*Support for iOS 10
*Usage of stop API call is made optional when switching between content or advertising occurs.
*General bug fix and performance improvements

== Release 5.1.1.5 (7-12-2016) ==
*Sending event level (button press data) data to census collections.
*Support for Pause timeout (from 30 minutes to 5 minutes)
*Changes in OTT when switching from mobile to Chromecast
*Self-error Reporting for iOS SDK
*General bug fix and performance improvements

== Release 5.1.0.5 (4-25-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Changes to use of stop API
*Support for OTT measurement
*Support for Pause timeout
*Offline viewing
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature
*Introduced new API updateOTT to report current OTT status.

== Release 4.0.0.8 (6-9-2015) ==
*Support for Nielsen DCR product (Digital Content Ratings)
**All the products should be migrated to the latest SDK.
**This SDK distribution does not have a native library component or shared object.
*Support for Nielsen App static measurement
*Support for Ad measurement
*Removal of Native C++ code
*Removed singleton restriction
*Support for iOS 9 and iOS 9 PIP mode
*General bug fix and performance improvements

== Release 3.2.1.26 (1-10-2015) ==

Android SDK Release Notes

2026-03-23T14:24:50Z

AmySockanathan: Changed release 10.2 date to 3/24/2026

[[Category:Digital]]
__NOTOC__

{{Breadcrumb|}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}
== Release 10.2.0.0 (03-24-2026) ==
*[[Mitigation of Android 15 background]] network access restrictions.
*Fixed Viewabiity defects.
*Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.

== Release 10.1.0.0 (10-17-2025) ==
*Support for FPID multi-instance integrations.
*Support for Flutter cross-platform plugin.
*Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==
*Support for DTVR Subminute product.
*Support for DCR video playhead bridging.
*Support for Ethernet network connection for TV platforms.
*Change in DemographicID behavior for Chromecast.
*Other bug fixes and enhancements.

== Release 9.2.0.0 (9-27-2023) ==
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF)
*Viewability: allow enabling by product (DCR, DTVR)
*Other bug fixes and enhancements

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* Kotlin-Java interoperability implementation in SDK.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Support for EMM AGF AdID-less solution.
* Enabled SDK to capture network availability changes.
* Removed the usage of deprecated network classes.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for SDK build variants - AD/NoAD/NoID.
* Support to indicate ID used for AD build variant - AD ID vs Android ID.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* FPID and VendorID support.
* Support for Android apps running on ChromeOS.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==

* Application background/foreground state auto-detection (AndroidX)
* Fixed forward rewind evdata containing negative values
* Offline viewing measurement enhancements
* Revisited precedence logic for sfcode parameter
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==

* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Removal of Location Module from SDK Code.
* Fixed the getOptoutStatus() api, so that client can call it in main thread.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other enhancements and fixes.

== Release 6.1.0.1 (9-13-2018) ==
*Support added for Video On Demand in TV Ratings
*Bug fixes and improvements

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.26 (7-31-2017) ==
*Genre parameter will be a part of DCR pings and the value is reflected as part of c44 parameter.
*Merged adModel and adLoadType flags
*Fix for stop event data carried to next session’s duration ping
*Fix for last playhead call that is not processed (when there is no time-gap between the last playhead and end call)

== Release 5.1.1.24 (6-2-2017) ==
*Enhanced support for Digital Audio
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for metadata carry over between channels after a channel change

== Release 5.1.1.18 (1-24-2017) ==
*Ability to opt-out using “Limit Ad Tracking” feature
*Improved CPU Performance through encryption process change
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.14 (12-10-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Collection of additional device information
*Opt-out pages based on locale and country
*Opt-out based on the ‘Limit Ad Tracking’ flag
*Issue a warning in client developer’s console when an ad is being played for more than 5 minutes
*Reduced load time of Android SDK, caused due to encryption.
*Limit the duration reported for App launch
*Modification to accept non-JSON strings
*Fixed
**Incorrect DRM placement ID
**DRM pings sent in bursts in case of time change

== Release 5.1.1.10 (10-19-2016) ==
*Fixed an issue where SDK will send a burst of data pings in Android.

== Release 5.1.1.7 (9-1-2016) ==
*Support for Android N
*Usage of stop API call is made optional when switching between content or advertising occurs.
*General bug fix and performance improvements

== Release 5.1.1.4 (8-1-2016) ==
*Support for Pause timeout (from 30 minutes to 5 minutes)

== Release 5.1.1.3 (7-7-2016) ==
*Sending event level (button press data) data to census collections.
*Changes in OTT when switching from mobile to Chromecast
*General bug fix and performance improvements

== Release 5.1.0.4 (4-25-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Changes to use of stop API
*Support for OTT measurement
*Support for Pause timeout
*Offline viewing
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature
*Introduced new API updateOTT to report current OTT status.

== Release 4.0.0.8 (6-9-2015) ==
*Support for Nielsen DCR product (Digital Content Ratings)
*All the products should be migrated to the latest SDK.
*This SDK distribution does not have a native library component or shared object.
*Support for Nielsen App static measurement
*Support for Ad measurement
*Removal of Native C++ code
*Removed singleton restriction
*Support for Android 6.0 Marshmallow
*General bug fix and performance improvements

== Release 1.2.3.8 (1-10-2015) ==

Mitigation of Android 15 background

2026-03-20T14:49:29Z

AmySockanathan: /* Observation */

==Mitigation of Android 15 background network access restrictions==
===Observation===
On devices running Android 15 and 16, ping HTTP requests consistently fail while the application is in a background state.
These failed pings currently undergo five retry attempts, which consistently result in a 404 error response.
Once the retry limit is reached, the failed requests are purged from the pending database table.
The OS's aggressive background restrictions prevent the SDK from establishing a stable network handshake.

===Root Cause===
Below writeup has been taken directly from the official [https://developer.android.com/about/versions/15/behavior-changes-all#background-network-access Android developer documentation] which states that -

“In Android 15, apps that start a network request outside of a valid process lifecycle receive an exception. Typically, an UnknownHostException or other socket-related IOException. Network requests that happen outside of a valid lifecycle are usually due to apps unknowingly continuing a network request even after the app is no longer active.

To mitigate this exception, ensure your network requests are lifecycle aware and cancelled upon leaving a valid process lifecycle by using lifecycle aware components. If it is important that the network request should happen even when the user leaves the application, consider scheduling the network request using WorkManager or continue a user visible task using Foreground Service.”

===Conclusion Of Background Behaviour Changes===
Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data loss on devices running Android 15 or later.

===WorkManager Integration (Client Side)===
Client apps must add the WorkManager library once they have integrated version '''10.2.0.0''' of the AppSDK. Starting with this version, the WorkManager library is a mandatory dependency and missing it will '''fail the AppSDK initialization'''.

The AppSDK will flash the below error message to the console -

<code>“AppApi initialize failed! Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data synchronization issues on newer devices. Please add the androidx.work:work-runtime dependency to your project's build.gradle file“</code>

'''Note:''' ''Please add the'' '''androidx.work:work-runtime''' ''dependency to the project's build.gradle file.''

Mitigation of Android 15 background

2026-03-20T14:47:30Z

AmySockanathan: /* Observation */

==Mitigation of Android 15 background network access restrictions==
===Observation===
On devices running Android 15 and 16, ping HTTP requests consistently fail while the application is in a background state.

These failed pings currently undergo five retry attempts, which consistently result in a 404 error response.

Once the retry limit is reached, the failed requests are purged from the pending database table.

The OS's aggressive background restrictions prevent the SDK from establishing a stable network handshake.

===Root Cause===
Below writeup has been taken directly from the official [https://developer.android.com/about/versions/15/behavior-changes-all#background-network-access Android developer documentation] which states that -

“In Android 15, apps that start a network request outside of a valid process lifecycle receive an exception. Typically, an UnknownHostException or other socket-related IOException. Network requests that happen outside of a valid lifecycle are usually due to apps unknowingly continuing a network request even after the app is no longer active.

To mitigate this exception, ensure your network requests are lifecycle aware and cancelled upon leaving a valid process lifecycle by using lifecycle aware components. If it is important that the network request should happen even when the user leaves the application, consider scheduling the network request using WorkManager or continue a user visible task using Foreground Service.”

===Conclusion Of Background Behaviour Changes===
Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data loss on devices running Android 15 or later.

===WorkManager Integration (Client Side)===
Client apps must add the WorkManager library once they have integrated version '''10.2.0.0''' of the AppSDK. Starting with this version, the WorkManager library is a mandatory dependency and missing it will '''fail the AppSDK initialization'''.

The AppSDK will flash the below error message to the console -

<code>“AppApi initialize failed! Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data synchronization issues on newer devices. Please add the androidx.work:work-runtime dependency to your project's build.gradle file“</code>

'''Note:''' ''Please add the'' '''androidx.work:work-runtime''' ''dependency to the project's build.gradle file.''

iOS SDK Release Notes

2026-03-19T19:41:55Z

AmySockanathan: Add 10.2.0.0 release notes

[[Category:Digital]]
__NOTOC__

{{Breadcrumb|}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}

== Release 10.2.0.0 (03-23-2026) ==
*iOS Digital Signature Certificate Renewal
*Fixes for Viewabiity defects
*Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.
*SDK Code Signature fix (Global Flavor only) - The Global direct binary available on the Engineering Portal now correctly includes the SDK code signature for manual integrations.

== Release 10.1.0.0 (10-17-2025) ==
*Support for FPID multi-instance integrations.
*Support for Flutter cross-platform plugin.
*Support for Apple's iOS26/tvOS26 Log Visibility Changes.
*Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==
*Support for DTVR Subminute product.
*Support for DCR video playhead bridging.
*Support for VisionOS platform.
*Change in DemographicID behavior for Chromecast.
*Other bug fixes and enhancements.

== '''Release 9.4.0.0 (07-09-2024)''' ==
*Support for privacy manifest with content tracking domain for Ad flavors.
*Support for content tracking and no-tracking domains across sdk flavors and products.
*Other bug fixes and enhancements.
== Release 9.3.0.0 (05-10-2024) ==
*Support for privacy manifest with tracking domain for Ad flavors.
*Support for capturing user opt-out during initialization.
*Other bug fixes and enhancements.
== Release 9.2.0.0 (9-27-2023) ==
*Support for privacy manifest and required reason API introduced in XCode 15.
*Digitally signed SDK framework per Apple recommendation
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF).
*Removed use of iOS keychains, started using NSUserDefaults for persistent storage.
*Viewability: allow enabling by product (DCR, DTVR).
*Other bug fixes and enhancements.

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* SDK built with XCode 14.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Adopting Swift language internally, built on a mixed model (Swift+Objective C).
* Support for Swift markers to help Swift developers.
* Removed the usage of deprecated iOS network reachability class.
* Disabled iCloud backup/synchronization of SDK keychain items.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for XCFramework build distribution.
* Support for MacOS Catalyst platform framework.
* Fixed the device classification for MacOS M1 measurement.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* iOS 14 App Transparency Framework support.
* FPID and VendorID support.
* Fixed the device classification for iPADOS measurement.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==
* Removed usage of deprecated class UIWebView
* Offline viewing measurement enhancements
* Fixed deadlock on SDK shutdown
* Revisited precedence logic for sfcode parameter
* Fix for DCR individual ad pings parameters after channel change
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==
* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Introduced Dynamic framework for SDK.
* Removal of Location Module from SDK Code.
* Increased SDK log file size for Debug mode.
* Removed OTT Airplay/mirroring detection that caused crashes in AVAudioSession class.
* DCR performance improvements.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other Bug Fixes/Enhancements.

== Release 6.1.0.1 (9-13-2018) ==
*Support added for Video On Demand in TV Ratings
*Support for Xcode 10 and iOS 12

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.29 (7-31-2017) ==
*Genre parameter will be a part of DCR pings and the value will be reflected as part of c44 parameter.
*Merged adModel and adLoadType flags
*Fix for stop event data carried to next session’s duration ping

== Release 5.1.1.25 (5-31-2017) ==
*Enhanced support for Digital Audio
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for App crash when multiple threads are accessing the SQLite

== Release 5.1.1.23 (5-5-2017) ==
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for App crash when multiple threads are accessing the SQLite

== Release 5.1.1.19 (4-3-2017) ==
*Fix for muting background music apps

== Release 5.1.1.18 (2-3-2017) ==
*Minor bug fixes and performance improvement

== Release 5.1.1.17 (1-23-2017) ==
*Added “seconds” place to the launch ping
*Ability to opt-out using “Limit Ad Tracking” feature
*Improved CPU Performance while apps are running in background
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.12 (12-14-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Opt-out pages based on locale and country
*Opt-out policy based on the ‘Limit Ad Tracking’ flag
*Collection of additional device information
*Issue a warning in client developer’s console when ad is played for more than 5 minutes
*Removed the requirement for “type” parameter
*Limit the duration reported for App launch

== Release 5.1.1.9 (10-18-2016) ==
*Fixed Linker error duplicate symbols for Reachability notification in iOS.

== Release 5.1.1.7 (9-13-2016) ==
*Support for iOS 10
*Usage of stop API call is made optional when switching between content or advertising occurs.
*General bug fix and performance improvements

== Release 5.1.1.5 (7-12-2016) ==
*Sending event level (button press data) data to census collections.
*Support for Pause timeout (from 30 minutes to 5 minutes)
*Changes in OTT when switching from mobile to Chromecast
*Self-error Reporting for iOS SDK
*General bug fix and performance improvements

== Release 5.1.0.5 (4-25-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Changes to use of stop API
*Support for OTT measurement
*Support for Pause timeout
*Offline viewing
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature
*Introduced new API updateOTT to report current OTT status.

== Release 4.0.0.8 (6-9-2015) ==
*Support for Nielsen DCR product (Digital Content Ratings)
**All the products should be migrated to the latest SDK.
**This SDK distribution does not have a native library component or shared object.
*Support for Nielsen App static measurement
*Support for Ad measurement
*Removal of Native C++ code
*Removed singleton restriction
*Support for iOS 9 and iOS 9 PIP mode
*General bug fix and performance improvements

== Release 3.2.1.26 (1-10-2015) ==

Mitigation of Android 15 background

2026-03-19T19:36:40Z

AmySockanathan: /* The Root Cause */

==Mitigation of Android 15 background network access restrictions==
===Observation===
On devices running Android 15 and 16, ping HTTP requests consistently fail while the application is in a background state.

These failed pings currently undergo five retry attempts, which consistently result in a 404 error response.

Once the retry limit is reached, the failed requests are purged from the pending database table.

The OS's aggressive background restrictions prevent the SDK from establishing a stable network handshake.

===Root Cause===
Below writeup has been taken directly from the official [https://developer.android.com/about/versions/15/behavior-changes-all#background-network-access Android developer documentation] which states that -

“In Android 15, apps that start a network request outside of a valid process lifecycle receive an exception. Typically, an UnknownHostException or other socket-related IOException. Network requests that happen outside of a valid lifecycle are usually due to apps unknowingly continuing a network request even after the app is no longer active.

To mitigate this exception, ensure your network requests are lifecycle aware and cancelled upon leaving a valid process lifecycle by using lifecycle aware components. If it is important that the network request should happen even when the user leaves the application, consider scheduling the network request using WorkManager or continue a user visible task using Foreground Service.”

===Conclusion Of Background Behaviour Changes===
Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data loss on devices running Android 15 or later.

===WorkManager Integration (Client Side)===
Client apps must add the WorkManager library once they have integrated version '''10.2.0.0''' of the AppSDK. Starting with this version, the WorkManager library is a mandatory dependency and missing it will '''fail the AppSDK initialization'''.

The AppSDK will flash the below error message to the console -

<code>“AppApi initialize failed! Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data synchronization issues on newer devices. Please add the androidx.work:work-runtime dependency to your project's build.gradle file“</code>

'''Note:''' ''Please add the'' '''androidx.work:work-runtime''' ''dependency to the project's build.gradle file.''

Mitigation of Android 15 background

2026-03-19T19:35:49Z

AmySockanathan: Create a new page for "Mitigation of Android 15 background"

==Mitigation of Android 15 background network access restrictions==
===Observation===
On devices running Android 15 and 16, ping HTTP requests consistently fail while the application is in a background state.

These failed pings currently undergo five retry attempts, which consistently result in a 404 error response.

Once the retry limit is reached, the failed requests are purged from the pending database table.

The OS's aggressive background restrictions prevent the SDK from establishing a stable network handshake.

===The Root Cause===
Below writeup has been taken directly from the official [https://developer.android.com/about/versions/15/behavior-changes-all#background-network-access Android developer documentation] which states that -

“In Android 15, apps that start a network request outside of a valid process lifecycle receive an exception. Typically, an UnknownHostException or other socket-related IOException. Network requests that happen outside of a valid lifecycle are usually due to apps unknowingly continuing a network request even after the app is no longer active.

To mitigate this exception, ensure your network requests are lifecycle aware and cancelled upon leaving a valid process lifecycle by using lifecycle aware components. If it is important that the network request should happen even when the user leaves the application, consider scheduling the network request using WorkManager or continue a user visible task using Foreground Service.”

===Conclusion Of Background Behaviour Changes===
Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data loss on devices running Android 15 or later.

===WorkManager Integration (Client Side)===
Client apps must add the WorkManager library once they have integrated version '''10.2.0.0''' of the AppSDK. Starting with this version, the WorkManager library is a mandatory dependency and missing it will '''fail the AppSDK initialization'''.

The AppSDK will flash the below error message to the console -

<code>“AppApi initialize failed! Starting with Android 15, the system has introduced stricter limitations on background network access! So we have transitioned our background operations to use the WorkManager API, which is now a required dependency. Without the WorkManager library, background network calls may be blocked or fail silently, leading to data synchronization issues on newer devices. Please add the androidx.work:work-runtime dependency to your project's build.gradle file“</code>

'''Note:''' ''Please add the'' '''androidx.work:work-runtime''' ''dependency to the project's build.gradle file.''

Android SDK Release Notes

2026-03-19T19:21:06Z

AmySockanathan: Add the link to new page for "mitigation of Android 15 background issue"

[[Category:Digital]]
__NOTOC__

{{Breadcrumb|}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}
== Release 10.2.0.0 (03-23-2026) ==
*[[Mitigation of Android 15 background]] network access restrictions.
*Fixed Viewabiity defects.
*Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.

== Release 10.1.0.0 (10-17-2025) ==
*Support for FPID multi-instance integrations.
*Support for Flutter cross-platform plugin.
*Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==
*Support for DTVR Subminute product.
*Support for DCR video playhead bridging.
*Support for Ethernet network connection for TV platforms.
*Change in DemographicID behavior for Chromecast.
*Other bug fixes and enhancements.

== Release 9.2.0.0 (9-27-2023) ==
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF)
*Viewability: allow enabling by product (DCR, DTVR)
*Other bug fixes and enhancements

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* Kotlin-Java interoperability implementation in SDK.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Support for EMM AGF AdID-less solution.
* Enabled SDK to capture network availability changes.
* Removed the usage of deprecated network classes.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for SDK build variants - AD/NoAD/NoID.
* Support to indicate ID used for AD build variant - AD ID vs Android ID.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* FPID and VendorID support.
* Support for Android apps running on ChromeOS.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==

* Application background/foreground state auto-detection (AndroidX)
* Fixed forward rewind evdata containing negative values
* Offline viewing measurement enhancements
* Revisited precedence logic for sfcode parameter
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==

* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Removal of Location Module from SDK Code.
* Fixed the getOptoutStatus() api, so that client can call it in main thread.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other enhancements and fixes.

== Release 6.1.0.1 (9-13-2018) ==
*Support added for Video On Demand in TV Ratings
*Bug fixes and improvements

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.26 (7-31-2017) ==
*Genre parameter will be a part of DCR pings and the value is reflected as part of c44 parameter.
*Merged adModel and adLoadType flags
*Fix for stop event data carried to next session’s duration ping
*Fix for last playhead call that is not processed (when there is no time-gap between the last playhead and end call)

== Release 5.1.1.24 (6-2-2017) ==
*Enhanced support for Digital Audio
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for metadata carry over between channels after a channel change

== Release 5.1.1.18 (1-24-2017) ==
*Ability to opt-out using “Limit Ad Tracking” feature
*Improved CPU Performance through encryption process change
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.14 (12-10-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Collection of additional device information
*Opt-out pages based on locale and country
*Opt-out based on the ‘Limit Ad Tracking’ flag
*Issue a warning in client developer’s console when an ad is being played for more than 5 minutes
*Reduced load time of Android SDK, caused due to encryption.
*Limit the duration reported for App launch
*Modification to accept non-JSON strings
*Fixed
**Incorrect DRM placement ID
**DRM pings sent in bursts in case of time change

== Release 5.1.1.10 (10-19-2016) ==
*Fixed an issue where SDK will send a burst of data pings in Android.

== Release 5.1.1.7 (9-1-2016) ==
*Support for Android N
*Usage of stop API call is made optional when switching between content or advertising occurs.
*General bug fix and performance improvements

== Release 5.1.1.4 (8-1-2016) ==
*Support for Pause timeout (from 30 minutes to 5 minutes)

== Release 5.1.1.3 (7-7-2016) ==
*Sending event level (button press data) data to census collections.
*Changes in OTT when switching from mobile to Chromecast
*General bug fix and performance improvements

== Release 5.1.0.4 (4-25-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Changes to use of stop API
*Support for OTT measurement
*Support for Pause timeout
*Offline viewing
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature
*Introduced new API updateOTT to report current OTT status.

== Release 4.0.0.8 (6-9-2015) ==
*Support for Nielsen DCR product (Digital Content Ratings)
*All the products should be migrated to the latest SDK.
*This SDK distribution does not have a native library component or shared object.
*Support for Nielsen App static measurement
*Support for Ad measurement
*Removal of Native C++ code
*Removed singleton restriction
*Support for Android 6.0 Marshmallow
*General bug fix and performance improvements

== Release 1.2.3.8 (1-10-2015) ==

Android SDK Release Notes

2026-03-19T19:09:44Z

AmySockanathan: Android 10.2.0. release notes

[[Category:Digital]]
__NOTOC__

{{Breadcrumb|}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}
== Release 10.2.0.0 (03-23-2026) ==
*Mitigation of Android 15 background network access restrictions.
*Fixed Viewabiity defects.
*Ad length warning - Fixed the ad tracking logic so now, the 300-second warning will only fire if the current ad actually plays for more than 5 minutes, and that error state will no longer bleed over into the next ad.

== Release 10.1.0.0 (10-17-2025) ==
*Support for FPID multi-instance integrations.
*Support for Flutter cross-platform plugin.
*Other bug fixes and enhancements.

== Release 10.0.0.0 (04-04-2025) ==
*Support for DTVR Subminute product.
*Support for DCR video playhead bridging.
*Support for Ethernet network connection for TV platforms.
*Change in DemographicID behavior for Chromecast.
*Other bug fixes and enhancements.

== Release 9.2.0.0 (9-27-2023) ==
*DCR Static recognizing metadata with changed assetID for new impressions.
*Limiting ping retries during https failures.
*Other bug fixes and enhancements.

== Release 9.1.0.0 (3-31-2023) ==
*DCR Static duration measurement for AppSDK (currently only AGF)
*Viewability: allow enabling by product (DCR, DTVR)
*Other bug fixes and enhancements

== Release 9.0.0.0 (10-07-2022) ==
* Viewability measurement for DTVR, DCR Content and DCR Ad products.
* Audibility measurement for DTVR, DCR Content and DCR Ad products.
* Kotlin-Java interoperability implementation in SDK.
* Other bug fixes and enhancements.

== Release 8.2.0.0 (03-21-2022) ==
* Support for EMM AGF AdID-less solution.
* Enabled SDK to capture network availability changes.
* Removed the usage of deprecated network classes.
* Other bug fixes and enhancements.

== Release 8.1.0.0 (06-28-2021) ==
* Support for SDK build variants - AD/NoAD/NoID.
* Support to indicate ID used for AD build variant - AD ID vs Android ID.
* Support to capture Hashed email and UID.
* Support to collect SDK diagnostic data.
* Other bug fixes and enhancements.

== Release 8.0.0.0 (10-05-2020) ==
* FPID and VendorID support.
* Support for Android apps running on ChromeOS.
* Support for Xamarin cross platform framework.
* Other bug fixes and enhancements.

== Release 7.2.0.0 (05-18-2020) ==
* DTVR AQH and IVD requirements for End and pause timeout.
* Support for Hybrid app webview measurement.
* Support for Hybrid app react native webview measurement.
* Support for React Native measurement.
* Other bug fixes and enhancements

== Release 7.1.0.0 (12-09-2019) ==

* Application background/foreground state auto-detection (AndroidX)
* Fixed forward rewind evdata containing negative values
* Offline viewing measurement enhancements
* Revisited precedence logic for sfcode parameter
* Using default value for incorrect adModel parameter
* Defaulting isLive parameter value on channel change
* Other fixes and enhancements.

== Release 7.0.0.0 (09-06-2019) ==

* Support for CDN based config.
* Support for Market based EMM UAID pings.
* Changes required for proper DCR Static measurement in multi-instance/multiple appid's case.
* Fixes for OTT synchronization issues between iOS and Android platforms.
* Fixes for EV data parameters in few scenarios.
* Fixes for DCR Static product behaviour in background app refresh and background fetch scenarios.
* DCR Ad reporting improvements.
* Fixes and improvements for the SDK console log messages.
* Other enhancements and fixes.

== Release 6.2.0.0 (02-04-2019) ==
* Removal of Location Module from SDK Code.
* Fixed the getOptoutStatus() api, so that client can call it in main thread.
* Fixed the parsing error happening when clientid/vcid provided as empty in metadata.
* Align AppSDK for FW detection with BSDK for DCR measurement.
* Other enhancements and fixes.

== Release 6.1.0.1 (9-13-2018) ==
*Support added for Video On Demand in TV Ratings
*Bug fixes and improvements

== Release 6.0.0.4 (5-24-2018) ==
*If the SDK build target is set to AGF then SDK will send the hello ping to “eu” and “eu-uat” for debug builds. No changes to the non AGF build the default sfcode will continue to be "sdk" and "cert" for debug build.
*The C1 parameter (NUID) will now be sent as encrypted DeviceID.
*New SessionID changes. The sessionID will contain 29 length random characters appended by timestamp.
*Support for multiple SDK instance without any limit.
*New log feature for CAT tool to retrieve the API level information from client apps. This ping will contain the eventType, parameters, SDK version, appid etc.
*Removed Viewability for this release.

== Release 5.1.1.26 (7-31-2017) ==
*Genre parameter will be a part of DCR pings and the value is reflected as part of c44 parameter.
*Merged adModel and adLoadType flags
*Fix for stop event data carried to next session’s duration ping
*Fix for last playhead call that is not processed (when there is no time-gap between the last playhead and end call)

== Release 5.1.1.24 (6-2-2017) ==
*Enhanced support for Digital Audio
*Ability to pass adloadtype as “linear” or “dynamic”
*Ability to detect end of content and static material through duration pings
*Acceptance of empty parameters with a warning message triggered, if a required parameter is missing
*Acceptance of case-insensitive JSON key values
*Configurable feature to show Ad view counts in the duration pings
*Automatic Pause Detection and Debug build detection
*Change of default ‘type’ from “ad” to “content”
*Removal of “Static” Launch Ping for Non-Static product implementations
*Fix for metadata carry over between channels after a channel change

== Release 5.1.1.18 (1-24-2017) ==
*Ability to opt-out using “Limit Ad Tracking” feature
*Improved CPU Performance through encryption process change
*Opt-Out pages can be served based on user’s language and locale from device

== Release 5.1.1.14 (12-10-2016) ==
*Support for Nielsen TV Brand Effect
*Ability to set CMS parameters at a more global level
*Collection of additional device information
*Opt-out pages based on locale and country
*Opt-out based on the ‘Limit Ad Tracking’ flag
*Issue a warning in client developer’s console when an ad is being played for more than 5 minutes
*Reduced load time of Android SDK, caused due to encryption.
*Limit the duration reported for App launch
*Modification to accept non-JSON strings
*Fixed
**Incorrect DRM placement ID
**DRM pings sent in bursts in case of time change

== Release 5.1.1.10 (10-19-2016) ==
*Fixed an issue where SDK will send a burst of data pings in Android.

== Release 5.1.1.7 (9-1-2016) ==
*Support for Android N
*Usage of stop API call is made optional when switching between content or advertising occurs.
*General bug fix and performance improvements

== Release 5.1.1.4 (8-1-2016) ==
*Support for Pause timeout (from 30 minutes to 5 minutes)

== Release 5.1.1.3 (7-7-2016) ==
*Sending event level (button press data) data to census collections.
*Changes in OTT when switching from mobile to Chromecast
*General bug fix and performance improvements

== Release 5.1.0.4 (4-25-2016) ==
*Combined SDK for DCR US and International (Germany)
*API to signal end of content (end API)
*Changes to use of stop API
*Support for OTT measurement
*Support for Pause timeout
*Offline viewing
*Updated API to support JSON object instead of string.
*Reporting of media URL and bundle ID
*Updated ping retry logic
*Changes in OptOut process behavioral
*Enhanced Debugging and SDK logging
*Changes to API signature
*Introduced new API updateOTT to report current OTT status.

== Release 4.0.0.8 (6-9-2015) ==
*Support for Nielsen DCR product (Digital Content Ratings)
*All the products should be migrated to the latest SDK.
*This SDK distribution does not have a native library component or shared object.
*Support for Nielsen App static measurement
*Support for Ad measurement
*Removal of Native C++ code
*Removed singleton restriction
*Support for Android 6.0 Marshmallow
*General bug fix and performance improvements

== Release 1.2.3.8 (1-10-2015) ==

Browser SDK Release Notes

2026-03-06T15:48:15Z

AmySockanathan: Release notes for R1 2026 BSDK release

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
__NOTOC__

== Release R1(v6.0.0.747) (03-04-2026) ==

* Added support for Viewability & Audibility
* Last DTVR Subminute ping for iOS-Safari browser was not fired through the POST request.
* Fix for some RTVOD sceanrios
* Fix to not fire a DTVR Subminute timer ping with the evdata containing 00000 offset when FD channel transitions from a valid CID to null

== Release R1(v6.0.0.734) (07-08-2025) ==

* Support for DTVR Subminute feature

== Release V1(v6.0.110) (05-21-2024) ==

* Suppression of v60/v52/v53 legacy pings

== Release R2(v6.0.0.702) (10-30-2024) ==

* 2nd release of DOMless SDK
* Support DCR Static
* Support Debug interface which can be used to view API calls and SDK pings
* Support caching of pings when network is not available

== Release R1(v6.0.0.692) (07-31-2024) ==

* DOMless SDK Release with support for Amazon, ReactNative and other DOM less platforms

== Release R6(v6.0.0.673) (09-05-2023) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R5(v6.0.0.673) (08-14-2023) (AGF Release) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R4(v6.0.0.672) (08-01-2023) ==

* Viewability build with support for Viewability and Audibility features

== Release R3(v6.0.0.663) (05-30-2023) ==

* Support to measure static on hbbtv with the iFrame fixes.

== Release R2(v.6.0.0.648) (05-03-2023) (AGF Release) ==

* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Fix to propagate correct starttm value in postroll content trailing ping
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R1.2(v6.0.0.662) (04-19-2023) ==
* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Support to measure DCR static on a Single Page Application when staticEnd is not called while navigating from one page to another

== Release R1(v6.0.0.648) (03-06-2023) ==
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R4(v6.0.0.623) (05-02-2022) ==
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters

== Release R3(v6.0.0.618) (03-29-2022) ==
* Fix to measure dcr static while video is in focus and within an iFrame
* Fix to propagate correct starttm value in postroll content trailing ping

== Release v6.0.0.355 ==
* Performance improvements through the use of cachable configuration via the Static Queue Snippet.
* Dynamic Configuration File
* Session Ping/UAID - A unique identifier of the device which allows for a single facebook ping per session.
* Support for iOS 12.2

== Release 5.1.0 (Build 2) ==
*Support for DCR Static Lite Measurement
*Advanced Dynamic Script Initialization
*Removal of Configuration file dependency

== Release 5.0.0 (Build 17) ==
*Support for Nielsen Digital Content Ratings (DCR) product
*Support for measurement of static content
*Support for Ad measurement
*Support for Facebook Pings
*Support for multiple instances of the SDK
*General bug fix and performance improvements

Domless SDK API Reference

2026-01-27T21:27:38Z

AmySockanathan: /* SetInterval */

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.setItem('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.setItem(key: string, value: string)

getItem()

storage.getItem(key: string)

removeItem()

storage.removeItem(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

==== SetTimeout ====
Function to set a timer in milliseconds to execute a block of code on expiry

e.g. SetTimeout(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to execute when the timer expires

timeout Required

● number - The time that the timer should wait before the callback function is executed. This is in milliseconds.
</blockquote>

==== SetInterval ====
Function to repeatedly call a function with a fixed time delay in milliseconds between each call.

e.g. SetInterval(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to be executed every interval specified

interval Required

● number - The delay in milliseconds between the execution of the function
</blockquote>

==== ClearTimeout ====
Function to cancel the timeout previously set by SetTimeout

e.g. ClearTimeout(1000)
===== Parameters =====
<blockquote>timeout Required

● number - The time that the timer should wait before the callback function is executed
</blockquote>
==== ClearInterval ====
Function to cancel the timed repeating call which was previously established through SetInterval

e.g. ClearInterval(1000)
===== Parameters =====
<blockquote>interval Required

● number - The delay between the execution of the function
</blockquote>
==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Domless SDK API Reference

2026-01-27T21:27:03Z

AmySockanathan: /* SetTimeout */

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.setItem('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.setItem(key: string, value: string)

getItem()

storage.getItem(key: string)

removeItem()

storage.removeItem(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

==== SetTimeout ====
Function to set a timer in milliseconds to execute a block of code on expiry

e.g. SetTimeout(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to execute when the timer expires

timeout Required

● number - The time that the timer should wait before the callback function is executed. This is in milliseconds.
</blockquote>

==== SetInterval ====
Function to repeatedly call a function with a fixed time delay between each call.

e.g. SetInterval(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to be executed every interval specified

interval Required

● number - The delay between the execution of the function
</blockquote>
==== ClearTimeout ====
Function to cancel the timeout previously set by SetTimeout

e.g. ClearTimeout(1000)
===== Parameters =====
<blockquote>timeout Required

● number - The time that the timer should wait before the callback function is executed
</blockquote>
==== ClearInterval ====
Function to cancel the timed repeating call which was previously established through SetInterval

e.g. ClearInterval(1000)
===== Parameters =====
<blockquote>interval Required

● number - The delay between the execution of the function
</blockquote>
==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Domless SDK API Reference

2026-01-27T21:23:27Z

AmySockanathan: Implementation Hooks: Added settimeout, setinterval, cleartimeout and clearinterval

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.setItem('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.setItem(key: string, value: string)

getItem()

storage.getItem(key: string)

removeItem()

storage.removeItem(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

==== SetTimeout ====
Function to set a timer to execute a block of code on expiry

e.g. SetTimeout(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to execute when the timer expires

timeout Required

● number - The time that the timer should wait before the callback function is executed
</blockquote>
==== SetInterval ====
Function to repeatedly call a function with a fixed time delay between each call.

e.g. SetInterval(callback , 1000)
===== Parameters =====
<blockquote>callback Required

● A function to be executed every interval specified

interval Required

● number - The delay between the execution of the function
</blockquote>
==== ClearTimeout ====
Function to cancel the timeout previously set by SetTimeout

e.g. ClearTimeout(1000)
===== Parameters =====
<blockquote>timeout Required

● number - The time that the timer should wait before the callback function is executed
</blockquote>
==== ClearInterval ====
Function to cancel the timed repeating call which was previously established through SetInterval

e.g. ClearInterval(1000)
===== Parameters =====
<blockquote>interval Required

● number - The delay between the execution of the function
</blockquote>
==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Domless SDK API Reference

2025-11-25T13:45:34Z

AmySockanathan: /* storage */

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.setItem('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.setItem(key: string, value: string)

getItem()

storage.getItem(key: string)

removeItem()

storage.removeItem(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Domless SDK API Reference

2025-11-25T13:17:19Z

AmySockanathan: /* Methods */

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.set('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.setItem(key: string, value: string)

getItem()

storage.getItem(key: string)

removeItem()

storage.removeItem(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Domless SDK API Reference

2025-11-25T00:55:22Z

AmySockanathan: Replace Storage set, get and remove function names with setItem, getItem and removeItem.

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.set('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>setItem()

storage.set(key: string, value: string)

getItem()

storage.get(key: string)

removeItem()

storage.remove(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}

Third Party Encoding Facilities

2025-08-28T17:12:25Z

AmySockanathan: Creating new page for Third Party Encoding Facilities

This is a test page

TV

2025-08-28T17:11:20Z

AmySockanathan: Adding section for Third Party Encoding Faclities

[[Category:TV]]
{{Banner|Encoder Support|{{Breadcrumb|}} {{CurrentBreadcrumb}}}}





{{Alert|
'''Nielsen Encoder Installation and Configuration Policy 2022 Now Available:''' 
'''Official release notification: [https://nielsendownloads.digitalengsdk.com/tv/Nielsen-Encoder-Policy-Rev-H-2025-03.pdf.pdf Nielsen Encoder Installation and Configuration Policy 2025]

}}

{| class="wikitable"
|-
! style="width: 50px;" |
! Certified Vendors
|-
| rowspan="1" |
| '''[[Nielsen Encoder Certified Vendors]]'''
|-
| rowspan="1" |
| '''[[Nielsen Decoder Certified Vendors]]'''
|-
| rowspan="1" |
| '''[[PCM-to-ID3 Certified Vendors]]'''
|-
|}
{| class="wikitable"
|-
! style="width: 50px;" |
! Third Party Encoding Facilities
|-
| rowspan="1" |
| '''[[Third Party Encoding Facilities]]'''
|-
|}

{| class="wikitable"
|-
! style="width: 50px;" |
! Reference & Policy Supplements
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads.digitalengsdk.com/tv/Nielsen-Encoder-Policy-Rev-H-2025-03.pdf.pdf Nielsen Encoder Installation and Configuration Policy 2025]'''
|-



|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads.digitalengsdk.com/tv/Encoding/Nielsen+Encoder+Solutions+2024.pdf Nielsen Encoder Solutions 2024]'''
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads-blue.digitalengsdk.com/tv/Encoding/MVPD%20provided%20Direct%20Feeds%20with%20Unique%20Commercial%20Content.pdf MVPD provided Direct Feeds with Unique Commercial Content]'''
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads-blue.digitalengsdk.com/tv/Encoder%20Alert%20Distribution%20List%20Instructions_Final.pdf Nielsen Encoder Alert Distribution List - Instructions]'''
|}

{{CategoryIcon|EncodingIcon.png|TV Audio Encoding}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download
|-

| {{SmallIcon|CircuitIcon.png}}
| '''[[NWE-3GA]]''' || {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=NWE-3GA Software package Rev 2.5.0.0 |dlid= 5a3f0ecbef6bfe4c9339fb8346a0064a645ebebf}} ''('''New!''')''

|-


|-
| {{SmallIcon|RackIcon.png}}
| '''[[NWE-TS]]'''
|| {{OSIcon|FirmwareIcon.png}} ||

{{TVDownloadRequestLink|name=NWE-TS Firmware 4.8.1|dlid=ee2f22f3a7347b52627e2d393fab7f3d90d90943}} ''('''New!''')''
{{TVDownloadRequestLink|name=NWE-TS Firmware 4.6.10|dlid=31e04631784a2438fc41c81f34a49c33cd513ec6}}

|-

| {{SmallIcon|VODIcon.png}}
| '''[[VOD Content Encoder]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*[[Encoder Downloads| VOD Content Encoder]]

|-

| {{SmallIcon|VODIcon.png}}
| '''[[VOD in TV Ratings]]''' ''(formerly RTVOD)''
|| {{OSIcon|WindowsIcon.png}} ||
*[[Encoder Downloads| VOD in TV Ratings]] ''(formerly RTVOD)''

|-

| {{SmallIcon|ComputerWaveIcon.png}}
| '''[[SpoTTrac®]]'''
|| {{OSIcon|FirmwareIcon.png}} ||
*[[Encoder Downloads| SpoTTrac Firmware]]

|-

| {{SmallIcon|EncoderGrayIcon.png}}
| '''[[NAVE II]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*NAVE II Firmware v38
*NAVE II Manager
|-

| {{SmallIcon|EncoderGrayIcon.png}}
| '''[[NAVE IIC]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*NAVE IIC Firmware v3.4.15
|}

{{CategoryIcon|ID3Icon.png|ID3 Transcoding}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download

|-

|rowspan="3"| {{SmallIcon|ID3XcodeIcon.png}}
|rowspan="3"| '''[[ID3 Transcoders]]'''
''(Click for Documentation, Software Updates, and Test Streams)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Windows) v2.3.2|dlid=ac5b0e72a84b1a6e86da1a8fe0a89e24083468eb}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Windows Visual Studio 2013) v2.3|dlid=533cee44e69c6859e56acd9cbb38334d6b215c00}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x64 GLIBC 2.12) v2.3.2|dlid=c499535f6ce9a0326a408b167079e01a0596e141}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x64 GLIBC 2.17) v2.3.2|dlid=b353e404994a1d26726b196960efe40c30427571}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x86 GLIBC 2.17) v2.3.2|dlid=f82dfbde6f5f68ccf677b63e32fc83e68fa82cd6}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (MacOS) v2.3|dlid=3a9d04be165f39ac956278c8292cd1b87ce34b62}}

|-
|rowspan="1"| {{SmallIcon|ID3DashIcon.png}}
|rowspan="1"| '''[[ID3 in MPEG-DASH]]'''
''(Click for Documentation, and Sample Audio Files)''
|| {{OSIcon|StaticIcon.png}} ||
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/bbb-MPEG-DASH.zip Big Buck Bunny MPEG-DASH Nielsen Tagged]
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/nielsenconsumer-MPEG-DASH.zip Nielsen Consumer MPEG-DASH Nielsen Tagged]
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/nielsenxplatform-MPEG-DASH.zip Nielsen Cross Platform MPEG-DASH Nielsen Tagged]
|-

|rowspan="3"| {{SmallIcon|ID3ValidateIcon.png}}
|rowspan="3"| '''[[PCM-to-ID3 Validator]]'''
''(Click for Documentation, and Downloads)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (Windows) v1.8|dlid=67d34c64d1ed349c1ad92ac47adf62c877f47fcb}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (CentOS) v1.7|dlid=dd6b62c76995aa7e1702c60e02076348ceaf573b}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (MacOS) v1.7|dlid=3afc5a7ec29593e2eb47daa9746b6d16cbd785e1}}

|-

|rowspan="3"| {{SmallIcon|ID3ValidateIcon.png}}
|rowspan="3"| '''[[PCM-to-ID3 Validator SDK]]'''
''(Click for Documentation, and Downloads)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (Windows) v1.8|dlid=78a936556ebc5caf57d2fc4d09de3a272ace9fea}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (CentOS) v1.7|dlid=ccb9af4ef45cfcf7aa4406ca63ab3b7c6efdad11}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (MacOS) v1.7|dlid=05e99551d28ef4a65eab6168ad2872648346aab2}}
|}

{{CategoryIcon|DiagnosisToolsIcon.png|Diagnostic Tools}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download

|-

| {{SmallIcon|NACATIcon.png}}
|| '''[[Nielsen Audio Code Analysis Tool 3 for TV|Nielsen Audio Code Analysis Tool 3 (NACAT3)]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=NACAT3 3.0.0.1|dlid=ce2cba3d4b4231a0978c632028c1a45479a8184d}} ''('''New!''')''

|-

| {{SmallIcon|NDICEIcon.png}}
|| '''[[Nielsen Digital Code Extractor]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Nielsen Digital Code Extractor Installer|dlid=c0eb8eb1802bd08956f6e215473ef1881274a6df}} (See special installation instructions in [[Nielsen Digital Code Extractor|guide]])

|-

|rowspan="3"| {{SmallIcon|SDKIcon.png}}
|rowspan="3"| '''[[Decoder SDK Monitor]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (Windows vs2017) v1.4|dlid=b3ae411765cfa2b878c3f50c0824e61d81a58fbb}}
|-
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (Windows vs2015) v1.4|dlid=68d1fd697862e663a7aa2efc46377f053c983a5a}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (CentOS) v1.4|dlid=c978921ba90736bf7f2c82287a0a97af89109bec}}

|-

| {{SmallIcon|NDICEIcon.png}}
|| '''[[Nielsen Monitor Application]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Nielsen Monitor Application (Windows) v1.4|dlid=6ddf77a8f67dff67b4cbad1fee630ee80318b5bf}}

|}

Digital Measurement Android Artifactory Guide

2025-08-14T18:06:46Z

AmySockanathan: Update "grade" to "gradle"

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|Digital Downloads}} {{CurrentBreadcrumb}}
[[Category:Digital]]
__NOTOC__
The Nielsen AppSDK can either be downloaded directly from the [http://engineeringportal.nielsen.com Engineering Portal], or can be integrated directly within an application through the use of a CocoaPod or Gradle.

= How to install the Nielsen AppSDK using Gradle for Android =
Below are the steps which need to be performed by app developers to integrate the Nielsen App SDK within an Android application.

== Add Nielsen Maven Repository ==

Please add the Nielsen maven repository inside the repositories section of your app's module build.gradle file like below:
 
<source lang="android">
repositories {
//Copy below code inside repository section of app’s build.gradle file
maven { url 'https://raw.githubusercontent.com/NielsenDigitalSDK/nielsenappsdk-android/master/'
}
</source>
 
<blockquote>
[[Image:AlertIcon.png|left|60px|link=|class=smallIcon]] Starting on Sept 21, 2021 the Nielsen SDK has moved to a public repository. Credentials are no longer required.
</blockquote>
 

== Add gradle dependency ==

Please add Nielsen app SDK as compile time dependency inside build.gradle file as below
=== gradle 4.x and above ===
For gradle version starting with 4.x add the following line inside dependencies section of build.gradle file. 
<source lang="html">implementation 'com.nielsenappsdk.${market}:${flavor}:${version}'</source>
 
<source lang="html">
dependencies { ....
implementation 'com.nielsenappsdk.global:ad:+' // Using + will provide the latest version
}
</source>

=== gradle prior to 4.x ===
For gradle version previous to 4.x add below line inside dependencies section of build.gradle file.
<source lang="html">compile 'com.nielsenappsdk.${market}:${flavor}:${version}'</source>
 
<source lang="html">
dependencies { ....
compile 'com.nielsenappsdk.global:ad:+' // Using + will provide the latest version
}
</source>

== Version and Flavor Control ==
With version 8.1.0.0+ of the Nielsen appSDK, it is possible to request a specific '''${flavor}''' that reads the '''Google Ad ID''', '''Android ID''', or is '''Kid app''' friendly (noID). For example: 
<source lang="html">implementation 'com.nielsenappsdk.${market}:${flavor}:${version}'</source>
* if the flavor selected is equal to <code>ad</code> the Nielsen SDK will try to obtain the googleAdID if the user has not opted out.
* If the flavor is <code>noad</code> then the Nielsen SDK will attempt to obtain the AndroidID.
* If the flavor selected is <code>noid</code> then the Nielsen SDK will not request any identifier which is required for many kid apps.
<blockquote>To ensure backward compatability, <code> implementation 'com.nielsenappsdk:${market}:${version}'</code> will continue to be supported.</blockquote>
{| class="wikitable"
|-
! SDK Version
! ${market}
! ${flavor}
! ${version}
! Examples
|-
| Appsdk 8.1.0.0+
|<code>global</code> <code>agf</code>
|<code>ad</code> <code>noad</code> <code>noid</code>
| + is most recent version <code>8.1.0.0</code>
|<code>'com.nielsenappsdk.global:ad:+' 'com.nielsenappsdk.global:noad:+' 'com.nielsenappsdk.global:noad:8.1.0.0'</code>
|-
| AppSDK 7 to 8.0.0.0
|<code>globalx</code> <code>global</code> <code>agf</code> <code>agfx</code>
|not used
| + is most recent version <code>7.1.0.0</code> <code>8.0.0.0</code>
|<code>'com.nielsenappsdk:globalx:+' 'com.nielsenappsdk:global:8.0.0.0' 'com.nielsenappsdk:agf:8.0.0.0'</code> 
|}
<blockquote>If using version control, a warning message will be displayed within the console trace during the build of your app,
and it will show all sdk versions released to-date, allowing a developer to select a more recent build if desired. </blockquote> Starting with Version 8.x, the Nielsen SDK will only support Androidx.

== Ensuring you have the latest release information ==
It is recommended to use <code>+</code> for <code>${version}</code> to ensure you receive the most recent version of the NielsenSDK; however, if you are specifying the exact version of the SDK, please use only the first 3 digits. EG: 8.1.0 

A sample if using AppSDK 8.1.0.0 + would be:
<source lang="html">
dependencies { ....
implementation 'com.nielsenappsdk.global:ad:+'
}
</source>
 
If using AppSDK 7 to 8.0.0.0
<source lang="html">
dependencies { ....
implementation 'com.nielsenappsdk:globalx:8.0.0'
}
</source>

In addition, please add below gradle task inside your <code> build.gradle (Module:app)</code> or <code>build.gradle(Project:My-app)</code> file to fetch latest release details of nielsen app sdk as below:

<blockquote>Please note: The <code> build.gradle (Module:app)</code> can overwrite the <code>build.gradle(Project:My-app)</code>.</blockquote>

<source lang="java">task NielsenSdkReleaseCheck {
def p = ['curl',"https://raw.githubusercontent.com/NielsenDigitalSDK/" +
"nielsenappsdk-android/master/com/nielsenappsdk/global/" +
"NielsenAppSdk-ReadMe.md"].execute().text
project.logger.log(LogLevel.ERROR,p)
}
preBuild.dependsOn('NielsenSdkReleaseCheck')
</source>

=== App Suffix Reference ===
The Nielsen AppSDK has various configurations per market and distribution type, which can be determined by reviewing the [[Digital Measurement Android Suffix Guide|sdk suffix]]. The first part will be the SDK version: 3 digits for the major SDK version and 1 digit for the minor SDK version. EG: <code>aa.8.1.0.0_abc</code>

== Sync ==

If you are finished with all previous steps then you can sync your build.gradle and after successful build you are ready to use Nielsen App SDK library in your code.

== Sample file ==
The below is an example of a very basic app build.gradle file
<syntaxhighlight lang=Java>
plugins {
id 'com.android.application'
}

android {
compileSdkVersion 30
buildToolsVersion "30.0.3"

defaultConfig {
applicationId "com.nielsen.simplestandardandroidart"
minSdkVersion 23
targetSdkVersion 30
versionCode 1
versionName "1.0"

testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}

buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
}
}
repositories {
//Copy below code inside repository section of app’s build.gradle file
maven { url 'https://raw.githubusercontent.com/NielsenDigitalSDK/nielsenappsdk-android/master/'
}
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}

dependencies {

implementation 'androidx.appcompat:appcompat:1.2.0'
implementation 'com.google.android.material:material:1.1.0'
implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
testImplementation 'junit:junit:4.+'
androidTestImplementation 'androidx.test.ext:junit:1.1.2'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.3.0'
implementation 'androidx.lifecycle:lifecycle-extensions:2.2.0'
implementation 'com.google.android.gms:play-services-ads:20.3.0'
implementation 'com.nielsenappsdk.global:ad:+'
}

task NielsenSdkReleaseCheck {
def p = ['curl',"https://raw.githubusercontent.com/NielsenDigitalSDK/" +
"nielsenappsdk-android/master/com/nielsenappsdk/global/" +
"NielsenAppSdk-ReadMe.md"].execute().text
project.logger.log(LogLevel.ERROR,p)
}
preBuild.dependsOn('NielsenSdkReleaseCheck')
</syntaxhighlight>

Template:Browser Privacy and Opt-Out

2025-08-05T20:46:45Z

AmySockanathan: Remove Opt Out Overview

== Privacy and Opt-Out ==
There are two primary methods for implementing user Opt-out preferences:
# [[#User Opt Out|User Opt Out]] - Provide a link to the Nielsen Privacy Policy page when a User can make their selection
# [[#Initialization Opt Out|Initialization Opt Out]] - Global OptOut Parameter

=== User Opt Out ===
The site must provide a means for the user to opt-out of, or opt back into, Nielsen Measurement. A user can opt-out if they would prefer not to participate in any Nielsen online measurement research. To implement the User Opt-Out option, include the following two items in your privacy policy.
*A notice that the player (or page in relation to static measurement) includes proprietary measurement software that allows users to contribute to market research (such as Nielsen TV Ratings).
*A link to the Nielsen Digital Measurement Privacy Policy at https://www.nielsen.com/digitalprivacy

On the Nielsen Digital Measurement Privacy Policy page, users can click Choices to read more detailed information about the measurement software, learn about their options with regard to Nielsen measurement, and, if they do not want to participate in Nielsen online measurement, click a link to opt-out.

The following paragraph is a template for a Privacy Statement.
<blockquote>
The properties may feature Nielsen proprietary measurement software, which will allow users to contribute to market research, such as Nielsen TV Ratings. To learn more about the information that Nielsen software may collect and your choices with regard to it, please see the Nielsen Digital Measurement Privacy Policy at https://www.nielsen.com/digitalprivacy
</blockquote>

==== User Opt Back In ====
Once users have opted-out, they can choose to opt back into Nielsen Measurement at anytime by selecting the opt back in link on the Nielsen Digital Privacy Policy page. When a user selects the link, they will be able to be measured.

=== Initialization Opt Out ===
The BSDK600 now supports the ability to optout on initialization of the SDK by allowing an optout global parameter to be passed. This optout will be maintained through the session of the SDK instance. Specifications and limitations are specified below.

{| class="wikitable"
|-
! Type
! Supported Values
! Notes
! Optout
|-
||optout||True, Yes, or 1|| Case is insensitive and can be string or bool
Example: nlsQ("XXXXXXXX-BH45-JKY6-BKH7-67GJKY68GJK7", "myInstance", { optout: true});
|| Ping parameter will set uoo=true.
|-
||optout|| False, No, or 0 || Case is insensitive and can be string or bool
Example: nlsQ("XXXXXXXX-BH45-JKY6-BKH7-67GJKY68GJK7", "myInstance", { optout: false});
|| Ping parameter will set uoo to blank.
|-
|}
==== Example of using OptOut ====

<syntaxhighlight lang="javascript">
var nSdkInstance = NOLBUNDLE.nlsQ("XXXXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX", "nlsnInstance", {
nol_sdkDebug: "debug",
optout: "true"
});
</syntaxhighlight>

Template:Browser Privacy and Opt-Out

2025-08-05T20:45:34Z

AmySockanathan: Remove details of optout process

TV

2025-07-23T19:49:58Z

AmySockanathan: Changed link to Nielsen Audio Code Analysis Tool 3 to TV page

[[Category:TV]]
{{Banner|Encoder Support|{{Breadcrumb|}} {{CurrentBreadcrumb}}}}





{{Alert|
'''Nielsen Encoder Installation and Configuration Policy 2022 Now Available:''' 
'''Official release notification: [https://nielsendownloads.digitalengsdk.com/tv/Nielsen-Encoder-Policy-Rev-H-2025-03.pdf.pdf Nielsen Encoder Installation and Configuration Policy 2025]

}}

{| class="wikitable"
|-
! style="width: 50px;" |
! Certified Vendors
|-
| rowspan="1" |
| '''[[Nielsen Encoder Certified Vendors]]'''
|-
| rowspan="1" |
| '''[[Nielsen Decoder Certified Vendors]]'''
|-
| rowspan="1" |
| '''[[PCM-to-ID3 Certified Vendors]]'''
|-
|}

{| class="wikitable"
|-
! style="width: 50px;" |
! Reference & Policy Supplements
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads.digitalengsdk.com/tv/Nielsen-Encoder-Policy-Rev-H-2025-03.pdf.pdf Nielsen Encoder Installation and Configuration Policy 2025]'''
|-



|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads.digitalengsdk.com/tv/Encoding/Nielsen+Encoder+Solutions+2024.pdf Nielsen Encoder Solutions 2024]'''
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads-blue.digitalengsdk.com/tv/Encoding/MVPD%20provided%20Direct%20Feeds%20with%20Unique%20Commercial%20Content.pdf MVPD provided Direct Feeds with Unique Commercial Content]'''
|-
| rowspan="1" | {{SmallIcon|PDFIcon.png}}
| '''[https://nielsendownloads-blue.digitalengsdk.com/tv/Encoder%20Alert%20Distribution%20List%20Instructions_Final.pdf Nielsen Encoder Alert Distribution List - Instructions]'''
|}

{{CategoryIcon|EncodingIcon.png|TV Audio Encoding}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download
|-

| {{SmallIcon|CircuitIcon.png}}
| '''[[NWE-3GA]]''' || {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=NWE-3GA Software package Rev 2.5.0.0 |dlid= 5a3f0ecbef6bfe4c9339fb8346a0064a645ebebf}} ''('''New!''')''

|-


|-
| {{SmallIcon|RackIcon.png}}
| '''[[NWE-TS]]'''
|| {{OSIcon|FirmwareIcon.png}} ||

{{TVDownloadRequestLink|name=NWE-TS Firmware 4.8.1|dlid=ee2f22f3a7347b52627e2d393fab7f3d90d90943}} ''('''New!''')''
{{TVDownloadRequestLink|name=NWE-TS Firmware 4.6.10|dlid=31e04631784a2438fc41c81f34a49c33cd513ec6}}

|-

| {{SmallIcon|VODIcon.png}}
| '''[[VOD Content Encoder]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*[[Encoder Downloads| VOD Content Encoder]]

|-

| {{SmallIcon|VODIcon.png}}
| '''[[VOD in TV Ratings]]''' ''(formerly RTVOD)''
|| {{OSIcon|WindowsIcon.png}} ||
*[[Encoder Downloads| VOD in TV Ratings]] ''(formerly RTVOD)''

|-

| {{SmallIcon|ComputerWaveIcon.png}}
| '''[[SpoTTrac®]]'''
|| {{OSIcon|FirmwareIcon.png}} ||
*[[Encoder Downloads| SpoTTrac Firmware]]

|-

| {{SmallIcon|EncoderGrayIcon.png}}
| '''[[NAVE II]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*NAVE II Firmware v38
*NAVE II Manager
|-

| {{SmallIcon|EncoderGrayIcon.png}}
| '''[[NAVE IIC]]'''
|| {{OSIcon|WindowsIcon.png}} ||
*NAVE IIC Firmware v3.4.15
|}

{{CategoryIcon|ID3Icon.png|ID3 Transcoding}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download

|-

|rowspan="3"| {{SmallIcon|ID3XcodeIcon.png}}
|rowspan="3"| '''[[ID3 Transcoders]]'''
''(Click for Documentation, Software Updates, and Test Streams)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Windows) v2.3.2|dlid=ac5b0e72a84b1a6e86da1a8fe0a89e24083468eb}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Windows Visual Studio 2013) v2.3|dlid=533cee44e69c6859e56acd9cbb38334d6b215c00}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x64 GLIBC 2.12) v2.3.2|dlid=c499535f6ce9a0326a408b167079e01a0596e141}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x64 GLIBC 2.17) v2.3.2|dlid=b353e404994a1d26726b196960efe40c30427571}}
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (Linux x86 GLIBC 2.17) v2.3.2|dlid=f82dfbde6f5f68ccf677b63e32fc83e68fa82cd6}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 SDK (MacOS) v2.3|dlid=3a9d04be165f39ac956278c8292cd1b87ce34b62}}

|-
|rowspan="1"| {{SmallIcon|ID3DashIcon.png}}
|rowspan="1"| '''[[ID3 in MPEG-DASH]]'''
''(Click for Documentation, and Sample Audio Files)''
|| {{OSIcon|StaticIcon.png}} ||
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/bbb-MPEG-DASH.zip Big Buck Bunny MPEG-DASH Nielsen Tagged]
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/nielsenconsumer-MPEG-DASH.zip Nielsen Consumer MPEG-DASH Nielsen Tagged]
*[https://nielsendownloads-blue.digitalengsdk.com/tv/ID3%20Transcoding/ID3%20in%20MPEG-DASH/nielsenxplatform-MPEG-DASH.zip Nielsen Cross Platform MPEG-DASH Nielsen Tagged]
|-

|rowspan="3"| {{SmallIcon|ID3ValidateIcon.png}}
|rowspan="3"| '''[[PCM-to-ID3 Validator]]'''
''(Click for Documentation, and Downloads)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (Windows) v1.8|dlid=67d34c64d1ed349c1ad92ac47adf62c877f47fcb}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (CentOS) v1.7|dlid=dd6b62c76995aa7e1702c60e02076348ceaf573b}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator (MacOS) v1.7|dlid=3afc5a7ec29593e2eb47daa9746b6d16cbd785e1}}

|-

|rowspan="3"| {{SmallIcon|ID3ValidateIcon.png}}
|rowspan="3"| '''[[PCM-to-ID3 Validator SDK]]'''
''(Click for Documentation, and Downloads)''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (Windows) v1.8|dlid=78a936556ebc5caf57d2fc4d09de3a272ace9fea}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (CentOS) v1.7|dlid=ccb9af4ef45cfcf7aa4406ca63ab3b7c6efdad11}}
|-
|| {{OSIcon|macOSIcon.png}} ||
{{TVDownloadRequestLink|name=PCM-to-ID3 Validator SDK (MacOS) v1.7|dlid=05e99551d28ef4a65eab6168ad2872648346aab2}}
|}

{{CategoryIcon|DiagnosisToolsIcon.png|Diagnostic Tools}}
{| class="wikitable"
|-
! style="width: 75px;" |
! style="width: 35%;" | Software
! style="width: 45px;" | OS
! Download

|-

| {{SmallIcon|NACATIcon.png}}
|| '''[[Nielsen Audio Code Analysis Tool 3 for TV|Nielsen Audio Code Analysis Tool 3 (NACAT3)]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=NACAT3 3.0.0.1|dlid=ce2cba3d4b4231a0978c632028c1a45479a8184d}} ''('''New!''')''

|-

| {{SmallIcon|NDICEIcon.png}}
|| '''[[Nielsen Digital Code Extractor]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Nielsen Digital Code Extractor Installer|dlid=c0eb8eb1802bd08956f6e215473ef1881274a6df}} (See special installation instructions in [[Nielsen Digital Code Extractor|guide]])

|-

|rowspan="3"| {{SmallIcon|SDKIcon.png}}
|rowspan="3"| '''[[Decoder SDK Monitor]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (Windows vs2017) v1.4|dlid=b3ae411765cfa2b878c3f50c0824e61d81a58fbb}}
|-
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (Windows vs2015) v1.4|dlid=68d1fd697862e663a7aa2efc46377f053c983a5a}}
|-
|| {{OSIcon|LinuxIcon.png}} ||
{{TVDownloadRequestLink|name=Decoder SDK Monitor (CentOS) v1.4|dlid=c978921ba90736bf7f2c82287a0a97af89109bec}}

|-

| {{SmallIcon|NDICEIcon.png}}
|| '''[[Nielsen Monitor Application]]'''
|| {{OSIcon|WindowsIcon.png}} ||
{{TVDownloadRequestLink|name=Nielsen Monitor Application (Windows) v1.4|dlid=6ddf77a8f67dff67b4cbad1fee630ee80318b5bf}}

|}

Nielsen Audio Code Analysis Tool 3 for TV

2025-07-23T18:58:29Z

AmySockanathan: /* Software Downloads */

[[Category:TV]]
{{Breadcrumb|}} {{Breadcrumb|TV}} {{CurrentBreadcrumb}}

''' NACAT3® — Nielsen Audio Code Analysis Tool''' — The Nielsen Company has developed NACAT, a Microsoft® Windows 10/11 operating system (64-bit) PC tool to aid in diagnosing audio watermarks embedded in an audio stream.

NACAT is a Graphical User Interface (GUI) application that captures audio, extracts Nielsen codes from that audio, decodes Nielsen audio codes (including UCC), and reports the extracted audio codes.
The Nielsen EVS department uses the NACAT application for monitoring, assisting in troubleshooting, and verifying NAVE encoder installations.

'''This release has significant enhancements.'''

This version incorporates Decoder SDK v6.0.16 with its underlying UCC/Commercial Codes and sub-minute capabilities.

Enhancements include decode, display, and log both the left and right channels simultaneously for more complete monitoring. NACAT3® enables decoding of all 6 channels.

NACAT 3 for Radio requires the use of a code mapping file (SIDMAP). To request a SIDMAP file that contains the mapping for your station/station groups audio codes, please email encoding@nielsen.com. You will need to provide the list of station call letters or station ownership for the codes you’re requesting.

== Documentation ==
*[https://nielsendownloads.digitalengsdk.com/radio/Diagnostic+Tools/NACAT3%C2%AE+%E2%80%94+Nielsen+Audio+Code+Analysis+Tool.pdf NACAT3® Product Overview]

== Software Downloads ==
{{TVDownloadRequestLink|name=NACAT3 3.0.0.1|dlid=ce2cba3d4b4231a0978c632028c1a45479a8184d}}

Nielsen Audio Code Analysis Tool 3 for TV

2025-07-23T18:45:17Z

AmySockanathan: NACAT3 - Nielsen Audio Code Analysis Tool page for TV

Browser SDK Release Notes

2025-07-15T16:26:42Z

AmySockanathan: Update Release notes

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{CurrentBreadcrumb}}
[[Category:Digital]]
__NOTOC__

== Release R1(v6.0.0.734) (07-08-2025) ==

* Support for DTVR Subminute feature

== Release V1(v6.0.110) (05-21-2024) ==

* Suppression of v60/v52/v53 legacy pings

== Release R2(v6.0.0.702) (10-30-2024) ==

* 2nd release of DOMless SDK
* Support DCR Static
* Support Debug interface which can be used to view API calls and SDK pings
* Support caching of pings when network is not available

== Release R1(v6.0.0.692) (07-31-2024) ==

* DOMless SDK Release with support for Amazon, ReactNative and other DOM less platforms

== Release R6(v6.0.0.673) (09-05-2023) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R5(v6.0.0.673) (08-14-2023) (AGF Release) ==

* Fix for stream id of stream 2 is populated in the last duration ping of stream 1 when mandatory END is not called

== Release R4(v6.0.0.672) (08-01-2023) ==

* Viewability build with support for Viewability and Audibility features

== Release R3(v6.0.0.663) (05-30-2023) ==

* Support to measure static on hbbtv with the iFrame fixes.

== Release R2(v.6.0.0.648) (05-03-2023) (AGF Release) ==

* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Fix to propagate correct starttm value in postroll content trailing ping
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R1.2(v6.0.0.662) (04-19-2023) ==
* Support to measure DCR static when browser sdk is initialized on parent page while video is played within the iFrame
* Support to measure DCR static on a Single Page Application when staticEnd is not called while navigating from one page to another

== Release R1(v6.0.0.648) (03-06-2023) ==
* SIVT support for DCR & DTVR
* StaticEnd support for Hybrid App

== Release R4(v6.0.0.623) (05-02-2022) ==
* Fix the 1st party cookie expiry date
* Fix first party id time to live parameter (nol_fpid_ttl) override
* Update the sessionURL in BSDK600 code with FPID parameters

== Release R3(v6.0.0.618) (03-29-2022) ==
* Fix to measure dcr static while video is in focus and within an iFrame
* Fix to propagate correct starttm value in postroll content trailing ping

== Release v6.0.0.355 ==
* Performance improvements through the use of cachable configuration via the Static Queue Snippet.
* Dynamic Configuration File
* Session Ping/UAID - A unique identifier of the device which allows for a single facebook ping per session.
* Support for iOS 12.2

== Release 5.1.0 (Build 2) ==
*Support for DCR Static Lite Measurement
*Advanced Dynamic Script Initialization
*Removal of Configuration file dependency

== Release 5.0.0 (Build 17) ==
*Support for Nielsen Digital Content Ratings (DCR) product
*Support for measurement of static content
*Support for Ad measurement
*Support for Facebook Pings
*Support for multiple instances of the SDK
*General bug fix and performance improvements

DTVR Domless SDK

2025-06-09T19:49:45Z

AmySockanathan: Add information about Implementation hooks

== License ==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [[Special:ClickThrough|here]], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== DOM-less SDK DTVR Video Introduction ==
The Nielsen DOM-less SDK is a Javascript based cross-platform library that clients can use to integrate the Nielsen Digital Content Rating or Digital TV Rating measurement in ReactNative or NodeJS apps.

The Digital TV Ratings (DTVR) product provides content consumption measurement on client mobile apps or webpages. This measurement includes insight into the total time a user spent watching the tracked content, video player events, and much more. This example provides the steps to implement the DTVR Video product in a sample NodeJS app. It includes:

* DOM-less SDK Initialization
* DTVR Metadata: information about the content being tracked
* DTVR Events/API calls

By the end of this guide you will have the needed steps to integrate Nielsen's DOM-less SDK in your app.

=== DOM-less SDK DTVR Video Step 1 - Obtain AppID ===
To begin using the DOM-less SDK you will need to obtain an Application ID (AppId)
{| class="wikitable"
!
!Item
!Description
!Source
|-
|✅
|App ID (appid)
|Unique ID assigned to the player/site and configured by product
|Contact your Nielsen TAM
|}
The appid is a 37 character unique ID assigned to the player/site and configured by product and is required when creating a new instance of the DOM-less SDK on the app.

Example: '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX'''

=== DOM-less SDK DTVR Video Step 2 - SDK Initialization ===
This project is an API that allows clients to integrate the Nielsen SDK in DOM-less environments like React Native, NodeJS, etc.

Refer to the " [[Domless_SDK_API_Reference#DOM-less SDK Initialization|DOM-less SDK initialization]] " section in the [[Domless_SDK_API_Reference|DOM-less SDK API Reference Guide]].

==== SDK Initialization ====
The following table contains the list of arguments that can be passed
{| class="wikitable"
!Parameter / Argument
!Description
!Source
!Required?
!Example
|-
|appid
|Unique Nielsen ID for the application. The ID is a GUID data type. If you did not receive your App ID, let us know and we will provide you.
|Nielsen-specified
|Yes
|PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
|-
|instanceName
|DOM-less SDK instance name
|Client provided
|Yes
|String eg. abcdefg
|-
|appName
|Application name
|Client provided
|Yes
|appName: 'BSDK RN Sample App'
|-
|deviceId
|Device ID
|Client provided
|Yes
|deviceId: '38400000-8cf0-11bd-b23e-10b96e40000d'
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|Client-provided
|No
|nol_sdkDebug: 'debug'
|-
|domlessEnv
|Specify the domless environment.
"1" for ReactNative "2" for Amazon "3" for NodeJS "4" for Custom
|Client-provided
|Yes
|domlessEnv: '1'
|}

====Implementation Hooks====
Implementation hooks are essential for the DOM-less SDK to work as expected. Please refer to the "[[Domless_SDK_API_Reference#Implementation Hooks | Implementation Hooks]] " section in the [[Domless_SDK_API_Reference | DOM-less SDK API Reference Guide]].

====Nielsen Debug Node.js Server for Event Tracking====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

=== DOM-less SDK DTVR Video Step 3 - Create DTVR Metadata Object ===

==== Events that can be passed to `ggPM` method ====
1. <code>loadMetadata</code> - This event is used to send DTVR metadata to the Nielsen SDK. This event should be called when the video metadata is loaded.
instance.ggPM('loadMetadata', {
'type': 'content',
'adModel': '1'
});
2. <code>sendID3</code> - This event is used to send the id3 event to the Nielsen SDK. This event should be called when the id3 event is triggered, passing the id3 data from the stream.
instance.ggPM('sendID3', '<id3 metadata received>');
3. <code>end</code> - This event is used to send the end event to the Nielsen SDK. This event should be called when the video playback is finished, passing the playhead at that time.
instance.ggPM('end', 300);

====== Events that can be passed to and processed by <code>processEvent</code> method ======
1. <code>`blur`</code> - This event should be passed to processEvent when the app goes to the background.
instance.processEvent({'type': 'blur', 'timestamp': Date.now()});
2. <code>`focus`</code> - This event should be passed to processEvent when the app goes to the foreground.
instance.processEvent({'type': 'focus', 'timestamp': Date.now()});
3. <code>`appclose`</code> - This event should be passed prior to closing the app.
instance.processEvent({'type': 'appclose', 'timestamp': Date.now()});

===== ID3 Tags =====
ID3_Payload is the container to pass the retrieved ID3 tag from the stream. The player should look for 'PRIV' ID3 tags and send 'owner' field (which typically starts from "www.nielsen.com") through this API. Refer to DTVR Event Listeners section below for more information.

'''Sample ID3 Tags'''

<code>www.nielsen.com/X100zdCIGeIlgZnkYj6UvQ==/X100zdCIGeIlgZnkYj6UvQ==/AAAB2Jz2_k74GXSzx4npHuI_JwJd3QSUpW30rDkGTcbHEzIMWleCzM-uvNOP9fzJcQMWQLJqzXMCAxParOb5sGijSV9dNM3QiBniJYGZ5GI-lL1fXTTN0IgZ4iWBmeRiPpS9AAAAAAAAAAAAAAAAAAAAAFJWFM5SVhTONNU=/00000/00000/00

www.nielsen.com/X100zdCIGeIlgZnkYj6UvQ==/R8WHe7pEBeqBhu8jTeXydg==/AAICoyitYqlxT7n6aZ0oMCGheFi4CXFp46AMUPZz1lMr_M9tr3_cjee1SHqxrOiVerMDLeyn9xzocZSKwi746Re8vNOtpNCAZjYABs_J0R25IHpvOc1HS8QHGgD5TgOJeS6gX100zdCIGeIlgZnkYj6UvVJWFNhSVhTiPE0=/00000/46016/00
</code>

=== DOM-less SDK DTVR Step 4 - Basic Set of Events - Sample Playback ===

==== Sample Nielsen BSDK-Domless NodeJS Example ====

* [https://github.com/NielsenDigitalSDK/bsdk-domless-samples/tree/main/nodejs Nielsen bsdk-domless NodeJS Repository Example]

==== Sample DTVR Video Integration ====
<syntaxhighlight lang="javascript">
import { BsdkInstance } from 'bsdk-domless';
const nsdkConfig = {
app_id: 'PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX',
instance_name: 'videoInstance',
};
const implementationHooks = {
Log: {
info: function (log: string) {
console.info(log);
},
debug: function (log: string) {
console.debug(log);
},
warn: function (log: string) {
console.warn(log);
},
error: function (error: string) {
console.error(error);
}
},
Storage: {
setItem: async function (key: any, value: string) {
/**
* Sets a string value for given key. This operation can either modify an existing entry,
* if it did exist for given key, or add new one otherwise.
* In order to store object value, you need to serialize it, e.g. using JSON.stringify().
*/
},
getItem: async function (key: any) {
/**
* Gets a string value for given key. This function can either return a string value for
* existing key or return null otherwise.
* In order to store object value, you need to deserialize it, e.g. using JSON.parse().
*/
},
removeItem: async function (key: any) {
/**
* Removes item for a key, invokes (optional) callback once completed.
*/
}
},
Fetch: async function (url: string | URL | Request, options: any) {
/**
* We require that client pass in User-Agent header via options in Fetch request
*/
const clientOpts = {
headers: {
"User-Agent": "react-native-domless/1.6.7.42 Dalvik/2.1.0 (Linux; U; Android 5.1.1; Android SDK built for x86 Build/LMY48X)"
}
}
const data = Object.assign(options, clientOpts);
const response = await fetch(url, data);
if (response.ok) {
return response;
} else {
throw new Error('Request failed');
}
},
SetTimeout: function (callback: () => void, timeout: number | undefined) {
return setTimeout(callback, timeout);
},
SetInterval: function (callback: () => void, interval: number | undefined) {
return setInterval(callback, interval);
},
ClearTimeout: function (timeout: string | number | NodeJS.Timeout | undefined) {
return clearTimeout(timeout);
},
ClearInterval: function (interval: string | number | NodeJS.Timeout | undefined) {
return clearInterval(interval);
}
};
const nSdkInstance = new BsdkInstance(
nsdkConfig.app_id,
nsdkConfig.instance_name,
{
appName: 'BSDK RN Sample App',
deviceId: 'testDeviceId',
nol_sdkDebug: 'debug', // remove debug flag when going to production
domlessEnv: // "1" for React Native | "2" for Amazon | "3" for NodeJS | "4" for Custom
// reference SDK interface documentation
// for additonal metadata properties
},
implementationHooks
);
// Sample VideoPlayer component
const VideoPlayer = (props) => {
/**
* Implementation of video player component will vary across the board, for Nielsen DOM-less SDK integration
* clients need only setup event listeners with corresponding ggPM() calls.
* Please refer to chosen video player documentation on available events
*/
const video = useRef<Video>(null);
let previousPlayhead = 0; // keep track of previous playhead position
let metadataLoaded = false; // in case of replay scenario set flag for metadata load
// Sample video metadata
const videometadata = {
'type': 'content',
'adModel': '1'
}
const setUpEventListeners = (): void => {
video.addEventListener('ended', onEnded);
video.addEventListener('playing', onPlay);
video.addEventListener('metadata', onMetadata )
};

const onEnded = () => {
// Nielsen SDK ggPM 'end' event
if (nSdkInstance) {
nSdkInstance.then((instance: any) => {
instance.ggPM('end', Math.round(video.currentTime));
metadataLoaded = false;
});
}
};

// NOTE: some players may have an event when video metadata is loaded, recommended to use if available. E.g. loadedmetadata
const onPlay = () => {
// Nielsen SDK ggPM 'loadMetadata' event
if (nSdkInstance && !metadataLoaded) {
nSdkInstance.then((instance: any) => {
instance.ggPM('loadMetadata', videometadata);
metadataLoaded = true;
});
}
};

// NOTE: retireval of ID3 tags will vary by player and is primarily used for DTVR measurement
const onMetadata = (data) = {
if (data.metadata && data.metadata.key === 'PRIV') {
nSdkInstance.then(instance => {
instance.ggPM('sendID3', data.metadata.info);
});
}
};

return (
<View>
<Video
source={{ uri: 'https://www.w3schools.com/html/mov_bbb.mp4' }}
/>
</View>
);
};
</syntaxhighlight>

Domless SDK API Reference

2025-06-09T19:28:52Z

AmySockanathan: /* Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected. */

==License==
Nielsen SDK contains material that is protected by copyright laws, patent laws, trade secret laws, and by international treaty provisions and is Copyright © 2024 The Nielsen Company (US) LLC. All intellectual property rights and licenses therein are reserved by The Nielsen Company (US) LLC and its licensors. Please read the license agreement presented [https://engineeringportal.nielsen.com/wiki/Special:ClickThrough here], which must be accepted in order to download the Nielsen SDKs. For more information, reach out to your Nielsen Technical Account Manager(TAM).

== Overview ==
The Nielsen DOM-less SDK provides APIs that allows our clients to integrate the Nielsen SDK in DOM-less environments, e.g., React Native, Node, etc.

== DOM-less SDK Initialization ==

=== Obtain the Nielsen Application ID (apid) ===
The Nielsen <code>apid</code> is required to enable SDK functionality. Technical Account Manager will provide an apid for each player configuration. Browser SDK can support URLs that use any of the protocols – HTTPS and HTTP.

=== Configure the DOM-less SDK ===
====Installation====
Install with <code>npm install <nowiki>https://github.com/NielsenDigitalSDK/bsdk-domless</nowiki></code> and import the <code>BsdkInstance</code> into video player component
import { BsdkInstance } from 'bsdk-domless'
======status.ok()======
Initialization of the instance can be done with <code>status.ok()</code> function or use Promise handling approach
const instance = await new BsdkInstance(appID, instanceName, instanceMetadata, implementationHooks);

if (instance && instance.status.ok()) {
expect(instance).not.toBe(undefined);
expect(instance.status.ok()).toBe(true);
}

Note: ImplementationHooks are mandatory for the DOM-less SDK instance. Please refer to the ImplementationHooks section below for details.

====Exposed Interface====
The exposed interface is as follows:

1. <code>`ggPM`</code> - method to send messages to the Nielsen SDK

2. <code>`processEvent`</code> - method to send app state to the Nielsen SDK, e.g., focus, blur, appclose
=== Initialization Global Parameters ===
{| class="wikitable"
|+
!'''Parameter'''
!'''Description'''
!'''Value'''
|-
|apid
|UniqueID assigned to player/site.
|'XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName
|Name of SDK instance
|"any string value"
|-
|domlessEnv
|Type of Dom-less environment like ReactNative, Node, etc.
|"domlessEnv": "1", // For ReactNative
"domlessEnv": "2", // For Amazon

"domlessEnv": "3", // For NodeJS

“domlessEnv”: “4”, // For Custom
|-
|deviceId
|Device Identifier
|Alphanumeric string eg.
|-
|nol_sdkDebug
|Enables Nielsen console logging. Only required for testing
|"{nol_sdkDebug: "debug"})"
|-
|optout
|User optout status
|"true", "false"
|-
|hem_sha256
|SHA256-hashed email address (client-supplied unique 32-character hexadecimal string)
|"tMmiiTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_sha1
|SHA1-hashed email address (client-supplied unique 32-character hexadecimal string)
|"XvBniTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|hem_md5
|MD5-hashed email address (client-supplied unique 32-character hexadecimal string)
|"JnIbdTI7IaAcPpQPFQ65uMVCWH8av9jw4cwf/F5HVRQ="
|-
|uid2
|An identifier based on a user’s verifiable PII (e.g. hashed email). UID2.0 was initially created by The Trade Desk (TTD) and is now managed by Prebid.
|"MTKVpUAzwYAPnHrtfE0wlINOMzhU7UUEjjVdCdRu63k="
|-
|uid2_token
|Encrypted Unified ID 2.0
|"AgAAAAPFR0zA5ogv/yaAPiUsAdZPsfqS8Ql
DSGxAB+rr8yekFs3AjLYVk5qqqiyV2XHbSuwzHmxSlLeQeK QI1mp015jsNnpX5/xGgXldcgVz+gFnyh3T8/3agMwRmyrhC xG4oH2C7fc48AQk2eotE7FW0ZDEYM8fD9ZxDaxFUC/OV3OuZA&"
|-
|luid
|Living Unit ID - Experian Household ID
'''Note: This parameter is applicable only for CTV and First Party Livestream data'''
|"B0EOFEDgD"
|}

=== Implementation Hooks ===
This object captures the required entities for the DOM-less SDK to operate correctly. These are normally platform dependent and are expected to be passed on to the DOM-less SDK as part of its initialization. See below for the descriptions of each key.

==== '''log''' ====
Log the DOM-less SDK messages to an external stream, e.g. the browser console, stdout.

e.g. Log.debug('debug', 'NIELSEN TAGS EXPECTED TO FIRE:')

===== Methods =====
<blockquote>info()

Log.info(label: string, ...message: string[]): void

debug()

Log.debug(label: string, ...message: string[]): void

warn()

Log.warn(label: string, ...message: string[]): void

error()

Log.error(label: string, ...message: string[]): void</blockquote>

===== Parameters =====
<blockquote>label Required

● string - severity type, e.g. info, debug, warn, error or custom label

message Required

● string - message that will be output to the console</blockquote>

==== storage ====
Persistent storage of key/values, similar in behavior to browser localStorage.

e.g. storage.set('nol_lsid', 'umy3w4ik9usw2ppqmw2vkecckxfob1697308388')

===== Methods =====
<blockquote>set()

storage.set(key: string, value: string)

get()

storage.get(key: string)

remove()

storage.remove(key: string)

clear()

storage.clear()</blockquote>

==== fetch ====
Function to fetch resources from the network. Required for the transmission of the DOM-less SDK requests (pings) to the Nielsen endpoints.

e.g. Fetch(resource: string, options: object)

===== Parameters =====
<blockquote>resource Required

● A string that provides the URL of the resource to fetch

options Optional Object containing settings to apply to the request:

method

● string - request method: "GET", "POST". If one is not provided SDK will default to "GET"

headers

● object - headers to add to the outgoing request, an object literal with String values

body

● string - body to add to the request; SDK will send out string

mode

● string - mode for request: cors, no-cors, same-origin

referrer

● string - a string specifying the referrer of the request</blockquote>

====='''''<pre style="color: green; font-weight: bold; font-size: 20px">Note: Implementation Hooks are mandatory for the DOM-less SDK to function as expected.</pre>'''''=====

==== Nielsen Debug Node.js Server for Event Tracking ====
We are excited to announce the beta version of our Debug Node.js server, designed to track requests and events sent from our Dom-less SDK using WebSocket connections. While this feature is not officially released, we are currently looking for users interested in beta testing.

If you'd like to try this tool and provide feedback, please reach out to your Nielsen Technical Account Manager (TAM) for more information. Your insights would be invaluable in helping us refine this feature for a future release!

== DOM-less SDK API Methods & Properties ==
{| class="wikitable"
|+
!Method/Property
!Event #
!DTVR
!DAR
!DCR
!Description
|-
|[[play (Browser)|play]]
|5
|✔
|✘
|✔
|Used when there is an ID3 fed product such as DTVR and the client does not want to send in all the CMS metadata that is sent in loadMetadata. This allows the client to send in at least the required “channel name” value associated to the ID3 feed. When the client passes in the channelName, they can change the CMS data stored by passing new values. If this event is not called then the “channel name” value populated will be the default value of “defaultChannelName”.
|-
|[[stop (Browser)|stop]]
|7
|✘
|✘
|✔
|Used when switching between ad and content or content and ad.
|-
|[[loadMetadata (Browser)|loadMetadata]]
|15
|✔
|✔
|✔
|Used when there is a preroll ad that needs to be associated with content metadata. The loadMetadata will first be called to populate the content metadata values and then the loadMetadata for ad metadata will be called. This allows sending a content ping with the ad info, even if the user bails out during the preroll ad.
|-
|[[setPlayheadPosition (Browser)|setPlayheadPosition]]
|49
|✘
|✘
|✔
|Used to send the playhead position.
|-
|[[sendID3 (Browser)|sendID3]]
|55
|✔
|✘
|✘
|Used to send the ID3 metadata.
|-
|[[end (Browser)|end]]
|57
|✔
|✘
|✔
|This is triggered 1) at the end of the content stream, 2) if the user switches to another piece of content 3) when the browser is refreshed or closed
|-
|[[setVolume (Browser)|setVolume]]
|61
|✔
|✘
|✔
|Used to pass in the player volume levels in %. Default value is -1.
|-
|[[staticstart (Browser)|staticstart]]
|14
|✘
|✘
|✔
|Used to send the metadata for the static page.
|-
|[[StaticEnd (Browser)|staticend]]
|56
|✘
|✘
|✔
|In Single Page Application (SPA) it is imperative that staticend is called prior to the loading of new metadata. This allows the SDK to properly credit the previous section/content being viewed before measuring the new one.
|-
|[[onPaginate (Browser)|onPaginate]]
|30
|✘
|✘
|✔
|Used to initialize the SDK object
|}