Suporte ao IDFA (somente iOS)
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-13 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-13 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,[]]
