管理用户意见征求设置(应用)

通过 Google Analytics(分析)提供的意见征求模式,您可以根据用户的同意情况来调整 Google 代码的运作方式。您可以指明是否已就使用 Google Analytics(分析)标识符和 Google Ads 标识符征得了用户同意。若要为应用实现意见征求模式,请使用 Google Analytics for Firebase SDK 设置默认设置,然后根据应用内的用户意见征求使用 setConsent API 以编程方式管理设置。如需了解详情,请参阅意见征求模式

初始设置

默认情况下,Google Analytics(分析)和 Google Ads 存储都处于启用状态。请按照以下说明更改应用的默认状态。

Google Analytics(分析)存储

若要停用 Google Analytics(分析)存储,请在应用的 Info.plist 文件中将 GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE 的值设置为 NO。例如,在源 XML 中查看:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_ANALYTICS_STORAGE</key>
<false/>

Google Ads 存储

若要停用 Google Ads 存储,请在应用的 Info.plist 文件中将 GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE 的值设置为 NO。例如,在源 XML 中查看:

<key>GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_STORAGE</key>
<false/>

若要重新启用 Google Analytics(分析)和 Google Ads 存储(例如在最终用户表示同意之后),请调用 AnalyticssetConsent 实例方法。

若要在应用启动后更新 Google Analytics(分析)和 Google Ads 存储的值,请调用 setConsent 方法。

即使应用多次执行,通过 setConsent 方法设置的值也会保持不变,并覆盖默认设置。即使用户关闭并重新打开应用,该值也会保持这种状态,直到再次调用 setConsent。调用 setConsent 来修改 Google Ads 存储不会改变 Google Analytics(分析)存储的状态。

以下示例展示了将 Google Analytics(分析)和 Google Ads 存储的值更新为 granted 的 setConsent 方法:

Swift

Analytics.setConsent([
  .analyticsStorage: .granted
  .adStorage: .granted
])

Objective-C

[FIRAnalytics setConsent:@{
  FIRConsentTypeAnalyticsStorage : FIRConsentStatusGranted
  FIRConsentTypeAdStorage : FIRConsentStatusGranted
}];

您可以通过查看应用的 Xcode 调试控制台,验证您的用户意见征求设置是否按预期运行。

请按照以下步骤操作:

  1. 在您的设备上启用详细日志记录
  2. 在 Xcode 调试控制台中,查找 ad_storageanalytics_storage。例如,如果同时启用了 Google Analytics(分析)和 Google Ads 存储,您会看到以下消息:

    ad_storage is granted. analytics_storage is granted.