Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Configurar a coleta e o uso de dados do Analytics

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Google Analytics oferece recursos que permitem controlar a coleta e o uso de dados do Analytics.

Desativar a coleta de dados do Analytics

Em alguns casos, você pode desejar desabilitar temporária ou permanentemente a coleta de dados do Google Analytics, como para coletar o consentimento do usuário final ou para cumprir obrigações legais. O Google Analytics oferece várias opções para desabilitar e desativar a coleta do Analytics. Usados ​​juntos, eles suportam muitos casos de uso típicos.

Desativar temporariamente a coleta

Se você deseja desativar temporariamente a coleta do Analytics, como obter o consentimento do usuário final antes de coletar dados, pode definir o valor de FIREBASE_ANALYTICS_COLLECTION_ENABLED como NO (booleano) no arquivo Info.plist do seu aplicativo. Por exemplo, visualizado no XML de origem:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

Para reativar a coleta, como após o consentimento de um usuário final, chame o método de instância setAnalyticsCollectionEnabled do Analytics . Por exemplo:

Rápido

Observação: este produto Firebase não está disponível no destino macOS.
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Observação: este produto Firebase não está disponível no destino macOS.
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Se precisar suspender a coleta novamente por qualquer motivo, você pode ligar para

Rápido

Observação: este produto Firebase não está disponível no destino macOS.
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

e a coleta é suspensa até que você a reative. O valor definido pelo método setAnalyticsCollectionEnabled persiste nas execuções do aplicativo e substitui o valor de FIREBASE_ANALYTICS_COLLECTION_ENABLED no arquivo Info.plist do seu aplicativo. Depois de definir um valor para setAnalyticsCollectionEnabled , a coleta do Analytics permanece nesse estado até que setAnalyticsCollectionEnabled seja chamado novamente, mesmo se um usuário fechar e reabrir seu aplicativo.

Desativar coleção permanentemente

Se você precisar desativar a coleta do Analytics permanentemente em uma versão do seu aplicativo, defina FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (booleano) no Info.plist file do seu aplicativo . Definir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (booleano) tem prioridade sobre quaisquer valores para FIREBASE_ANALYTICS_COLLECTION_ENABLED no Info.plist do seu aplicativo, bem como quaisquer valores definidos com setAnalyticsCollectionEnabled .

Para reativar a coleta, remova FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED de seu Info.plist . Definir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como NO (Boolean) não tem efeito e resulta no mesmo comportamento de não ter FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED definido em seu arquivo Info.plist .

Desativar coleta de IDFA

Se você instalou o Firebase por meio do CocoaPods adicionando pod 'Firebase/Analytics' ao Podfile do seu aplicativo e deseja desativar a coleta do IDFA (identificador de publicidade do dispositivo) no seu aplicativo Apple, certifique-se de que a estrutura do AdSupport não esteja incluída no seu aplicativo.

Para instalar o Firebase sem nenhum recurso de coleta de IDFA, use a seguinte subespecificação no lugar do pod 'Firebase/Analytics' :

pod 'Firebase/AnalyticsWithoutAdIdSupport'

Saiba mais sobre o IDFA na documentação da Apple:

Desativar coleta de IDFV

Se você deseja desabilitar a coleta do IDFV (Identifier for Vendor) em seu aplicativo Apple, defina o valor de GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED como NO (Booleano) no arquivo Info.plist de seu aplicativo.

Configurar o uso de dados do Analytics

Desativar recursos de publicidade personalizada

Se você vinculou seu projeto do Google Analytics a uma conta de anúncios ou ativou uma integração de anúncios ou optou pelo compartilhamento de dados , seus dados do Analytics podem ser qualificados para uso em publicidade personalizada. Isso significa, por exemplo, que você pode usar eventos coletados como first_open para criar e implantar listas de público para remarketing, a menos que indique que esses dados não estão disponíveis para publicidade personalizada.

Para controlar programaticamente se os dados do Google Analytics de um usuário devem ser usados ​​para publicidade personalizada, defina o comportamento padrão apropriado no arquivo AndroidManifest.xml do aplicativo e use os métodos descritos abaixo para substituir esse comportamento padrão.

Para definir o comportamento padrão de publicidade personalizada, defina o valor de GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS como NO (booleano) no arquivo Info.plist do seu aplicativo.

Você também pode controlar se os dados coletados dos usuários finais podem ser usados ​​para personalização de anúncios por meio da configuração de personalização de anúncios , encontrada nas configurações de propriedade do Google Analytics.

Reative os recursos de publicidade personalizada

Para reativar os recursos de publicidade personalizada para um usuário em tempo de execução, como após o consentimento do usuário final, use o método setUserProperty conforme mostrado abaixo:

Rápido

Observação: este produto Firebase não está disponível no destino macOS.
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

Observação: este produto Firebase não está disponível no destino macOS.
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Se você optou por desabilitar temporariamente a coleta de análises (por exemplo, até que um usuário final forneça consentimento) e deseja controlar os recursos de publicidade personalizada ao reativar a coleta de análises para um usuário, certifique-se de que sua chamada para especificar essa configuração preceda sua chamada para reativar a coleta de análises. Por exemplo:

Rápido

Observação: este produto Firebase não está disponível no destino macOS.
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

Observação: este produto Firebase não está disponível no destino macOS.
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Confirme suas configurações

Quando os sinais de personalização de anúncios forem desativados para um usuário por meio de um dos mecanismos definidos acima, os pacotes de eventos subsequentes registrados no dispositivo desse usuário conterão uma propriedade de usuário chamada "non_personalized_ads" com um valor de 1 para indicar que os eventos nesse pacote não estão disponíveis para publicidade personalizada. Desativar a publicidade personalizada não afeta o uso dos dados para fins de medição, incluindo relatórios e atribuição.

Veja suas alterações de configuração

Depois de fazer alterações nas configurações do Google Analytics, o SDK baixa as alterações. O processo é rápido e contínuo, para que você possa testar rapidamente suas alterações. Quando você faz alterações no Analytics, pode levar alguns minutos para implantar em seu aplicativo. Se seu aplicativo estiver ativo, o processo de implantação completo pode levar até uma hora para ser concluído.