Configurar a coleta e uso dos dados do Analytics

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

Desativar a coleta de dados do Google Analytics

Em alguns casos, pode ser útil desativar de forma temporária ou permanente a coleta de dados do Analytics, seja para conseguir o consentimento do usuário final ou cumprir obrigações legais. O Google Analytics oferece várias opções para desabilitar e desativar a coleta do Analytics. Usadas juntas, elas são compatíveis com muitos casos de uso típicos.

Desativar temporariamente a coleta

Se quiser desativar temporariamente a coleta do Analytics, por exemplo, para receber o consentimento do usuário final antes de coletar os dados, defina o valor de FIREBASE_ANALYTICS_COLLECTION_ENABLED como NO (booleano) no arquivo Info.plist do seu app. Confira abaixo um exemplo de como isso é exibido no XML de origem:

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

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

Swift

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

Objective-C

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

Se por algum motivo for necessário suspender a coleta, você poderá chamar

Swift

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

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

e a coleta será suspensa até a reativação. O valor definido pelo método setAnalyticsCollectionEnabled persiste entre as execuções do app e modifica o valor de FIREBASE_ANALYTICS_COLLECTION_ENABLED no arquivo Info.plist do app. Depois de definir um valor para setAnalyticsCollectionEnabled, a coleta do Analytics permanece nesse estado até que setAnalyticsCollectionEnabled seja chamado novamente, mesmo que um usuário feche e reabra seu app.

Desativar a coleta permanentemente

Se você precisar desativar a coleta do Analytics de forma permanente em uma versão do app, defina FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (booleano) no app Info.plist file. Definir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (booleano) tem prioridade sobre os valores de FIREBASE_ANALYTICS_COLLECTION_ENABLED no Info.plist do app, bem como nos valores definidos com setAnalyticsCollectionEnabled.

Para reativar a coleta, remova FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED de Info.plist. A definição de FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como NO (booleano) não causa efeito e resulta no mesmo comportamento de uma situação em que FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED não tenha sido definido no arquivo Info.plist.

Desativar a coleta do IDFA

Se você instalou o Firebase pelo CocoaPods adicionando pod 'Firebase/Analytics' ao Podfile do app e quer desativar a coleta do IDFA (identificador de publicidade de um dispositivo) no app da Apple, verifique se o framework AdSupport está incluído no app.

Para instalar o Firebase sem recursos de coleta do IDFA, use o subspec a seguir em vez de pod 'Firebase/Analytics':

pod 'Firebase/AnalyticsWithoutAdIdSupport'

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

Desativar a coleta do IDFV

Se você quiser desativar a coleta do identificador para o fornecedor (IDFV, na sigla em inglês) no app da Apple, defina o valor de GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED como NO (booleano) no arquivo Info.plist do app.

Configurar o uso de dados do Analytics

Desativar recursos de publicidade personalizada

Se você vinculou seu projeto do Google Analytics a uma conta do Google Ads, ativou uma integração de anúncios ou permitiu o compartilhamento de dados, então é possível que seus dados do Analytics estejam 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-alvo para remarketing, a menos que você especifique que esses dados não estão disponíveis para publicidade personalizada.

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

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

Nas configurações de propriedade do Google Analytics, também é possível usar a configuração de personalização de anúncios para controlar se os dados coletados de usuários finais podem ser usados para essa finalidade.

Reativar recursos de publicidade personalizada

Para reativar os recursos de publicidade personalizada para um usuário no ambiente de execução, por exemplo, após o consentimento do usuário final, use o método setUserProperty mostrado abaixo:

Swift

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

Objective-C

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

Se você escolheu desativar temporariamente a coleta de análise, por exemplo, até que um usuário final forneça consentimento, e quiser controlar os recursos de publicidade personalizada ao reativar a coleta do Analytics para um usuário, verifique se a chamada para especificar essa configuração precede chamada para reativar a coleta de análise. Exemplo:

Swift

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

Objective-C

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

Confirmar as configurações

Quando os indicadores de personalização de anúncios forem desativados para um usuário usando um dos mecanismos descritos acima, os pacotes de eventos subsequentes registrados pelo dispositivo desse usuário vão conter uma propriedade de usuário chamada non_personalized_ads (anúncios não personalizados) com um valor de 1 para indicar que os eventos desse 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 a geração de relatórios e a atribuição.

Ver as alterações na configuração

Depois que você fizer mudanças nas configurações do Google Analytics, o SDK fará o download delas. O processo é rápido e integrado. Assim, você pode testar rapidamente as alterações. Quando você faz mudanças no Analytics, pode levar alguns minutos para ele ser implantado no app. Se o app estiver ativo, o processo de implantação completo poderá levar uma hora para ser concluído.