Supporto IDFA (solo iOS)
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Seleziona la piattaforma:
iOS
Flutter
L'SDK User Messaging Platform (UMP) ti consente di mostrare un
messaggio IDFA
ai tuoi utenti prima di richiedere il loro consenso per
App Tracking Transparency
(ATT). Il messaggio IDFA mostra agli utenti come la tua app utilizza l'identificatore.
Questa guida spiega come utilizzare l'SDK UMP per presentare un messaggio IDFA.
Prerequisiti
Prima di iniziare, assicurati di aver fatto quanto segue:
Aggiorna Info.plist
Per mostrare un messaggio di avviso personalizzato:
- Apri il file
Info.plist.
- Aggiungi il tasto
NSUserTrackingUsageDescription con un messaggio personalizzato che
descriva l'utilizzo:
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
La descrizione dell'utilizzo viene visualizzata nell'avviso ATT IDFA quando presenti il
modulo di consenso:
Quindi, collega il framework AppTrackingTransparency:
La tua app mostra quindi un messaggio IDFA prima dell'avviso ATT.
Test
Durante il test, ricorda che l'avviso ATT viene visualizzato una sola volta perché
requestTrackingAuthorization
è una richiesta una tantum. L'SDK UMP ha un modulo disponibile per il caricamento solo se lo stato di autorizzazione è
ATTrackingManagerAuthorizationStatusNotDetermined.
Per visualizzare di nuovo l'avviso, devi disinstallare e reinstallare l'app sul dispositivo di test.
Richiedere annunci con o senza IDFA
Se un utente nega il monitoraggio ATT, continua a richiedere annunci utilizzando le API del formato dell'annuncio. L'SDK Google Mobile Ads non invia l'IDFA nella richiesta di annuncio. Per maggiori dettagli, vedi
Selezionare un formato dell'annuncio.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-09-06 UTC.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-06 UTC."],[[["\u003cp\u003eThis 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.\u003c/p\u003e\n"],["\u003cp\u003eBefore starting, ensure you have completed the UMP SDK setup and created an IDFA message in Google Ad Manager.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your app's \u003ccode\u003eInfo.plist\u003c/code\u003e file to include the \u003ccode\u003eNSUserTrackingUsageDescription\u003c/code\u003e key with a custom message explaining your data usage for personalized ads, which will be displayed in the ATT dialog.\u003c/p\u003e\n"],["\u003cp\u003eLink the \u003ccode\u003eAppTrackingTransparency\u003c/code\u003e framework to enable the display of an IDFA explainer message before the ATT dialog appears.\u003c/p\u003e\n"],["\u003cp\u003eFor testing, remember the ATT dialog appears only once; reinstall the app to see it again after the initial authorization.\u003c/p\u003e\n"]]],["To support the IDFA message using the UMP SDK, first complete the \"Get started\" guide and create an IDFA message in Ad Manager. Update the `Info.plist` file by adding the `NSUserTrackingUsageDescription` key with a custom message explaining IDFA usage. Link the `AppTrackingTransparency` framework. During testing, remember the IDFA ATT dialog appears only once unless the app is uninstalled and reinstalled due to the one-time authorization request. The form is available if the authorization status is `ATTrackingManagerAuthorizationStatusNotDetermined`.\n"],null,["Select platform: [iOS](/ad-manager/mobile-ads-sdk/ios/privacy/idfa \"View this page for the iOS platform docs.\") [Flutter](/ad-manager/mobile-ads-sdk/flutter/privacy/idfa \"View this page for the Flutter platform docs.\")\n\n\u003cbr /\u003e\n\nThe User Messaging Platform (UMP) SDK lets you present an\n\n[IDFA message](//support.google.com/admanager/answer/10115027)\n\nto your users before requesting their consent for\n[App Tracking Transparency](//developer.apple.com/documentation/apptrackingtransparency)\n(ATT). The IDFA message shows your users how your app uses the identifier.\n\nThis guide covers using the UMP SDK to present an IDFA message.\n| **Note:** If you enable both GDPR and IDFA messages, refer to [Which message your users will\n| see](//support.google.com/admanager/answer/10075998#which-message-your-users-will-see) for the possible outcomes.\n\nPrerequisites\n\nBefore you begin, make sure you've done the following:\n\n- Complete the [Get started guide](/ad-manager/mobile-ads-sdk/flutter/privacy).\n- [Create an IDFA message](//support.google.com/admanager/answer/10116236) in the Ad Manager UI.\n\nUpdate Info.plist\n\nTo show a custom alert message, do the following:\n\n1. Open the `Info.plist` file.\n2. Add the `NSUserTrackingUsageDescription` key with a custom message that describes the usage:\n\n \u003ckey\u003eNSUserTrackingUsageDescription\u003c/key\u003e\n \u003cstring\u003eThis identifier will be used to deliver personalized ads to you.\u003c/string\u003e\n\nThe usage description appears as part of the IDFA ATT alert when you present the\nconsent form:\n\nThen, link the `AppTrackingTransparency` framework:\n\nYour app then shows an IDFA message before the ATT alert.\n\nTesting\n\nWhile testing, remember that the ATT alert only appears a single time since\n[`requestTrackingAuthorization`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanager/3547037-requesttrackingauthorization)\nis a one-time request. The UMP SDK only has a form available to load if the\nauthorization status is\n[`ATTrackingManagerAuthorizationStatusNotDetermined`](//developer.apple.com/documentation/apptrackingtransparency/attrackingmanagerauthorizationstatus/attrackingmanagerauthorizationstatusnotdetermined?language=objc).\n\nTo make the alert appear a second time, you must uninstall and reinstall your\napp on your test device.\n\nRequest ads with or without IDFA\n\nIf a user denies ATT, continue to request ads using your ad format's APIs. The\nGoogle Mobile Ads SDK doesn't send IDFA in the ad request. For more details see,\n[Select an ad format](/ad-manager/mobile-ads-sdk/flutter/quick-start#select_an_ad_format)."]]
