停用 Analytics 数据收集

在某些情况下,您可能需要出于某些原因(比如要获得最终用户许可或履行法律义务),暂时或永久停止收集 Analytics 数据。Google Analytics for Firebase 提供了多个用于暂时或永久停用 Analytics 数据收集的选项。您可以组合使用这些选项以应对多种常见情形。

在 Android 上停用 Analytics 数据收集

暂时停用数据收集

如果您出于某些原因(比如要在收集数据前获得最终用户许可)要暂时停用 Analytics 数据收集,则可以在应用的 AndroidManifest.xml 中,将 application 标记中 firebase_analytics_collection_enabled 的值设为 false。例如:

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

要重新启用数据收集(例如在最终用户同意后),请调用 FirebaseAnalytics 类的 setAnalyticsCollectionEnabled() 方法。例如:

setAnalyticsCollectionEnabled(true);

如果您因任何原因需要再次暂停数据收集,则可调用

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" />

在 iOS 上停用 Analytics 数据收集

暂时停用数据收集

如果您出于某些原因(比如要在收集数据前获得最终用户许可)要暂时停用 Analytics 数据收集,可以在应用的 Info.plist 文件中将 FIREBASE_ANALYTICS_COLLECTION_ENABLED 的值设为 NO

要重新启用数据收集(例如在最终用户同意后),请调用 FIRAnalyticsConfigurationsetAnalyticsCollectionEnabled 实例方法。例如:

Objective-C

[[FIRAnalyticsConfiguration sharedInstance] setAnalyticsCollectionEnabled:YES]

Swift

AnalyticsConfiguration.shared().setAnalyticsCollectionEnabled(true)

如果您因任何原因需要再次暂停数据收集,则可调用

Objective-C

[[FIRAnalyticsConfiguration sharedInstance] setAnalyticsCollectionEnabled:NO]

Swift

AnalyticsConfiguration.shared().setAnalyticsCollectionEnabled(false)

在您重新启用数据收集之前,该功能将始终处于暂停状态。由 setAnalyticsCollectionEnabled 方法设置的值用于应用每次执行,并覆盖应用 Info.plist 文件中的 FIREBASE_ANALYTICS_COLLECTION_ENABLED 值。在您设置 setAnalyticsCollectionEnabled 的值后,Analytics 数据收集的状态将维持到您再次调用 setAnalyticsCollectionEnabled,即使用户关闭并重新打开应用也是如此。

永久停用数据收集

如果您需要在某个版本的应用中永久停用 Analytics 数据收集,请在应用的 Info.plist 文件中将 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 设为 YES。将 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 设置为 YES 后,此设置的优先级会高于应用的 Info.plist 中的 FIREBASE_ANALYTICS_COLLECTION_ENABLED 值和通过 setAnalyticsCollectionEnabled 设置的值。

要重新启用数据收集,请从您的 Info.plist 中移除 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED。将 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 设为 NO 没有任何效果,其导致的应用行为与不在 Info.plist 文件中设置 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 并无二致。

发送以下问题的反馈:

此网页
需要帮助?请访问我们的支持页面