配置 Analytics 数据收集和使用方式



本页介绍了 Google Analytics 提供的一些功能，您可以使用这些功能控制 Analytics 数据的收集和使用。

停用 Analytics 数据收集

在某些情况下，您可能出于某些原因（比如要获得最终用户同意或履行法律义务），需要暂时或永久停用 Analytics 数据收集。Google Analytics 提供了多个用于暂时或永久停用 Analytics 数据收集的选项。您可以组合使用这些选项以应对多种使用场景。

暂时停用数据收集

如果您出于某些原因（例如为了在收集数据前征得最终用户的同意）希望暂时停用 Analytics 数据收集功能，可以在应用的 AndroidManifest.xml 的 application 标记中将 firebase_analytics_collection_enabled 的值设置为 false。例如：

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

如需重新启用收集功能（例如在最终用户提供同意后），请调用 FirebaseAnalytics 类的 setAnalyticsCollectionEnabled() 方法。例如：

KotlinJavaUnity
setAnalyticsCollectionEnabled(true);

setAnalyticsCollectionEnabled(true);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

如果您因任何原因需要再次暂停数据收集，则可调用以下代码，在您重新启用数据收集之前，数据收集将处于暂停状态。

KotlinJavaUnity
setAnalyticsCollectionEnabled(false);

setAnalyticsCollectionEnabled(false);

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

永久停用数据收集

如果您需要在应用的某个版本中永久停用 Analytics 数据收集功能，可以在应用的 AndroidManifest.xml 的 application 标记中将 firebase_analytics_collection_deactivated 设置为 true。例如：

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

停用广告 ID 收集

如果您希望在 Android 应用中禁止收集广告 ID，可以在应用的 AndroidManifest.xml 的 application 标记中将 google_analytics_adid_collection_enabled 的值设置为 false。例如：

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

控制个性化广告的数据收集

如果您已将 Google Analytics 项目与广告账号相关联或以其他方式启用了广告集成，或已选择启用数据共享，那么您的 Analytics 数据可能可以用在个性化广告中。这意味着您可以使用收集的事件（例如 first_open）创建和部署受众群体名单来开展再营销，除非您指明此类数据不适用于个性化广告。

您可以通过以下任一方法以编程方式控制是否应将用户的 Google Analytics 数据用于个性化广告：

通过用户属性停用个性化广告功能

Google 的意见征求模式 API 是用于启用和停用个性化广告的推荐方式。

不过，如果您的应用尚未使用意见征求模式，您可以使用以下选项控制个性化设置。

如需默认停用个性化广告行为，请在应用的 AndroidManifest.xml 的 application 标记中指定以下字段：

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

通过用户属性重新启用个性化广告功能

如果您使用 google_analytics_default_allow_ad_personalization_signals 参数来控制广告个性化，则可以使用 setUserProperty 方法重新启用广告个性化，如下所示：

KotlinJavaUnity
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );

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

如果您已选择暂时停用 Analytics 数据收集（例如，在最终用户同意之前停用），并且您希望在为用户重新启用 Analytics 数据收集时控制个性化广告功能，请确保您为指定此设置进行的调用先于为重新启用 Analytics 数据收集进行的调用。例如：

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);

确认您的设置

当您已通过上面定义的某种机制为用户停用广告个性化信号时，从该用户的设备记录的后续事件捆绑包将包含名为 non_personalized_ads 的用户属性（其值为 1），以指明该捆绑包中的事件不适用于个性化广告。停用个性化广告不会影响将数据用于衡量目的，包括报告和归因。

查看您的配置更改

对 Google Analytics 设置进行更改后，SDK 就会下载更改的内容。该过程既快速又无缝，因此您可以快速测试您的更改。当您在 Analytics 中进行更改时，可能需要几分钟时间才能在应用中完成部署。如果您的应用已发布，则完整的部署过程最多可能需要一个小时才能完成。