View source for iOS Prerequisites and Implementation Overview

== Prerequisites ==
Before you start the integration, you will need:
{| class="wikitable"
|-
! style="width: 15%;" | Item
! Description
! Source
|-style="background-color:#d0f6f8;"
 || '''App ID (appid)''' || Unique ID assigned to the player/site and configured by product. || Provided by Nielsen
|-style="background-color:#d0f6f8;"
 || '''Nielsen SDK''' || Includes SDK frameworks and '''sample implementation'''; ''See [[iOS SDK Release Notes]]'' || [[Special:Downloads|Download]]
|}

If need App ID(s) or our SDKs, feel free to reach out to us and we will be happy to help you get started.
Refer to [[Digital Measurement Onboarding]] guide for information on how to get a Nielsen App SDK and appid.

==  Implementation ==
Version 8 of the Nielsen App SDK will come in three versions. One that is enabled to work with the App Tracking Transparency Framework, another version that does not use the Ad Framework, and a version for Kids Apps or where noID is required. 

{| class="wikitable" 
|-
! SDK Flavor
! Description
|-
| '''iOS Ad Version'''
|* Opt-In and Opt-Out functionality managed by the [https://developer.apple.com/documentation/apptrackingtransparency AppTrackingTransparency framework] . '''(Preferred approach)''' <br />* The Nielsen SDK will attempt to collect the IDFA (Id for Advertisers) on the device.<br> * For iOS14+, if the value returned is <code>ATTrackingManager.AuthorizationStatus.authorized</code>.<br>*  If the device is running iOS12 or iOS13, the Limit Ad Tracking setting is requested.
|-
| '''iOS No Ad Framework'''
|* Without the Ad Framework, the Nielsen SDK cannot read the IDFA, so it will attempt to retrieve the '''IDFV'''.<br />* The [https://developer.apple.com/documentation/uikit/uidevice/1620059-identifierforvendor ID for Vendors (IDFV)], may be used for analytics across apps from the same content provider.<br />* The developer is required to present the User Choice Opt Out page which is described in the [[DCR_Video_iOS_SDK#User_Choice|Privacy Section]].
|-
| '''iOS SDK noID'''
|* This version of the Nielsen SDK is perfect for Kid apps, or where no ID is required.<br>* Please review the [https://engineeringportal.nielsen.com//docs/DCR_Video_Android_SDK#Special_Note_Regarding_Apps_in_the_Kids_Category Opt Out Requirement].
|}
=== 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|iOS Package Dependency Guides (CocoaPods, Carthage, Swift Package Manager)]]
* [[Special:Downloads|Select to Download Directly]]
* [[DCR_Video_iOS_SDK_xcframework|Using the XCFramework bundle]]