View source for iOS Step By Step

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

Provided below are step-by-step quick start guides for implementing Nielsen iOS SDK for DCR Static, DCR Video, and DTVR products. Click each section to get started. 

== &rarr; iOS DCR Static ==
<span class="mw-customtoggle-myDivision" style="color: cornflowerblue"> Show/hide DCR Static </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision">

==== iOS DCR Static Introduction ====
<span class="mw-customtoggle-myDivisiona-" style="color: cornflowerblue"> Show/hide Intro </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisiona-">

The Digital Content Ratings (DCR) Static product provides content consumption measurement in client mobile apps and webpages. This measurement includes insight into the total time a user spent on a webpage, how they navigated through the page via links, and many other data points.
This tutorial provides the steps to implement the DCR Static product in a sample iOS app. It includes:

*SDK Initialization Call
*DCR Static Metadata: information about the sections being tracked

By the end of this guide you will have the needed steps to integrate Nielsen's AppSDK in the background of your app.
</div>

=== iOS DCR Static Step 1 - Obtain AppID ===
<span class="mw-customtoggle-myDivisiona1" style="color: cornflowerblue"> Show/hide step 1 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisiona1">

To begin using the iOS SDK (AppSDK) you will need to obtain an Application ID (AppId)

{| class="wikitable"
|-
! !! Item !! Description !! Source
|-
|&#9989; || 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 AppSDK in the app.
</br>Example: '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX'''

</div>

==== iOS DCR Static Step 2 - SDK Initialization ====
<span class="mw-customtoggle-myDivisionc" style="color: cornflowerblue"> Show/hide step 2 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionc">

==== How to obtain the NielsenAppApi.Framework ====
The Nielsen AppSDK can either be downloaded directly or can be integrated directly within an application through the use of CocoaPods. We recommend using the CocoaPods-based integration whenever possible to ensure you maintain the most recent changes and enhancements to the Nielsen libraries.
* [[Digital_Measurement_iOS_Artifactory_Guide|Select to obtain CocoaPods implementation guide]]
* [[Special:Downloads|Select to Download Directly]]

==== Configuring Xcode Development Environment ====
Starting with SDK version 6.0.0.0, the Nielsen App SDK is compatible with Apple iOS versions 8.0 and above.  In addition, when using the dynamic framework,  all the required frameworks are linked automatically as the are needed.  More details can be found here: https://stackoverflow.com/questions/24902787/dont-we-need-to-link-framework-to-xcode-project-anymore

<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

==== Download Framework ====
The first step is to download and copy the [[Special:Downloads|NielsenAppApi.framework]] bundle to the app project directory. (''Not required if using CocaPods'')

==== Add Framework ====
In the General tab for app configuration add NielsenAppApi.framework in the list of Embedded Binaries.  (''Not required if using CocaPods'')

==== Add Path ====
Add path to the NielsenAppApi.framework in the Framework Search Paths build setting.  (''Not required if using CocaPods'')

==== Import Framework ====
Add NielsenAppApi.framework module in the source file of your app:

==== Using Swift ====
Add the following:
<syntaxhighlight lang="swift">
import NielsenAppApi
</syntaxhighlight>

==== Using Objective-C ====
<syntaxhighlight lang ="objective-c">
@import NielsenAppApi;
</syntaxhighlight>

=== Sample SDK Initialization Code ===
{{ExampleCode|
|Swift  = 
Swift 4.0 Example:
<code>NielsenInit.swift</code>
<syntaxhighlight lang="swift">
import Foundation
import NielsenAppApi

class NielsenInit : NSObject {
    class func createNielsenApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{
        
        let appInformation:[String: String] = [
            "appid": "PDA7D5EE6-B1B8-4123-9277-2A788XXXXXXX",
            "sfcode": "dcr",
            "nol_devDebug": "DEBUG"
        ]       
        return NielsenAppApi(appInfo:appInformation, delegate:delegate)
    }
}
</syntaxhighlight>

Sample code using AVPlayer.
<code>LandingVC.swift</code>

<syntaxhighlight lang="swift">
import UIKit
import NielsenAppApi


class LandingVC: UIViewController, NielsenAppApiDelegate {
    
    var nielsenMain : NielsenAppApi!
    var sdkMethods : SDKMethods!
    var data : [String : Any]!

class ViewController: UIViewController, NielsenAppApiDelegate, AVPlayerViewControllerDelegate  {

// your code//    

  override func viewDidLoad() {
        super.viewDidLoad()
        //Getting the instance of NielsenApi
        self.nielsenApi = NielsenInit.createNielsenApi(delegate: self)
            }
  }
    override func viewDidAppear(_ animated: Bool) {      
        self.data = sdkMethods.loadStaticMaster()     // This is just an example of populating the metadata
        self.nielsenMain.loadMetadata(self.data)
    }
</syntaxhighlight>
|Objective C = 
Initialize the Nielsen App object within the viewDidLoad view controller delegate method using initWithAppInfo:delegate:
<blockquote>If App SDK is initialized using init or new methods, it will ignore the API calls resulting in no measurement. The SDK will not return any errors.</blockquote>
<syntaxhighlight lang="objective-c">    
#import "NielsenInit.h"
#import <NielsenAppApi/NielsenEventTracker.h>

@implementation NielsenInit

+ (NielsenAppApi *)createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate
{    
    //Initialising the NielsenEventTracker class by passing app information which returns the instance of NielsenEventTracker.
    
    NSDictionary *appInformation = @{ @"appid": @"PDA7D5EE6-B1B8-4123-9277-2A788XXXXXXX",
                            @"appversion": @"1.0",
                            @"sfcode": @"dcr",
                            @"nol_devDebug": @"DEBUG", };
    
    return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
}

@end
</syntaxhighlight>


The following would be the <code>NielsenInit.h</code> file:
<syntaxhighlight lang="objective-c">
#import <Foundation/Foundation.h>

@class NielsenAppApi;
@protocol NielsenAppApiDelegate;

@interface NielsenInit : NSObject

+ (NielsenAppApi *)createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate;

@end
</syntaxhighlight>
Sample Code:
<syntaxhighlight lang="objective-c">
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
        
    //Getting the instance of Nielsen SDK
    nielsenApi = [NielsenInit createNielsenAppApiWithDelegate:nil];
</syntaxhighlight>
}}


</div>

=== iOS DCR Static Step 3 - Create/Load DCR Static Metadata Object ===
<span class="mw-customtoggle-myDivisiond" style="color: cornflowerblue"> Show/hide step 3 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisiond">

==== Configure Metadata ====
Map the Nielsen keys to variables so that the content metadata is dynamically updated.

The Nielsen reserved keys are:
{| class="wikitable"
|-
! Key !! Description !! Data Type !! Value !! Required?
|-
| type || asset type || fixed || <code>'static'</code> || Yes
|-
| assetid || Unique ID for each article || dynamic || custom <br>(no [[Special Characters]]) || No
|-
| section || section of each site (e.g. section value should be first level in page URL: website.com/section). Limit to 25 unique values || dynamic || custom || Yes
|-
| segA || custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) || dynamic || custom || No
|-
| segB || custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) || dynamic || custom || No
|-
| segC || custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) || dynamic || custom || No
|}

The values passed through the Nielsen keys will determine the breakouts that are seen in reporting. The custom segments (A, B & C) will roll into the sub-brand. To not use custom segments A, B and C, do not pass any value in these keys.



==== Configure API calls - loadMetadata ====
Use [[loadMetadata]] to pass 'content' [[Digital Measurement Metadata]]. The CMS data must be passed as a JSON object.
<syntaxhighlight lang="java">    loadMetadata(JSONObject jsonMetadata);</syntaxhighlight>

<blockquote>Note: The [[loadMetadata]] call must have ("type": "static"). </blockquote>


Call [[loadMetadata]] with JSON metadata as below.
<syntaxhighlight lang="java">    new JSONObject()
        .put("type", "static")
        .put("section", "siteSection")
        .put("assetid", "vid345-67483")
        .put("segA", "segmentA")
        .put("segB", "segmentB")
        .put("segC","segmentC")
    }</syntaxhighlight>

As soon as this loadMetadata call is made, AppSDK will record a view event and start tracking the section/page time spent (AppSDK 9.1 and above).

==== DCR Static Duration Measurement per Section/Page/Asset ====
If your Nielsen AppID is enabled for DCR Static duration measurement, a view event will be recorded and a timer will be started for each screen/page. Duration will be measured until a new page is loaded or the app is moved to the background. The event which triggers recognition of page view and timer start is the loadMetadata API call with a metadata object of type 'static'. Once a page is viewed and the timer has started, duration will be measured until a new page has loaded ''with associated loadMetadata call having a different '''section name''' from the previous page''. If a new loadMetadata call is made with the same '''section name''', it will be ignored - no new view will be recorded. If it is desired to have a new view event even though the metadata contains the same '''section name''' (example: single-page apps having several assedIDs but common section name), staticEnd API can be called between page views. For the purposes of this overview, staticend will not be used. See [[DCR_Static_iOS_SDK|this page]] for more information. <br>


</div>

=== Keep Going ===
<span class="mw-customtoggle-myDivisiong" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisiong">

Congratulations, you've successfully integrated the iOS SDK in your app!

You can add static loadMetadata calls for more sections/pages in your app to see what happens when transitioning between sections.

View your application's debug logs and search for the term (AppSDK) to see messages emitted by Nielsen AppSDK.

</div>

=== Next Steps ===
<span class="mw-customtoggle-myDivisioni" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisioni">

Now that you've integrated DCR Static for the AppSDK, what's next?

====Going Live====

In addition to the basic steps above, before going live developers need to handle app background/foreground events, make certain privacy disclosures, and allow users to opt out of Nielsen measurement. More details can be found [[DCR_Static_iOS_SDK|here]], along with a more comprehensive reference for implementing DCR Static measurement with AppSDK.

Once the DCR Tracking Code is added, Nielsen will validate the implementation. Following Nielsen testing, developers need to make a few updates to the initialization call to ensure that the app is being measured properly.

#'''App ID''': Ensure that correct  is used during initialization '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'''
#'''Debug Logging''': Disable logging by changing initialization call to use @"nol_devDebug":@"INFO".





</div>


</div>

== &rarr; iOS DCR Video ==

<span class="mw-customtoggle-myDivision1" style="color: cornflowerblue"> Show/hide DCR Video </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision1">
==== iOS DCR Video Introduction ====
<span class="mw-customtoggle-myDivisionv2-" style="color: cornflowerblue"> Show/hide Intro </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv2-">

The Digital Content Ratings (DCR) Video product provides content consumption measurement in client mobile apps and 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 DCR Video product in a sample iOS app. It includes:

*SDK Initialization
*DCR Video Metadata: information about the content being tracked
*DCR Video Events/API calls

By the end of this guide you will have the needed steps to integrate Nielsen's AppSDK in the background of your app.

</div>

==== iOS DCR Video Step 1 - Obtain AppID ====
<span class="mw-customtoggle-myDivisionv3" style="color: cornflowerblue"> Show/hide step 1 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv3">

To begin using the iOS AppSDK, you will need to obtain an Application ID (AppId)

{| class="wikitable"
|-
! !! Item !! Description !! Source
|-
|&#9989; || App ID (appid) || Unique ID assigned to the player/site and configured by product || Contact your Nielsen Representative

|}

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 AppSDK in the app.
</br>Example: '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX'''

</div>

==== iOS DCR Video Step 2 - SDK Initialization ====
<span class="mw-customtoggle-myDivisionc" style="color: cornflowerblue"> Show/hide step 2 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionc">

===== How to obtain the NielsenAppApi.Framework =====
The Nielsen AppSDK can either be downloaded directly or can be integrated directly within an application through the use of CocoaPods. We recommend using the CocoaPods-based integration whenever possible to ensure you maintain the most recent changes and enhancements to the Nielsen libraries.
* [[Digital_Measurement_iOS_Artifactory_Guide|Select to obtain CocoaPods implementation guide]]
* [[Special:Downloads|Select to Download Directly]]

===== Configuring Xcode Development Environment =====
Starting with SDK version 6.0.0.0, the Nielsen App SDK is compatible with Apple iOS versions 8.0 and above.  In addition, when using the dynamic framework,  all the required frameworks are linked automatically as the are needed.  More details can be found here: https://stackoverflow.com/questions/24902787/dont-we-need-to-link-framework-to-xcode-project-anymore

<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

======= Download Framework =======
The first step is to download and copy the [[Special:Downloads|NielsenAppApi.framework]] bundle to the app project directory. (''Not required if using CocaPods'')

======= Add Framework =======
In the General tab for app configuration add NielsenAppApi.framework in the list of Embedded Binaries.  (''Not required if using CocaPods'')

======= Add Path =======
Add path to the NielsenAppApi.framework in the Framework Search Paths build setting.  (''Not required if using CocaPods'')

======= Import Framework =======
Add NielsenAppApi.framework module in the source file of your app:

======= Using Swift =======
Add the following:
<syntaxhighlight lang="swift">
import NielsenAppApi
</syntaxhighlight>

======= Using Objective-C =======
<syntaxhighlight lang ="objective-c">
@import NielsenAppApi;
</syntaxhighlight>

======= SDK Initialization =======

The following table contains the list of arguments that can be passed via the AppInfo JSON schema.
{| class="wikitable"
|-
! Parameter / Argument !! Description !! Source !! Required? !! Example
|--style="background-color:#d0f6f8;"
| 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
|--style="background-color:#d0f6f8;"
| nol_devDebug || Enables Nielsen console logging. Only required for testing <br>
|| Nielsen-specified || Optional || DEBUG
|}
==== Debug flag for development environment ====
Player application developers / integrators can use Debug flag to check whether an App SDK API call made is successful. To activate the Debug flag,
Pass the argument <code>@"nol_devDebug":@"DEBUG"</code>, in the JSON string . 

Once the flag is active, it logs each API call made and the data passed. The log created by this flag is minimal.
<blockquote>'''Note''': DO NOT activate the Debug flag in a production environment.</blockquote>

=== Swift Example ===
==== Sample SDK Initialization Code ====

<code>NielsenInit.swift</code>
<syntaxhighlight lang="swift">
class NielsenInit: NSObject {
    class func createNielsenAppApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{
    let appInformation:[String: String] = [
           "appid": "PE392366B-F2C1-4BC4-AB62-A7DAFDCXXXX",
           "nol_devDebug": "DEBUG"
        ]
        return NielsenAppApi(appInfo:appInformation, delegate:delegate)}}
</syntaxhighlight>

<br />
<code>ViewController.swift</code>

<syntaxhighlight lang="swift">
class ViewController: UIViewController, NielsenAppApiDelegate, AVPictureInPictureControllerDelegate, CLLocationManagerDelegate  {

    let avPlayerViewController = AVPlayerViewController()
    var avPlayer:AVPlayer?
    var nielsenAppApi: NielsenAppApi!

  override func viewDidLoad() {
        super.viewDidLoad()
        self.nielsenAppApi = NielsenInit.createNielsenAppApi(delegate: self)
        NSLog("Nielsen SDK initialized")
}}
</syntaxhighlight>

=== Objective C ===
==== Sample SDK Initialization Code ====
Initialize the Nielsen App object within the viewDidLoad view controller delegate method using initWithAppInfo:delegate:
<blockquote>If App SDK is initialized using init or new methods, it will ignore the API calls resulting in no measurement. The SDK will not return any errors.</blockquote>
<syntaxhighlight lang="objective-c">
#import "NlsAppApiFactory.h"
#import <NielsenAppApi/NielsenAppApi.h>

@implementation NlsAppApiFactory
+ (NielsenAppApi *)createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate;
{
    NSDictionary *appInformation = @{
                                     @"appid": "PE392366B-F2C1-4BC4-AB62-A7DAFDC51XXX",
                                     @"nol_devDebug": @"DEBUG"
                                     };
    return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
}
@end
</syntaxhighlight>


The following would be the <code>NlsAppApiFactory.h</code> file:
<syntaxhighlight lang="objective-c">
#import <Foundation/Foundation.h>

@class NielsenAppApi;
@protocol NielsenAppApiDeligate;
@interface NlsAppApiFactory : NSObject
+ (NielsenAppAPI *) createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate;
@end
}}
</syntaxhighlight>
<br>
The following might be in the <code>Viewcontroller.m</code>
<syntaxhighlight lang="objective-c">
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    //Setting background image
    UIImage *backgroundImage = [UIImage imageNamed:@"new_ios_bg.png"];
    UIImageView *backgroundImageView=[[UIImageView alloc]initWithFrame:self.view.frame];
    backgroundImageView.image=backgroundImage;
    [self.view insertSubview:backgroundImageView atIndex:0];
    
    //Mark: In NielsenInit class we are initialising the Nielsen SDK.
    
    //Getting the instance of Nielsen SDK
    nielsenApi = [NielsenInit createNielsenAppApiWithDelegate:nil];
}
 </syntaxhighlight>



</div>

==== iOS DCR Video Step 3 - Create DCR Video Content Metadata Object ====
<span class="mw-customtoggle-myDivisionv5" style="color: cornflowerblue"> Show/hide step 3 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv5">

===== Configure Metadata =====
The SDK methods handle only two types of objects: NSString, NSDictionary. The parameters passed must be either a JSON formatted string or a NSDictionary object. The JSON passed in the SDK must be well-formed.
* NSDictionary object
** If an object of unexpected type is passed to the method, the error message will be logged.
** If string has invalid JSON format, the error message will be logged.
* JSON value must be string value.
** This includes boolean and numeric values. For example, a value of true should be represented with "true", number value 123 should be "123".
** All the Nielsen Key names (e.g. appid, program) are case-sensitive. Use the correct variable name as specified in the documentation.
* JSON string can be prepared using either raw NSString or serialized NSDictionary.
<br>
===== Create channelName Metadata =====
channelName should remain constant throughout the completion of an episode or live stream.
<br />
{| class="wikitable"
|-
|--style="background-color:#d0f6f8;"
! Key !! Description !!	Values	 !! Required
|--style="background-color:#d0f6f8;"
| channelName	|| Any string representing the channel/stream	|| custom	|| ✓
|-
|}

===== Create Content Metadata =====
Content metadata should remain constant throughout the entirety of an episode/clip including when ads play.
<blockquote> program and title metadata values should be passed to SDK as UTF-8 strings. </blockquote>
<div style="height: 45em; overflow-y:auto;"><br>
{| class="wikitable" 
|-
! '''Keys''' !! '''Description''' !! '''Values''' !! '''Required'''!!'''Provider'''
|-
| type || Type of asset ||For Video use: <code>content</code><br> For Static or text <code>static</code> || Yes || Nielsen
|-style="background-color:#e9f9fa;"
| assetid || Unique ID assigned to asset <br> Note: Refrain from using the following special characters [[Special_Characters|(Special Characters)]]. || Examples: <br> <code>BBT345a234 </code> <br> <code>CBSs5e234F2021</code>  || Yes || Client 
|-
| program ||Complete program or movie title <br> (no abbreviations or shorthand) <br> Note: there is a 25 character limit.  ||<code> The Big Bang Theory</code> <br> <code> TheBigBangTheory</code> <br><code> The Dark Knight</code> <br><code> TheDarkKnight</code> <br> || Yes || Client 
|-style="background-color:#e9f9fa;"
| title ||Episode title with season and episode number (40 character limit) <br> (Formats accepted: S01E03, S1E3, S1 E3). || Examples: <br> <code>The Pants Alternative S03E18</code> <br> <code>The Pants Alternative S3E18</code> <br> <code>The Pants Alternative S3 E18</code> <br> Can also accept: <code> S3E18</code> <br> Not Valid: <code> 318 </code> or <code> 0318 </code>|| Yes || Client 
|-
| crossId1 || Gracenote TMS ID (If available) should be passed for all telecasted content for clients using the Gracenote solution for proper matching purposes. <br>Note: The TMS ID will be a 14 character string. Normally leading with 2 alpha characerts ('EP', 'MV', 'SH' or 'SP'), followed by 12 numbers.
|| The TMS ID will be a 14 character string. <br> Normally being with  'EV,' 'EP', 'SH', 'SP', or 'MV' <br> Followed by 12 numbers after the initial two letter prefix. <br> <br> The Giant Morning Show: <code>SH009311820022</code> <br> The Pants Alternative Episode : <code>EP009311820061</code> || Optional || Nielsen
|-style="background-color:#e9f9fa;"
| crossId2 || Populated by content distributor to contribute viewing from that distributor to the given content originator. || For a full list of acceptable values, please contact your Nielsen reprentative. || Yes, for distributors || Nielsen
|-
| length || Length of content in seconds<br>Note: Integers and decimals are acceptable values are acceptable for the length parameter. || Examples:
<small>For standard VOD content - <code>300</code> to represent 5 minutes, <code>1320</code> to represent 22 minutes, etc.
<br>If DAI live stream of a discrete program (Live Event/Sporting Event), pass length of content. See example for standard VOD content above.
<br>If unknown DAI live steam, pass a value of <code>0</code>.</small> 
|| Yes || Client 
|-style="background-color:#e9f9fa;"
| airdate ||Original broadcast or release date for the program <br>For USA, date should be EST <br> Outside USA, date should be local time.<br>If not applicable or available, original broadcast or release date for the Program. || Acceptable Formats:<br><code>YYYY-MM-DDTHH:MI:SS</code><br><code>YYYY-MM-DDHH:MI:SS</code><br><code>YYYY-MM-DDTHH:MI:SS+xx:xx</code><br><code>YYYY-MM-DDTHH:MI:SS-xx:xx</code><br><code>YYYYMMDDHH:MI:SS</code><br><code>YYYYMMDD HH:MI:SS</code><br><code>MM-DD-YYYY</code><br><code>MM/DD/YYYY</code><br><code>YYYYMMDD</code></big> || Yes || Client 
|-
| isfullepisode || Full episode flag to identify differences between long form content. || <code>y</code>- full episode, <code>n</code>- non full episode(clip,teaser,promo,etc.)
<small>Also accept: 
<br><code>lf</code> or <code>yes</code>- longform
<br><code>sf</code> or <code>no</code>- shortform
|| Yes || Nielsen
|-style="background-color:#e9f9fa;"
| adloadtype || <big><small>Type of ad load: 
<code>1</code> Linear – matches TV ad load<br><code>2</code> Dynamic – Dynamic Ad Insertion (DAI)</small></big>
|| <code>2</code> - DCR measures content with dynamic ads || Yes || Nielsen
|-
| segB || One of two custom segment for the clients granular reporting within a brand. || Examples:<br>Genre - <code>horror</code>, <code>comedy</code>, etc.<br>Timeslot - <code>primetime</code>, <code>daytime</code>, etc.<br>News type - <code>breakingnews</code>, <code>weather</code>, etc. || Optional || Client 
|-style="background-color:#e9f9fa;"
| segC || One of two custom segment for the clients granular reporting within a brand. || Examples:<br>Genre - <code>horror</code>, <code>comedy</code>, etc.<br>Timeslot - <code>primetime</code>, <code>daytime</code>, etc.<br>News type - <code>breakingnews</code>, <code>weather</code>, etc. || Optional || Client 
|}
</div>


Custom segments (segB and segC) can be used to aggregate video and/or static content within a single Brand to receive more granular reports within a brand.

Examples regarding usage of segments within SDK:
* All comedy clips and stories for a Brand rolled into a "Comedy" segment
* genre grouping content by Comedy vs. Drama
* group related Text + Video content - i.e. for a show that has a lot of - static pages associated with it
* packaging based on how clients sell inventory
* grouping related types of content either by genre, category or platform.
<br />


===== Metadata Example =====
<code>Swift</code>
<syntaxhighlight lang="swift">

let contentMetadata = [
    "type": "content",
    "assetid": "C77664",
    "program": "The Big Bang Theory",
    "title": "The Pants Alternative S03E18",  //Formats accepted: S01E03, S1E3, S1 E3
    "crossId1": "EP009311820061", //optional
    "crossId2": "Content Originator", //optional
    "length": "3600",
    "airdate": "2022-03-21T10:05:00", 
    "isfullepisode": "Yes",
    "adloadtype": "2",
    "segB": "CustomSegmentValueB", //optional
    "segC": "CustomSegmentValueC" //optional

];
</syntaxhighlight> 
<br>
<code>Objective-C</code>    
<syntaxhighlight lang="objective-c"> 
NSDictionary * contentMetadata = @ {
    @ "type": @ "content",
    @ "assetid": @ "C77664",
    @ "program": @ "The Big Bang Theory",
    @ "title": @ "The Pants Alternative S03E18", //Formats accepted: S01E03, S1E3, S1 E3
    @ "crossId1": @ "EP009311820061", //optional
    @ "crossId2": @ "Content Originator", //optional
    @ "length": @ "3600",
    @ "airdate": @ "2022-03-21T10:05:00",
    @ "isfullepisode": @ "y",  
    @ "adloadtype": @ "2",
    @ "segB": @ "CustomSegmentValueB", //optional
    @ "segC": @ "CustomSegmentValueC" //optional

}
</syntaxhighlight>

</div>

==== iOS DCR Video Step 4 - Basic Set of Events - Sample Playback ====
<span class="mw-customtoggle-myDivisionv6" style="color: cornflowerblue"> Show/hide step 4 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv6">

=== SDK Events ===
{| class="wikitable"
|-
! Event !!	Parameter	!! Description
|-
| 'play'	|| 	|| Call at start of each new stream
|-
| 'loadMetadata'	|| content/ad metadata object	|| Needs to be called at the beginning of each asset
|-
| 'playheadPosition'	|| playhead position as integer<br/>
VOD: current position in seconds <br/>
Live: current UNIX timestamp (seconds since Jan-1-1970 UTC) <br/>
Note: 'PlayheadPosition' has to be called every second
||
Pass playhead position every second during playback
|-
| 'stop' ||	playhead position	|| Call during any interruption to content or Ad playback and at the end of each Ad.
|-
| 'end'	|| playhead position in seconds	|| Call when the current video asset completes playback and pass the playhead position. <br/>
Example: At the end of the content stream, if the user switches to another piece of content, when the browser is refreshed or closed.
|}
<blockquote>Note: For livestream, send the UNIX timestamp, for VOD send the time in seconds as integer. The final playhead position must be sent for the current asset being played before calling <code>'''stop'''</code>, <code>'''end'''</code> or<code> '''loadmetadata'''</code>,.</blockquote>

=== Life cycle of SDK instance ===
Life cycle of SDK instance includes four general states:
# '''Initial state''' – The SDK is not initialized and hence, not ready to process playing information. Once the SDK is moved out of this state, it needs instantiation of the new SDK instance in order to get the instance in the '''Idle state'''.
# '''Idle state''' – The SDK is initialized and is ready to process playing information. Once Initialized, the SDK instance is not processing any data, but is listening for an event to occur.
# '''Processing state''' – The SDK instance is processing playing information. The <code>'''play'''</code> and <code>'''loadMetadata''' </code> calls move the SDK instance into this state. In this state, the SDK instance will be able to process the following calls.
## <code>'''playheadPosition'''</code> – Call this API every one second when playhead position is active.  If a LIVE event, use the current UNIX timestamp (seconds since Jan-1-1970 UTC).
## <code>'''stop'''</code> – Call this API when the content or Ad playback is interrupted and at the end of each Ad. 
## <code>'''end'''</code> – Call when content completes. When called, the SDK instance exits from Processing state.
# '''Disabled state''' – The SDK instance is disabled and is not processing playing information. 
## <code>'''appDisableApi'''</code> is set to <code>true</code>

<blockquote>'''Note:''' For API Version 5.1 and above, App SDK will fire data pings and continue measurement even after the user has opted out from Nielsen measurement on a device. The data ping will be marked as opted-out ping.

'''Note''': In case of any interruptions during playback due to alarm, calendar, call, flight mode, Wi-Fi toggle, channel change, etc., call [[stop]] to stop the measurement.
* As soon as the playback resumes, call <code>'''loadMetadata''' </code> and   <code>'''playheadPosition'''</code> </blockquote>

=== API Call Sequence ===
==== Sample Use Case: Content has no Advertisements ====
Call [[play()]] at start of stream

Call [[loadMetadata()]] with JSON metadata for content as below.
<syntaxhighlight lang="json">{
  "type": "content",
  "assetid": "vid345-67483",
  "program": "ProgramName",
  "title": "Program S3, EP1",
  "length": "3600",
  ...
}</syntaxhighlight>
Call [[playheadPosition|playheadPosition()]] every one second until a pause / stop.
Use the sample API sequence below as a reference to identify the specific events that need to be called during content playback without ads.
{| class="wikitable"
|-
! Type !! Sample code !! Description
|-
| rowspan="2" | Start of stream || <code>mAppSdk.play(); </code> || // Call at start of each new stream
|-
| <code>mAppSdk.loadMetadata(contentMetaDataObject);</code> || // contentMetadataObject contains the JSON metadata for the content being played
|-style="background-color:#d8f5d7;"
| Content || <code>mAppSdk.setPlayheadPosition(playheadPosition);</code> || // position is position of the playhead while the content is being played
|-
| Interruption || <code>mAppSdk.stop();</code> || // call stop when content playback is interrupted
|-style="background-color:#d8f5d7;"
| rowspan="2" | Resume Content || <code>mAppSdk.loadMetadata(contentMetaDataObject);</code>  || // Call loadMetadata and pass content metadata object when content resumes
|- style="background-color:#d8f5d7;"
|<code>mAppSdk.setPlayheadPosition(playheadPosition);</code> || // continue pasing playhead position every second starting from position where content is resumed
|- 
| End of Stream || <code>mAppSdk.end();</code> || // Content playback is completed.
|}




</div>

==== Keep Going ====
<span class="mw-customtoggle-myDivisionv9" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv9">

Congratulations, you've successfully integrated the iOS SDK in your app for a basic content playback scenario!

You can add more content to see channel-change scenarios or continue to next steps below.

View your application's debug logs and search for the term (AppSDK) to see messages emitted by Nielsen AppSDK during video playback.


</div>

==== Next Steps ====
<span class="mw-customtoggle-myDivisionv10" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv10">
====Going Live====

In addition to the basic steps above, before going live developers need to handle app background/foreground events, make certain privacy disclosures, handle interruption events (stop, fast-forward, rewind), remove iOS simulator slices, and allow users to opt out of Nielsen measurement. More details can be found [[DCR_Video_iOS_SDK|here]], along with a more comprehensive reference for implementing DCR Video measurement with AppSDK.

Once the DCR Tracking Code is added, Nielsen will validate the implementation. Following Nielsen testing, developers need to make a few updates to the initialization call to ensure that the app is being measured properly.

#'''App ID''': Ensure that correct  is used during initialization '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'''
#'''Debug Logging''': Disable logging by changing initialization call to use @"nol_devDebug":@"INFO".


</div>



</div>

== &rarr; iOS DTVR (coming soon) ==
<!--
<span class="mw-customtoggle-myDivision100" style="color: cornflowerblue"> Show/hide iOS DTVR </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision100">
==== iOS DTVR Introduction ====
<span class="mw-customtoggle-myDivisionv200-" style="color: cornflowerblue"> Show/hide Intro </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv200-">

The Nielsen DTVR (Digital TV Ratings) product provides content consumption measurement in client mobile apps and 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 product in a sample iOS app using Nielsen AppSDK. It includes:

*SDK Initialization
*DTVR Video Metadata: information about the content being tracked
*DTVR Video Events/API calls
*Extracting ID3 tags from the video stream and passing to AppSDK for measurement

By the end of this guide you will have the needed steps to integrate Nielsen's AppSDK in the background of your app for DTVR measurement.

'''NOTE: video streams must have Nielsen ID3 tags embedded in order to be measured using the DTVR product. See the section in this guide "Extracting ID3 Tags" or contact your Nielsen representative for more information.'''

</div>

==== iOS DTVR Step 1 - Obtain AppID ====
<span class="mw-customtoggle-myDivisionv300" style="color: cornflowerblue"> Show/hide step 1 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv300">

To begin using the iOS AppSDK, you will need to obtain an Application ID (AppId)

{| class="wikitable"
|-
! !! Item !! Description !! Source
|-
|&#9989; || App ID (appid) || Unique ID assigned to the player/site and configured by product || Contact your Nielsen Representative

|}

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 AppSDK in the app.
</br>Example: '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX'''

</div>

==== iOS DTVR Step 2 - SDK Initialization ====
<span class="mw-customtoggle-myDivision400" style="color: cornflowerblue"> Show/hide step 2 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivision400">

===== How to obtain the NielsenAppApi.Framework =====
The Nielsen AppSDK can either be downloaded directly or can be integrated directly within an application through the use of CocoaPods. We recommend using the CocoaPods-based integration whenever possible to ensure you maintain the most recent changes and enhancements to the Nielsen libraries.
* [[Digital_Measurement_iOS_Artifactory_Guide|Select to obtain CocoaPods implementation guide]]
* [[Special:Downloads|Select to Download Directly]]

===== Configuring Xcode Development Environment =====
Starting with SDK version 6.0.0.0, the Nielsen App SDK is compatible with Apple iOS versions 8.0 and above.  In addition, when using the dynamic framework,  all the required frameworks are linked automatically as the are needed.  More details can be found here: https://stackoverflow.com/questions/24902787/dont-we-need-to-link-framework-to-xcode-project-anymore

<blockquote>'''Note''': All communications between the SDK and the Census (Collection Facility) use HTTPS.</blockquote>

======= Download Framework =======
The first step is to download and copy the [[Special:Downloads|NielsenAppApi.framework]] bundle to the app project directory. (''Not required if using CocaPods'')

======= Add Framework =======
In the General tab for app configuration add NielsenAppApi.framework in the list of Embedded Binaries.  (''Not required if using CocaPods'')

======= Add Path =======
Add path to the NielsenAppApi.framework in the Framework Search Paths build setting.  (''Not required if using CocaPods'')

======= Import Framework =======
Add NielsenAppApi.framework module in the source file of your app:

======= Using Swift =======
Add the following:
<syntaxhighlight lang="swift">
import NielsenAppApi
</syntaxhighlight>

======= Using Objective-C =======
<syntaxhighlight lang ="objective-c">
@import NielsenAppApi;
</syntaxhighlight>

======= SDK Initialization =======

The following table contains the list of arguments that can be passed via the AppInfo JSON schema.
{| class="wikitable"
|-
! Parameter / Argument !! Description !! Source !! Required? !! Example
|--style="background-color:#d0f6f8;"
| 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
|--style="background-color:#d0f6f8;"
| nol_devDebug || Enables Nielsen console logging. Only required for testing <br>
|| Nielsen-specified || Optional || DEBUG
|}
==== Debug flag for development environment ====
Player application developers / integrators can use Debug flag to check whether an App SDK API call made is successful. To activate the Debug flag,
Pass the argument <code>@"nol_devDebug":@"DEBUG"</code>, in the JSON string . 

Once the flag is active, it logs each API call made and the data passed. The log created by this flag is minimal.
<blockquote>'''Note''': DO NOT activate the Debug flag in a production environment.</blockquote>

=== Swift Example ===
==== Sample SDK Initialization Code ====

<code>NielsenInit.swift</code>
<syntaxhighlight lang="swift">
class NielsenInit: NSObject {
    class func createNielsenAppApi(delegate: NielsenAppApiDelegate) -> NielsenAppApi?{
    let appInformation:[String: String] = [
           "appid": "PE392366B-F2C1-4BC4-AB62-A7DAFDCXXXX",
           "nol_devDebug": "DEBUG"
        ]
        return NielsenAppApi(appInfo:appInformation, delegate:delegate)}}
</syntaxhighlight>

<br />
<code>ViewController.swift</code>

<syntaxhighlight lang="swift">
class ViewController: UIViewController, NielsenAppApiDelegate, AVPictureInPictureControllerDelegate, CLLocationManagerDelegate  {

    let avPlayerViewController = AVPlayerViewController()
    var avPlayer:AVPlayer?
    var nielsenAppApi: NielsenAppApi!

  override func viewDidLoad() {
        super.viewDidLoad()
        self.nielsenAppApi = NielsenInit.createNielsenAppApi(delegate: self)
        NSLog("Nielsen SDK initialized")
}}
</syntaxhighlight>

=== Objective C ===
==== Sample SDK Initialization Code ====
Initialize the Nielsen App object within the viewDidLoad view controller delegate method using initWithAppInfo:delegate:
<blockquote>If App SDK is initialized using init or new methods, it will ignore the API calls resulting in no measurement. The SDK will not return any errors.</blockquote>
<syntaxhighlight lang="objective-c">
#import "NlsAppApiFactory.h"
#import <NielsenAppApi/NielsenAppApi.h>

@implementation NlsAppApiFactory
+ (NielsenAppApi *)createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate;
{
    NSDictionary *appInformation = @{
                                     @"appid": "PE392366B-F2C1-4BC4-AB62-A7DAFDC51XXX",
                                     @"nol_devDebug": @"DEBUG"
                                     };
    return [[NielsenAppApi alloc] initWithAppInfo:appInformation delegate:delegate];
}
@end
</syntaxhighlight>


The following would be the <code>NlsAppApiFactory.h</code> file:
<syntaxhighlight lang="objective-c">
#import <Foundation/Foundation.h>

@class NielsenAppApi;
@protocol NielsenAppApiDeligate;
@interface NlsAppApiFactory : NSObject
+ (NielsenAppAPI *) createNielsenAppApiWithDelegate:(id<NielsenAppApiDelegate>)delegate;
@end
}}
</syntaxhighlight>
<br>
The following might be in the <code>Viewcontroller.m</code>
<syntaxhighlight lang="objective-c">
@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
    
    //Setting background image
    UIImage *backgroundImage = [UIImage imageNamed:@"new_ios_bg.png"];
    UIImageView *backgroundImageView=[[UIImageView alloc]initWithFrame:self.view.frame];
    backgroundImageView.image=backgroundImage;
    [self.view insertSubview:backgroundImageView atIndex:0];
    
    //Mark: In NielsenInit class we are initialising the Nielsen SDK.
    
    //Getting the instance of Nielsen SDK
    nielsenApi = [NielsenInit createNielsenAppApiWithDelegate:nil];
}
 </syntaxhighlight>



</div>

==== iOS DTVR Step 3 - Create DTVR Content Metadata Object ====
<span class="mw-customtoggle-myDivisionv500" style="color: cornflowerblue"> Show/hide step 3 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv500">

===== Configure Metadata =====
Content metadata should remain constant throughout the completion of an episode or live stream.
{| class="wikitable"
|-
! Key !! Description !!	Values	 !! Required
|-
| type ||	type of asset	|| "content"	|| 
|-
| adModel	|| linear vs dynamic ad model	|| 1 = Linear  matches TV ad load for DTVR      || ✓
|-
|}
<!--
- (NSDictionary *)loadChannelInfo
{
    //Loading Channel Info.    
    NSString *strUrl = self.url.absoluteString;  
    NSDictionary *channel = @{  @"channelName" : @"TheGreatBigMovie": strUrl };   
    return channel;
}
-->
<syntaxhighlight lang="objectivec">    
- (NSDictionary *)loadDtvr{
    
    //Loading DTVR data  
    NSDictionary *dtvr = @{ @"adModel":@"1" ,  
                            @"type":@"content",};  
    return dtvr;
}
    </syntaxhighlight>
</div>

==== iOS DTVR Step 4 - Basic Set of Events - Sample Playback ====
<span class="mw-customtoggle-myDivisionv600" style="color: cornflowerblue"> Show/hide step 4 </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv600">

===== SDK Events/APIs =====
<!--[[File:appsdkTimeline-DTVR-V2.png|icon]]-->
{| class="wikitable"
|-
! Event !!	Parameter	!! Description
|-
| 'loadMetadata'	|| content/ad metadata object	|| Needs to be called at the beginning of each asset to pass type and adModel.
|-
| 'sendID3'	|| Used to send the ID3 tag payload retrieved from the stream || Needs to be called at the beginning of playback
|}

===== Configure API calls - loadMetadata =====
Use <code>loadMetadata</code> to pass the metadata object created above. 
{{ExampleCode|
|Objective C = <syntaxhighlight lang="objective-c">[nielsenApi loadMetadata:(dtvr)];</syntaxhighlight>
|Swift = <syntaxhighlight lang="swift">self.nielsenAppApi?.loadMetadata(dtvr)</syntaxhighlight>
}}

===== Configure API calls - sendID3 =====
[[sendID3]] API is a Nielsen AppSDK receiver for timed metadata events (ID3 tags) provided through iOS’s NSNotificationCenter notification system. This API filters out Nielsen-specific ID3 tags from the system and uses them to create duration data. These ID3 tags are used by Nielsen SDK for DTVR measurement, and the stream that is played must contain ID3 tags and have these tags extracted and passed to SDK using the below procedure in order for DTVR measurement to occur. 
{{ExampleCode|
|Objective C = <syntaxhighlight lang="objective-c">[nielsenApi sendID3:extraString];</syntaxhighlight>
|Swift = <syntaxhighlight lang="swift"> [nielsenApi sendID3:extraString];</syntaxhighlight>}}
'''Sample ID3 tags''' 
* <code>www.nielsen.com/X100zdCIGeIlgZnkYj6UvQ==/X100zdCIGeIlgZnkYj6UvQ==/AAAB2Jz2_k74GXSzx4npHuI_<wbr />JwJd3QSUpW30rDkGTcbHEzIMWleCzM-uvNOP9fzJcQMWQLJqzXMCAxParOb5sGijSV9dNM3QiBniJYGZ5GI-lL1fXTTN0IgZ4iWBmeRiPpS9AAAAAAAAAAAAAAAAAAAAAFJWFM5SVhTONNU=/00000/00000/00</code>
* <code>www.nielsen.com/X100zdCIGeIlgZnkYj6UvQ==/R8WHe7pEBeqBhu8jTeXydg==/AAICoyitYqlxT7n6aZ0oMCGhe<wbr />Fi4CXFp46AMUPZz1lMr_M9tr3_cjee1SHqxrOiVerMDLeyn9xzocZSKwi746Re8vNOtpNCAZjYABs_J0R25IHpvOc1HS8<wbr />QHGgD5TgOJeS6gX100zdCIGeIlgZnkYj6UvVJWFNhSVhTiPE0=/00000/46016/00</code>
Refer to [[iOS SDK API Reference#Retrieving ID3 Tags|Retrieving ID3 Tags]] section to know more details.

===== Retrieving ID3 Tags =====
ID3 tags have a payload of about 249 characters and start with "www.nielsen.com".

As Apple has deprecated the use of [https://developer.apple.com/documentation/avfoundation/avplayeritem/1389602-timedmetadata?language=objc timedMetadata], we now recommend using [https://developer.apple.com/documentation/avfoundation/avplayeritemmetadataoutput?language=objc AVPlayerItemMetadataOutput] for extracting ID3 tags from the iOS Native Player.

If any other player apart from the iOS native player is used, check and ensure that the player has the capability to extract metadata such as ID3 tags.

===== Examples of extracting ID3 tags from the iOS Native Player =====
{{ExampleCode|
|Swift = <syntaxhighlight lang="swift"> 
        //First, ensure your class conforms to the AVPlayerItemMetadataOutputPushDelegate protocol.
           class YourClass: AVPlayerItemMetadataOutputPushDelegate { 

           }
</syntaxhighlight>
------------------------------------------------------
<syntaxhighlight lang="swift"> 
       // Then create an instance of AVPlayerItemMetadataOutput and add it to the player item
          let metadataOutput = AVPlayerItemMetadataOutput(identifiers: nil)
           playerItem.add(metadataOutput)
 
       // and set the delegate and a dispatch queue
           metadataOutput.setDelegate(self, queue: DispatchQueue.main)
</syntaxhighlight>
------------------------------------------------------
<syntaxhighlight lang="swift"> 
        // After that below callback function of AVPlayerItemMetadataOutputPushDelegate 
        // protocol will be triggered whenever ID3 tag is received from stream. 
          func metadataOutput(_ output: AVPlayerItemMetadataOutput, didOutputTimedMetadataGroups groups: [AVTimedMetadataGroup], from track: AVPlayerItemTrack?) {
    for group in groups {
        for item in group.items {
            // Handle the metadata item
            handleTimedMetadata(metadataItem: item)
        }
    }
}
</syntaxhighlight>
------------------------------------------------------
<syntaxhighlight lang="swift"> 
          // Then further metadata item can be handled like below 
          func handleTimedMetadata(metadataItem: AVMetadataItem) {
    guard let key = metadataItem.key as? String,
          let extraString = metadataItem.extraAttributes?[AVMetadataExtraAttributeInfoKey] as? String else {
        return
    }
    // If the extra string(tag) starts with "www.nielsen.com", then only sending to SDK
    if key == "PRIV" && extraString.hasPrefix("www.nielsen.com") {
        DispatchQueue.global(qos: .default).async {
            self.nielsenApi?.sendID3(extraString)
        }
    }
}

</syntaxhighlight>
|Objective C = <syntaxhighlight lang="objective-c">
        //First, ensure your class conforms to the AVPlayerItemMetadataOutputPushDelegate protocol.
          @interface YourClass : NSObject <AVPlayerItemMetadataOutputPushDelegate> 

          @end

  </syntaxhighlight>
------------------------------
<syntaxhighlight lang="objective-c">
        // Then create an instance of AVPlayerItemMetadataOutput and add it to the player item
          AVPlayerItemMetadataOutput *metadataOutput = [[AVPlayerItemMetadataOutput alloc] initWithIdentifiers:nil];
          [playerItem addOutput:metadataOutput];

        // and set the delegate and a dispatch queue
          [metadataOutput setDelegate:self queue:dispatch_get_main_queue()];
  </syntaxhighlight>
------------------------------
<syntaxhighlight lang="objective-c">
        // After that below callback function of AVPlayerItemMetadataOutputPushDelegate 
        // protocol will be triggered whenever ID3 tag is received from stream.
           - (void)metadataOutput:(AVPlayerItemMetadataOutput *)output didOutputTimedMetadataGroups:(NSArray<AVTimedMetadataGroup *> *)groups fromPlayerItemTrack:(AVPlayerItemTrack *)track {
    for (AVTimedMetadataGroup *group in groups) {
        for (AVMetadataItem *item in group.items) {
            // Handle the metadata item
            [self handleTimedMetadata:item];
        }
    }
}
  </syntaxhighlight>
------------------------------
<syntaxhighlight lang="objective-c">
        // Then further metadata item can be handled like below 
          - (void)handleTimedMetadata:(AVMetadataItem *)item {
    NSString *key = (NSString *)item.key;
    NSString *extraString = item.extraAttributes[AVMetadataExtraAttributeInfoKey];
    // If the key is "PRIV" and the extra string starts with "www.nielsen.com", send it to the Nielsen API
    if ([key isEqualToString:@"PRIV"] && [extraString hasPrefix:@"www.nielsen.com"]) {
        dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
            [self.nielsenApi sendID3:extraString];
        });
    }
}
  </syntaxhighlight>
}}

===== Life cycle of SDK instance =====
Life cycle of SDK instance includes four general states:
# '''Initial state''' – The SDK is not initialized and hence, not ready to process playing information. 
# '''Idle state''' – The SDK is initialized and is ready to process playing information. Once Initialized, the SDK instance is not processing any data, but is listening for the loadMetadata and sendID3 events to occur.
# '''Processing state''' – The SDK instance is processing playing information. For DTVR, the <code>'''loadMetadata''' </code> call moves the SDK instance into this state. In this state, the SDK instance will be able to process sendID3 calls and measure content.
# '''Disabled state''' – The SDK instance is disabled.

</div>

==== Keep Going ====
<span class="mw-customtoggle-myDivisionv900" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv900">

Congratulations, you've successfully integrated the iOS SDK in your app for a basic content playback scenario!

You can add more content to see channel-change scenarios or continue to next steps below.

View your application's debug logs and search for the term (AppSDK) to see messages emitted by Nielsen AppSDK during video playback.


</div>

==== Next Steps ====
<span class="mw-customtoggle-myDivisionv1000" style="color: cornflowerblue"> Show/hide </span>
<div class="mw-collapsible mw-collapsed" id="mw-customcollapsible-myDivisionv1000">
====Going Live====

In addition to the basic steps above, before going live developers need to handle app background/foreground events, make certain privacy disclosures, handle interruption events (stop, fast-forward, rewind), remove iOS simulator slices, and allow users to opt out of Nielsen measurement. More details can be found [[DTVR_iOS_SDK|here]], along with a more comprehensive reference for implementing DTVR measurement with AppSDK.

Once the DTVR Tracking Code is added, Nielsen will validate the implementation. Following Nielsen testing, developers need to make a few updates to the initialization call to ensure that the app is being measured properly.

#'''App ID''': Ensure that correct  is used during initialization '''PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'''
#'''Debug Logging''': Disable logging by changing initialization call to use @"nol_devDebug":@"INFO".


</div>

-->

</div>