Configurar a coleta e uso dos dados do Analytics

Esta página descreve os recursos que o Google Analytics oferece para que você controle a coleta e o uso dos dados do Google Analytics.

Desativar a coleta de dados do 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 desativar e desativar a coleta de Analytics. Usadas juntas, elas são compatíveis com muitos casos de uso típicos.

Desativar temporariamente a coleta

Se você quiser desativar temporariamente a coleta do Analytics, por exemplo, para conseguir 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 aplicativo. 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. Por exemplo:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

Se por algum motivo for necessário suspender a coleta novamente, você poderá chamar o seguinte, e a coleta será suspensa até que você a reative.

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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 aplicativo.

Desativar a coleta permanentemente

Se você precisar desativar a coleta do Analytics permanentemente em uma versão do aplicativo, defina FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (booleano) no arquivo Info.plist do app. 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:

• Privacidade do usuário e uso de dados
• Transparência no rastreamento de apps

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.

Controlar a coleta de dados para 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.

É possível controlar de maneira programática se os dados do Analytics de um usuário vão ser usados para publicidade personalizada usando qualquer uma das seguintes opções:

• Recomendado: ative ou desative de maneira dinâmica a personalização de anúncios respeitando a escolha de consentimento do usuário. Implementar a API do modo de consentimento do Google.

• Ative ou desative a personalização de anúncios no nível do usuário: Controle a personalização de anúncios como uma propriedade do usuário.

• Ative ou desative a personalização de anúncios no nível da propriedade do Analytics: Desativar a personalização de anúncios por região geográfica na sua propriedade do Analytics.

Desativar recursos de publicidade personalizada usando uma propriedade do usuário

No entanto, se o app ainda não usa o modo de consentimento, é possível controlar a personalização com a opção a seguir.

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

Reativar recursos de publicidade personalizada usando uma propriedade do usuário

Se você usar o parâmetro AnalyticsUserPropertyAllowAdPersonalizationSignals para controlar a personalização de anúncios, poderá reativá-la com o método setUserProperty, conforme mostrado abaixo:

Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

Se você escolheu desativar temporariamente a coleta do Analytics, 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 sua chamada para especificar essa configuração precede sua chamada para reativar a coleta do Analytics. Por exemplo:

Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

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ê faz mudanças nas configurações de Google Analytics, o SDK faz 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 ela ser implantada no app. Se o app estiver ativo, o processo de implantação completo poderá levar uma hora para ser concluído.