IDFA support (iOS only)
Stay organized with collections
Save and categorize content based on your preferences.
This guide outlines the steps required to support the IDFA message as part of
the UMP SDK. It is intended to be paired with Get
started which gives an overview of how to get your app
running with the UMP SDK and the basics of setting up your message. This
guidance is specific to the IDFA message.
Prerequisites
Update Info.plist
If you plan to use the UMP SDK to handle Apple's App Tracking Transparency (ATT)
requirements, make sure you've created, configured, and published your
IDFA explainer message
in the Ad Manager UI.
In order for the UMP SDK to display a custom alert message in the iOS system
dialog, update your Info.plist to add the NSUserTrackingUsageDescription key
with a custom message string describing your usage.
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
The usage description appears as part of the ATT dialog when you present the
consent form:
Then, link the AppTrackingTransparency framework:
Your app now shows an IDFA explainer message prior to the IDFA ATT dialog.
Testing
While testing, remember that the IDFA ATT dialog only appears a single time
since
requestTrackingAuthorization
is a one-time request. The UMP SDK only has a form available to load if the
authorization status is
ATTrackingManagerAuthorizationStatusNotDetermined.
To make the alert appear a second time, you must uninstall and reinstall your
app on your test device.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-01-28 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-01-28 UTC."],[[["This guide explains how to implement the IDFA message within the User Messaging Platform (UMP) SDK for Flutter apps, specifically for handling Apple's App Tracking Transparency (ATT) requirements."],["Before starting, ensure you have completed the UMP SDK setup and created an IDFA message in Google Ad Manager."],["Update your app's `Info.plist` file to include the `NSUserTrackingUsageDescription` key with a custom message explaining your data usage for personalized ads, which will be displayed in the ATT dialog."],["Link the `AppTrackingTransparency` framework to enable the display of an IDFA explainer message before the ATT dialog appears."],["For testing, remember the ATT dialog appears only once; reinstall the app to see it again after the initial authorization."]]],[]]
