Template

iOS Prerequisites and Implementation Overview: Difference between revisions

From Engineering Client Portal

(Created page with "== Special Notes regarding iOS14 == === Permission to Track === Apple recently released a new policy on consent requirements, that require the user's permission, to track th...")
 
 
(3 intermediate revisions by the same user not shown)
Line 1: Line 1:
== Special Notes regarding iOS14 ==
=== Permission to Track ===
Apple recently released a new policy on consent requirements, that require the user's permission, to track them using their device's advertising identifier (IDFA).  To request the user's permission, use the AppTrackingTransparency framework. 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. The IDFV may not be combined with other data to track a user across apps and websites owned by other companies unless you have been granted permission to track by the user.
For more information, see:
* [https://developer.apple.com/documentation/apptrackingtransparency App Tracking Transparency]
* [https://developer.apple.com/design/human-interface-guidelines/ios/app-architecture/requesting-permission/ Human Interface Guidelines]
* [https://developer.apple.com/documentation/adsupport AdSupport Framework]
More detailed information on how the Nielsen SDK versions work with the AppTrackingTransparency framework is located on our [[ DCR Video iOS14 Migration|DCR Video iOS14 Migration]] page.
=== App store privacy questionnaire ===
As of April 22nd, 2021, any app submitted to the app store will need to provide information about your app's privacy practices, including the practices of third-party partners such as Nielsen, through App Store Connect. Nielsen has created a guide which is titled, '''[[iOS SDK App Privacy|User Privacy and Data Use]]''' to make information about Nielsen’s data collection practices available to clients who use the Nielsen Digital SDK and Nielsen tags.  The guide is organized using headings of the [https://developer.apple.com/app-store/app-privacy-details/ App privacy details on the App Store] (as of December 7th, 2020) webpage for convenience.
== Prerequisites ==
== Prerequisites ==
Before you start the integration, you will need:
Before you start the integration, you will need:
Line 31: Line 16:


==  Implementation ==
==  Implementation ==
This guide covers implementation steps for iOS utilizing the Nielsen SDK for DCR.
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.  
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.  


Line 51: Line 34:
=== How to obtain the NielsenAppApi.Framework ===
=== 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.
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]]
* [[Digital_Measurement_iOS_Artifactory_Guide|iOS Package Dependency Guides (CocoaPods, Carthage, Swift Package Manager)]]
* [[Special:Downloads|Select to Download Directly]]
* [[Special:Downloads|Select to Download Directly]]
* [[DCR_Video_iOS_SDK_xcframework|Using the XCFramework bundle]]
* [[DCR_Video_iOS_SDK_xcframework|Using the XCFramework bundle]]

Latest revision as of 18:28, 17 August 2022

Prerequisites

Before you start the integration, you will need:

Item Description Source
App ID (appid) Unique ID assigned to the player/site and configured by product. Provided by Nielsen
Nielsen SDK Includes SDK frameworks and sample implementation; See iOS SDK Release Notes 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.

SDK Flavor Description
iOS Ad Version * Opt-In and Opt-Out functionality managed by the AppTrackingTransparency framework . (Preferred approach)
* The Nielsen SDK will attempt to collect the IDFA (Id for Advertisers) on the device.
* For iOS14+, if the value returned is ATTrackingManager.AuthorizationStatus.authorized.
* 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.
* The ID for Vendors (IDFV), may be used for analytics across apps from the same content provider.
* The developer is required to present the User Choice Opt Out page which is described in the Privacy Section.
iOS SDK noID * This version of the Nielsen SDK is perfect for Kid apps, or where no ID is required.
* Please review the 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.