Suporte ao identificador para anunciantes (IDFA)
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Selecione a plataforma:
iOS
Flutter
Com o SDK da plataforma de mensagens para usuários (UMP), você pode apresentar uma
mensagem do IDFA
aos usuários antes de pedir o consentimento deles para a
Transparência no rastreamento de apps
(ATT). A mensagem do IDFA mostra aos usuários como seu app usa o identificador.
Este guia aborda o uso do SDK da UMP para apresentar uma mensagem sobre o IDFA.
Pré-requisitos
Antes de começar, verifique se você já fez o seguinte:
Atualizar Info.plist
Para mostrar uma mensagem de alerta personalizada, faça o seguinte:
- Abra o arquivo
Info.plist.
- Adicione a chave
NSUserTrackingUsageDescription com uma mensagem personalizada que descreve o uso:
<key>NSUserTrackingUsageDescription</key>
<string>This identifier will be used to deliver personalized ads to you.</string>
A descrição de uso aparece como parte do alerta ATT do IDFA quando você apresenta o formulário de consentimento:
Em seguida, vincule a estrutura AppTrackingTransparency:
Em seguida, o app mostra uma mensagem do IDFA antes do alerta ATT.
Teste
Durante o teste, lembre-se de que o alerta da ATT aparece apenas uma vez, já que
requestTrackingAuthorization
é uma solicitação única. O SDK da UMP só tem um formulário disponível para carregamento se o
status de autorização for
ATTrackingManagerAuthorizationStatusNotDetermined.
Para que o alerta apareça uma segunda vez, desinstale e reinstale o
app no dispositivo de teste.
Solicitar anúncios com ou sem IDFA
Se um usuário negar a ATT, continue solicitando anúncios usando as APIs do seu formato de anúncio. O SDK dos anúncios para dispositivos móveis do Google não envia o IDFA na solicitação de anúncio. Para mais detalhes, consulte Selecionar um formato de anúncio.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-09-02 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-09-02 UTC."],[[["\u003cp\u003eThis guide provides steps to integrate the IDFA message within the User Messaging Platform (UMP) SDK for iOS apps.\u003c/p\u003e\n"],["\u003cp\u003eBefore proceeding, complete the UMP SDK setup and create an IDFA message in AdMob.\u003c/p\u003e\n"],["\u003cp\u003eUpdate your app's \u003ccode\u003eInfo.plist\u003c/code\u003e with \u003ccode\u003eNSUserTrackingUsageDescription\u003c/code\u003e to present a custom message within Apple's App Tracking Transparency dialog.\u003c/p\u003e\n"],["\u003cp\u003eRemember to link the \u003ccode\u003eAppTrackingTransparency\u003c/code\u003e framework to display the IDFA explainer message before the ATT dialog.\u003c/p\u003e\n"],["\u003cp\u003eFor testing, reinstall the app to reset the IDFA authorization status and see the dialog again.\u003c/p\u003e\n"]]],["To support the IDFA message with the UMP SDK, complete the \"Get started\" guide and create an IDFA message. Update the `Info.plist` by adding the `NSUserTrackingUsageDescription` key with a custom message. Link the `AppTrackingTransparency` framework. During testing, note that the IDFA ATT dialog only appears once unless the app is reinstalled, due to `requestTrackingAuthorization` being a one-time request and the status needs to be `ATTrackingManagerAuthorizationStatusNotDetermined`.\n"],null,["Select platform: [iOS](/admob/ios/privacy/idfa \"View this page for the iOS platform docs.\") [Flutter](/admob/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/admob/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/admob/answer/10114020#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](/admob/ios/privacy).\n- [Create an IDFA message](//support.google.com/admob/answer/10115331) in the AdMob 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](/admob/ios/quick-start#select_an_ad_format)."]]
