Prepare for iOS 14+

This guide outlines the changes needed to prepare your app for iOS 14.

Prerequisites

• Google Mobile Ads SDK 7.64.0 or higher

Enable SKAdNetwork to track conversions

The Google Mobile Ads SDK supports conversion tracking using Apple's SKAdNetwork, which means Google is able to attribute an app install even when IDFA is unavailable.

To enable this functionality, you will need to update the SKAdNetworkItems key with an additional dictionary in your Info.plist.

<key>SKAdNetworkItems</key>
  <array>
    <dict>
      <key>SKAdNetworkIdentifier</key>
      <string>cstr6suwn9.skadnetwork</string>
    </dict>
  </array>

Note: Additional SKAdNetworkIdentifier values may be added in the future. We recommend checking back on this page for updates.

Request App Tracking Transparency authorization

Key Point: If you choose to include App Tracking Transparency (ATT) in your app, we recommend using the User Messaging Platform (UMP) SDK to trigger an IDFA explainer giving users some context of why you're asking for this permission. If you're not using the UMP SDK, the rest of this section shows you how to implement the OS-level ATT authorization request manually.

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. Below is an example description text:

<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>

The usage description appears as part of the App Tracking Transparency dialog, as shown below:

To present the authorization request, call requestTrackingAuthorizationWithCompletionHandler:. We recommend waiting for the completion callback prior to loading ads, so that if the user grants the App Tracking Transparency permission, the Google Mobile Ads SDK can use the IDFA in ad requests.

Swift

import AppTrackingTransparency
import AdSupport
...
func requestIDFA() {
  ATTrackingManager.requestTrackingAuthorization(completionHandler: { status in
    // Tracking authorization completed. Start loading ads here.
    // loadAd()
  })
}

Objective-C

#import <AppTrackingTransparency/AppTrackingTransparency.h>
#import <AdSupport/AdSupport.h>
...
- (void)requestIDFA {
  [ATTrackingManager requestTrackingAuthorizationWithCompletionHandler:^(ATTrackingManagerAuthorizationStatus status) {
    // Tracking authorization completed. Start loading ads here.
    // [self loadAd];
  }];
}

For more information about the possible status values, see ATTrackingManager.AuthorizationStatus.

Key Point: For a better user experience, we highly recommend adding an explainer preceding the call to requestTrackingAuthorizationWithCompletionHandler: to better explain the permission and data usage to users.