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
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Se por algum motivo for necessário suspender a coleta, você poderá chamar
Swift
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
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[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
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[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.