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 quiser desativar temporariamente a coleta do Analytics para obter, por exemplo, o consentimento do usuário final antes de coletar dados, defina o valor de firebase_analytics_collection_enabled como false no AndroidManifest.xml do aplicativo na tag application. Por exemplo:

<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />

Para reativar a coleta, por exemplo, após o consentimento de um usuário final, chame o método setAnalyticsCollectionEnabled() da classe FirebaseAnalytics. Por exemplo:

KotlinJavaUnity
setAnalyticsCollectionEnabled(true);

setAnalyticsCollectionEnabled(true);

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.

KotlinJavaUnity
setAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled(false);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

Desativar a coleta permanentemente

Se precisar desativar a coleta do Analytics permanentemente em uma versão do aplicativo, defina firebase_analytics_collection_deactivated como "true" no AndroidManifest.xml do aplicativo na tag application. Por exemplo:

<meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />

Desativar a coleta do ID de publicidade

Se quiser desativar a coleta do ID de publicidade no app Android, defina o valor de google_analytics_adid_collection_enabled como false no AndroidManifest.xml do app na tag application. Por exemplo:

<meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />

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:

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

API do modo de consentimento do Google é a maneira recomendada de ativar e desativar a publicidade personalizada.

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, especifique o seguinte campo no AndroidManifest.xml do seu app na tag application:

<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="false" />

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

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

KotlinJavaUnity
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

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:

KotlinJavaUnity
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);

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.