DCR Video iOS14 Migration: Difference between revisions

From Engineering Client Portal

No edit summary
No edit summary
 
(3 intermediate revisions by one other user not shown)
Line 4: Line 4:
__NOTOC__
__NOTOC__
== Overview ==
== Overview ==
NOTE: this page is for historical reference. In addition to dealing with App Tracking Transparency, developers should also be aware of changes related to iOS 17 detailed here: [[Nielsen_Digital_Measurement_and_iOS17_or_TVOS17]]
Apple recently released a new policy on consent requirements for its mobile advertising tool, Identifier for Advertisers (IDFA). With this new policy, (App Tracking Setting) users can choose whether an IDFA may be used by mobile applications. iOS 14 was released on Sept 16th.
Apple recently released a new policy on consent requirements for its mobile advertising tool, Identifier for Advertisers (IDFA). With this new policy, (App Tracking Setting) users can choose whether an IDFA may be used by mobile applications. iOS 14 was released on Sept 16th.


Line 67: Line 69:
| style="font-weight:bold;" | Yes, Clients to implement pop-up and app store verbiage
| style="font-weight:bold;" | Yes, Clients to implement pop-up and app store verbiage
|-
|-
| iOS/tvOS 14<br />APPLE is not enforcing App Transparency Layer (pop-up)
| iOS/tvOS 14.0 - 14.4<br />APPLE is not enforcing App Transparency Layer (pop-up)
| AppSDK 8.0
| AppSDK 8.0
| Apple not mandating consent pop-up.
| Apple not mandating consent pop-up.
Line 74: Line 76:
|  
|  
|-
|-
| iOS/tvOS 14<br />APPLE is enforcing App Transparency Layer (pop-up)
| iOS/tvOS 14.5+<br />APPLE is enforcing App Transparency Layer (pop-up)
| AppSDK 8.0
| AppSDK 8.0
| Client has not implemented the consent pop-up.
| Client has not implemented the consent pop-up.
Line 97: Line 99:
* iOS14 modifies the way Apple manages the collection of a User's Opt-In status through '''AppTracking'''. Starting with Version 8.x+, the Nielsen App SDK will check the iOS version during initialization. If the device is running iOS12 or iOS13, the Limit Ad Tracking setting is requested. If iOS14.x +, then AppTracking is utilized.
* iOS14 modifies the way Apple manages the collection of a User's Opt-In status through '''AppTracking'''. Starting with Version 8.x+, the Nielsen App SDK will check the iOS version during initialization. If the device is running iOS12 or iOS13, the Limit Ad Tracking setting is requested. If iOS14.x +, then AppTracking is utilized.
If using the Nielsen SDK V7 on a device running iOS14, the value returned will always be isAdvertisingTrackingEnabled = true opting out the user from demographic measurement.
If using the Nielsen SDK V7 on a device running iOS14, the value returned will always be isAdvertisingTrackingEnabled = true opting out the user from demographic measurement.
Apple is currently not requiring publishers to secure consent from the user. This means if the AppTracking Setting is either notDetermined or approved, the User is Opted in.
Apple started requiring publishers to secure consent from the user in iOS14.5+. This means the AppTracking Setting must equal approved before the User is Opted in.
* '''Limit Ad Tracking''' is managed using the isAdvertisingTrackingEnabled value.
* '''Limit Ad Tracking''' is managed using the isAdvertisingTrackingEnabled value.
{| class="wikitable" style="background-color:#F3F3F3;"
{| class="wikitable" style="background-color:#F3F3F3;"
Line 116: Line 118:
! style="color:#222;" | Opt in/out Status
! style="color:#222;" | Opt in/out Status
|- style="background-color:#D9EAD3; color:#222;"
|- style="background-color:#D9EAD3; color:#222;"
| ATTrackingManager.AuthorizationStatus.authorized<br />ATTrackingManager.AuthorizationStatus.notDeterminded
| ATTrackingManager.AuthorizationStatus.authorized
| User will be included in demographic measurement.
| User will be included in demographic measurement.
|- style="background-color:#FCF0E4; color:#222;"
|- style="background-color:#FCF0E4; color:#222;"
| ATTrackingManager.AuthorizationStatus.denied<br />ATTrackingManager.AuthorizationStatus.restricted
| ATTrackingManager.AuthorizationStatus.notDeterminded<br />ATTrackingManager.AuthorizationStatus.denied<br />ATTrackingManager.AuthorizationStatus.restricted
| User will NOT be included in demographic measurement.
| User will NOT be included in demographic measurement.
|}
|}

Latest revision as of 18:39, 22 September 2023

Engineering Portal / Digital / US DCR & DTVR / DCR Video iOS14 Migration


Overview

NOTE: this page is for historical reference. In addition to dealing with App Tracking Transparency, developers should also be aware of changes related to iOS 17 detailed here: Nielsen_Digital_Measurement_and_iOS17_or_TVOS17

Apple recently released a new policy on consent requirements for its mobile advertising tool, Identifier for Advertisers (IDFA). With this new policy, (App Tracking Setting) users can choose whether an IDFA may be used by mobile applications. iOS 14 was released on Sept 16th.

What does this mean for measurement?

Apple added a new Framework called “The App Tracking Transparency Framework”. This is now required to control whether the Ad Framework will return the IDFA. If our app requests the IDFA, but advertisingTrackingEnabled=No, then we will get: IDFA = 00000000 -0000-0000-0000-000000000000. If a client is using our APP SDK v7 and below, running on a device with iOS14 installed, as this is a new framework, our SDK will never be able to retrieve the IDFA.

Version 8 of our App SDK will come in two versions. One that is enabled to work with the App Tracking Transparency Framework, and another version that does not use the Ad Framework. A Table outlining the various iOS versions and Nielsen AppSDK versions is located later in this document.

Transparency Framework

Apple was going to force all publishers to check if ATTrackingManager. AuthorizationStatus was equal to authorized. Now however, since they are not forcing publishers to ask the user, as long as the ATTrackingManager.AuthorizationStatus is equal to undefined, or authorized, you are allowed to grab the IDFA value. The change they made was to allow us to use undefined as a valid state. To display the App Tracking Transparency authorization request for accessing the IDFA, update your info.plist to add the NSUserTrackingUsageDescription key with a custom message describing your usage.

SDK Versions and Behavior

OS SDK Flavor/Version LAT/Tracking Opt-out Status Opt-out URL Integration Changes
iOS/tvOS 13 and below Appsdk < 7.2 LAT works fine As per LAT LAT URL No Changes
iOS/tvOS 13 and below Appsdk without ad framework < 7.2 NA (Not Applicable) User choice opt-out/in User choice opt-out/in url No Changes
iOS/tvOS 13 and below AppSDK 8.0 LAT works fine As per LAT LAT URL No Changes
iOS/tvOS 13 or 14 Appsdk 8.0 without Ad Framework NA (Not Applicable) User choice opt-out/in User choice opt-out/in url No Changes
iOS/tvOS 14 Appsdk < 7.2 No support for new Apple tracking API Opt-out will be marked as true LAT URL Yes, Clients to upgrade to SDK 8.0
iOS/tvOS 14 AppSDK 8.0 Client has implemented the Consent pop-up. As per LAT LAT URL Yes, Clients to implement pop-up and app store verbiage
iOS/tvOS 14.0 - 14.4
APPLE is not enforcing App Transparency Layer (pop-up)
AppSDK 8.0 Apple not mandating consent pop-up. As per LAT LAT URL
iOS/tvOS 14.5+
APPLE is enforcing App Transparency Layer (pop-up)
AppSDK 8.0 Client has not implemented the consent pop-up. As per LAT LAT URL Yes, Clients to implement pop-up and app store verbiage
iOS/tvOS 14 Appsdk 8.0 without Ad Framework Clients denied the Ad Framework SDK User choice opt-out/in User choice opt-out/in url Yes, Clients implement webview to pass user choice to the sdk. No changes for AGF no ad framework clients.

Privacy and Opt-Out

OS-level Opt-out

The Nielsen SDK automatically leverages the iOS's Limit Ad Tracking or AppTracking setting.

  • If the User's device is running < iOS 13.x, the Nielsen SDK will check the status of Limit Ad Tracking (Located under Privacy >> Advertising). If this is enabled, the user will be opted out of demographic measurement.
  • iOS14 modifies the way Apple manages the collection of a User's Opt-In status through AppTracking. Starting with Version 8.x+, the Nielsen App SDK will check the iOS version during initialization. If the device is running iOS12 or iOS13, the Limit Ad Tracking setting is requested. If iOS14.x +, then AppTracking is utilized.

If using the Nielsen SDK V7 on a device running iOS14, the value returned will always be isAdvertisingTrackingEnabled = true opting out the user from demographic measurement. Apple started requiring publishers to secure consent from the user in iOS14.5+. This means the AppTracking Setting must equal approved before the User is Opted in.

  • Limit Ad Tracking is managed using the isAdvertisingTrackingEnabled value.
Value Returned in iOS12 / iOS13 using Nielsen SDK < V7.x Opt in/out Status
isAdvertisingTrackingEnabled = false User will be included in demographic measurement.
isAdvertisingTrackingEnabled = true User will NOT be included in demographic measurement.
Value Returned is iOS14 using Nielsen SDK > V8.x Opt in/out Status
ATTrackingManager.AuthorizationStatus.authorized User will be included in demographic measurement.
ATTrackingManager.AuthorizationStatus.notDeterminded
ATTrackingManager.AuthorizationStatus.denied
ATTrackingManager.AuthorizationStatus.restricted
User will NOT be included in demographic measurement.

The user is opted out of demographic measurement if the OS-level Limit Ad Tracking setting is enabled, or AppTracking value equals denied or restricted. As a publisher, you cannot override this setting.

User Choice

The User Choice method can be used without the Ad Framework, or in situations where the publisher does not wish to use the App Tracking Transparency Framework.