Google Analytics 提供的功能可讓您控制 Analytics 資料的收集和使用。
禁用 Analytics 資料收集
在某些情況下,您可能希望暫時或永久停用 Analytics 資料的收集,例如收集最終使用者同意或履行法律義務。 Google Analytics 提供了多種用於停用和停用 Analytics 收集的選項。它們一起使用,支援許多典型用例。
暫時禁用收集
如果您希望暫時停用 Analytics 收集,例如在收集資料之前獲得最終使用者同意,則可以在應用程式的Info.plist
檔案中將FIREBASE_ANALYTICS_COLLECTION_ENABLED
的值設為NO
(布林值)。例如在來源XML中查看:
<key>FIREBASE_ANALYTICS_COLLECTION_ENABLED</key>
<false/>
若要重新啟用收集(例如在最終使用者同意後),請呼叫Analytics
的setAnalyticsCollectionEnabled
實例方法。例如:
迅速
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
如果您因任何原因需要再次暫停收款,您可以致電
迅速
Analytics.setAnalyticsCollectionEnabled(false)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:NO];
並且收集將暫停,直到您重新啟用它。 setAnalyticsCollectionEnabled
方法設定的值在應用程式執行過程中保持不變,並覆寫應用程式Info.plist
檔案中FIREBASE_ANALYTICS_COLLECTION_ENABLED
的值。一旦您設定了setAnalyticsCollectionEnabled
的值,Analytics 集合就會保持該狀態,直到再次呼叫setAnalyticsCollectionEnabled
為止,即使使用者關閉並重新開啟您的應用程式也是如此。
永久停用收集
如果您需要在應用程式版本中永久停用 Analytics 收集,請在應用程式的Info.plist file
中將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 收集
如果您透過 CocoaPods 透過將pod 'Firebase/Analytics'
新增至已套用的 Podfile 來安裝 Firebase,並且希望在 Apple 應用程式中停用 IDFA(裝置的廣告識別碼)收集,請確保 AdSupport 框架不包含在您的應用程式中。
若要安裝沒有任何 IDFA 收集功能的 Firebase,請使用下列子規格取代pod 'Firebase/Analytics'
:
pod 'Firebase/AnalyticsWithoutAdIdSupport'
在 Apple 文件中了解有關 IDFA 的更多資訊:
禁用 IDFV 收集
如果您希望在 Apple 應用程式中停用 IDFV(供應商識別碼)的收集,請在應用程式的Info.plist
檔案中將GOOGLE_ANALYTICS_IDFV_COLLECTION_ENABLED
的值設為NO
(布林值)。
配置 Analytics 數據的使用
停用個人化廣告功能
如果您已將 Google Analytics(分析)項目連結到廣告帳戶或以其他方式啟用了廣告集成,或選擇了資料共享,則您的 Analytics(分析)資料可能有資格用於個人化廣告。例如,這表示您可以使用收集的事件(例如first_open
來建立和部署受眾群體清單以進行再行銷,除非您表明此類資料無法用於個人化廣告。
若要以程式方式控制使用者的 Analytics 資料是否套用於個人化廣告,請在應用程式的 AndroidManifest.xml 檔案中設定適當的預設行為,然後使用下面描述的方法覆寫該預設行為。
若要設定預設的個人化廣告行為,請在套用的Info.plist
檔案中將GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
的值設為NO
(布林值)。
您也可以透過 Google Analytics(分析)屬性設定中的廣告個人化設定控制從最終用戶收集的資料是否可用於廣告個人化。
重新啟用個人化廣告功能
若要在執行時(例如在最終使用者同意後)為使用者重新啟用個人化廣告功能,請使用setUserProperty
方法,如下所示:
迅速
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
如果您選擇暫時停用分析收集(例如,直到最終使用者同意),並且您希望在為使用者重新啟用分析收集時控制個人化廣告功能,請確保指定此設定的呼叫先於您的呼叫。呼叫以重新啟用分析收集。例如:
迅速
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
確認您的設定
當透過上述定義的機制之一為使用者停用廣告個人化訊號時,從該使用者裝置記錄的後續事件捆綁包將包含名為non_personalized_ads
的使用者屬性,其值為1,以指示該捆綁包中的事件不可用於個人化廣告。停用個人化廣告不會影響將數據用於測量目的,包括報告和歸因。
查看您的配置更改
一旦您更改了 Google Analytics(分析)設置,SDK 就會下載更改。該過程快速且無縫,因此您可以快速測試您的變更。當您在 Analytics 中進行更改時,可能需要幾分鐘的時間才能在您的應用程式中部署。如果您的應用程式已上線,則完整的部署過程可能最多需要一小時才能完成。