Template:iOS Prerequisites and Implementation Overview - Revision history

ColinBrown: /* How to obtain the NielsenAppApi.Framework */

2022-08-17T18:28:22Z

How to obtain the NielsenAppApi.Framework

← Older revision		Revision as of 18:28, 17 August 2022
Line 34:		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\|iOS Package Dependency Guides (~~cocoapods~~, ~~carthage~~, Swift Package Manager)]]		* [[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]]

ColinBrown: /* How to obtain the NielsenAppApi.Framework */

2022-08-17T18:27:53Z

How to obtain the NielsenAppApi.Framework

← Older revision		Revision as of 18:27, 17 August 2022
Line 34:		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]]

ColinBrown: /* Implementation */

2021-08-23T22:29:19Z

Implementation

← Older revision		Revision as of 22:29, 23 August 2021
Line 16:		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.

ColinBrown at 21:22, 23 August 2021

2021-08-23T21:22:44Z

← Older revision		Revision as of 21:22, 23 August 2021
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:

ColinBrown: 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..."

2021-08-23T20:54:15Z

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..."

New page

== 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 ==
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 ==
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.

{| 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)''' * The Nielsen SDK will attempt to collect the IDFA (Id for Advertisers) on the device. * For iOS14+, if the value returned is <code>ATTrackingManager.AuthorizationStatus.authorized</code>. * 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 [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 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. * 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|Select to obtain CocoaPods implementation guide]]
* [[Special:Downloads|Select to Download Directly]]
* [[DCR_Video_iOS_SDK_xcframework|Using the XCFramework bundle]]