Configurar a coleta e o uso de dados do Analytics

iOS+ Android

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

Desativar coleta de dados do Analytics

Em alguns casos, você pode querer desabilitar temporária ou permanentemente a coleta de dados do 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 desativar e desativar a coleta do Analytics. Usados ​​em conjunto, eles oferecem suporte a muitos casos de uso típicos.

Desativar coleta temporariamente

Se desejar desativar temporariamente a coleta do Analytics, como para obter o consentimento do usuário final antes de coletar dados, você 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, por exemplo, após o consentimento de um usuário final, chame o método de instância setAnalyticsCollectionEnabled do Analytics . Por exemplo:

Analytics.setAnalyticsCollectionEnabled(true)

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

Analytics.setAnalyticsCollectionEnabled(false)

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

e a coleta será 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 que você definir um valor para setAnalyticsCollectionEnabled , a coleta do Analytics permanecerá nesse estado até que setAnalyticsCollectionEnabled seja chamado novamente, mesmo que um usuário feche e reabra seu aplicativo.

Desativar coleção permanentemente

Se você precisar desativar permanentemente a coleta do Analytics em uma versão do seu aplicativo, defina FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (Booleano) no arquivo Info.plist do seu aplicativo. Definir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como YES (Booleano) tem prioridade sobre quaisquer valores de 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 do seu Info.plist . Definir FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED como NO (Booleano) não tem efeito e resulta no mesmo comportamento que 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 (um 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 qualquer 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:

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

Desativar coleta de IDFV

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

Controle a coleta de dados para publicidade personalizada

Se você vinculou seu projeto do Google Analytics a uma conta de anúncios, ativou uma integração de anúncios ou optou pelo compartilhamento de dados , seus dados do Analytics poderão 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-alvo para remarketing, a menos que indique que tais dados não estão disponíveis para publicidade personalizada.

Você pode controlar programaticamente se os dados do Analytics de um usuário devem ser usados ​​para publicidade personalizada usando qualquer uma das seguintes opções:

• Recomendado : ative ou desative dinamicamente a personalização de anúncios respeitando a escolha de consentimento do usuário. Implemente 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 .

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

Desative recursos de publicidade personalizados por meio de uma propriedade do usuário

No entanto, se o seu aplicativo ainda não usa o modo de consentimento, você pode 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 seu aplicativo.

Reativar recursos de publicidade personalizados por meio de uma propriedade do usuário

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

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

Se você optou por desativar temporariamente a coleta de análises (por exemplo, até que um usuário final forneça consentimento) e deseja controlar os recursos de publicidade personalizados 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:

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

[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 valor 1 para indicar que os eventos nesse pacote não estão disponíveis para anúncios personalizados. anúncio. A desativação da 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 faz download das 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 no seu aplicativo. Se o seu aplicativo estiver ativo, o processo completo de implantação poderá levar até uma hora para ser concluído.