Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

配置分析數據收集和使用

谷歌分析提供的功能允許您控制分析數據的收集和使用。

禁用 Analytics 數據收集

在某些情況下,您可能希望暫時或永久禁用分析數據的收集,例如收集最終用戶的同意或履行法律義務。 Google Analytics 提供了多種選項來禁用和停用 Analytics 收集。一起使用時,它們支持許多典型用例。

暫時禁用收集

如果你想暫時禁用Analytics收集,如收集數據之前,讓最終用戶許可,您可以設置的值FIREBASE_ANALYTICS_COLLECTION_ENABLEDNO (布爾)在應用程序的Info.plist文件。例如,在源 XML 中查看:

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

要重新啟用收集,如後最終用戶提供同意,調用setAnalyticsCollectionEnabled的實例方法Analytics 。例如:

迅速

Analytics.setAnalyticsCollectionEnabled(true)

目標-C

[FIRAnalytics setAnalyticsCollectionEnabled:YES];

如果您因任何原因需要再次暫停收集,您可以致電

迅速

Analytics.setAnalyticsCollectionEnabled(false)

目標-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

並且收集會暫停,直到您重新啟用它。通過設置的值setAnalyticsCollectionEnabled整個應用程序的執行和替代值方法持久FIREBASE_ANALYTICS_COLLECTION_ENABLED在應用程序的Info.plist文件。一旦您設置一個值setAnalyticsCollectionEnabled直到Analytics收集停留在這個狀態setAnalyticsCollectionEnabled被再次調用,即使用戶關閉並重新打開您的應用程序。

永久停用收藏

如果你需要一個版本的應用程序永久停用Analytics收集,設置FIREBASE_ANALYTICS_COLLECTION_DEACTIVATEDYES在你的應用程序的Info.plist文件(布爾)。設置FIREBASE_ANALYTICS_COLLECTION_DEACTIVATEDYES (布爾)優先於任何值FIREBASE_ANALYTICS_COLLECTION_ENABLED在您的應用程序的Info.plist以及與設置的任何值setAnalyticsCollectionEnabled

要重新啟用收集,去除FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED從您的Info.plist。設置FIREBASE_ANALYTICS_COLLECTION_DEACTIVATEDNO (布爾)具有相同的行為沒有任何影響和結果FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED在Info.plist文件集。

禁用 IDFA 收集

如果通過的CocoaPods安裝火力地堡加入pod 'Firebase/Analytics'應用程式的Podfile並希望在您的iOS應用的IDFA的禁用集合(設備的廣告標識符),確保AdSupport框架不包括在你的應用程序。

沒有任何IDFA收集能力安裝火力地堡,請使用以下subspec代替pod 'Firebase/Analytics'

pod 'Firebase/AnalyticsWithoutAdIdSupport'

在 Apple 的文檔中了解有關 IDFA 的更多信息:

禁用 IDFV 收集

如果您在您的iOS應用希望將IDFV(標識符供應商)的禁用集合,設置的值GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLEDNO (布爾)在應用程序的Info.plist文件。

配置 Analytics 數據的使用

禁用個性化廣告功能

如果您已經將自己的谷歌Analytics(分析)項目的帳戶的廣告或者以其他方式啟用的廣告整合,或選擇加入數據共享,您的分析數據可能有資格獲得個性化的廣告中使用。這意味著,例如,你可以使用收集的事件,如first_open創建和部署觀眾列表進行再營銷,除非你表明這樣的數據不適用於個性化的廣告。

要以編程方式控制是否應將用戶的 Analytics 數據用於個性化廣告,請在應用的 AndroidManifest.xml 文件中設置適當的默認行為,然後使用下述方法覆蓋該默認行為。

要設置默認的個性化廣告的行為,設定的值GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALSNO (布爾)在應用程序的Info.plist文件。

您還可以控制是否從最終用戶收集的數據為廣告通過個性化可用於廣告的個性化設置,在谷歌Analytics(分析)“屬性設置中找到。

重新啟用個性化廣告功能

為了重新啟用的個性化廣告的特徵在於用於用戶在運行時,如後最終用戶提供許可,使用setUserProperty方法如下圖所示:

迅速

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

目標-C

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

如果您已選擇暫時禁用分析收集(例如,直到最終用戶同意),並且您希望在為用戶重新啟用分析收集時控制個性化廣告功能,請確保您在調用之前指定此設置調用以重新啟用分析收集。例如:

迅速

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

目標-C

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

確認您的設置

當通過上述定義的機制之一為用戶禁用廣告個性化信號時,從該用戶的設備記錄的後續事件包將包含名為“non_personalized_ads”的用戶屬性,值為 1 以指示該包中的事件不可用用於個性化廣告。禁用個性化廣告不會影響將數據用於衡量目的,包括報告和歸因。