ไปที่คอนโซล

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

Google Analytics for Firebase 提供了一些功能,您可以使用这些功能控制 Analytics(分析)数据的收集和使用。

停用 Analytics 数据收集

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

暂时停用数据收集

如果您出于某些原因(比如要在收集数据前获得最终用户同意)要暂时停用 Analytics 数据收集,则可以在应用的 Info.plist 文件中,将 FIREBASE_ANALYTICS_COLLECTION_ENABLED 的值设为 NO(布尔值)。例如,在源 XML 中查看:

<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>

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

Swift

Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:YES]

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

Swift

Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO]

在您重新启用数据收集之前,该功能将始终处于暂停状态。由 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 时一样的行为。

停用 IDFA 收集

如果您希望在 iOS 应用中停用 IDFA(广告标识符)收集,请确保您的应用中未包含 AdSupport 框架

停用 IDFV 收集

如果您希望在 iOS 应用中停用 IDFA(供应商标识符)收集,请在应用的 Info.plist 文件中将 GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED 的值设为 NO(布尔值)。

配置 Analytics 数据的使用方式

停用个性化广告功能

如果您已将 Google Analytics for Firebase 项目与广告帐号相关联或以其他方式启用了广告集成,或已选择启用数据共享,则您的 Analytics 数据可能有资格用在个性化广告中。这意味着,例如,您可以使用收集的事件(例如 first_open)创建和部署受众群体列表来开展再营销,除非您指明此类数据不适用于个性化广告。

要以编程方式指明用户未来的 Analytics 数据不应用于个性化广告,请在应用的 Info.plist 文件中,将 GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS 的值设为 NO(布尔值)。

重新启用个性化广告功能

要在运行时为用户重新启用个性化广告功能(例如在最终用户同意后),请使用如下所示的 setUserProperty 方法:

Swift

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

Objective-C

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

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

Swift

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

Objective-C

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

确认您的设置

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