配置 Analytics 資料收集和使用

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實例方法。例如：

迅速

注意：此 Firebase 產品在 macOS 目標上不可用。
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意：此 Firebase 產品在 macOS 目標上不可用。
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

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

迅速

注意：此 Firebase 產品在 macOS 目標上不可用。
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 收集

如果您透過 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 （布林值）。

控制個人化廣告的資料收集

如果您已將 Google Analytics（分析）項目連結到廣告帳戶或以其他方式啟用了廣告集成，或選擇了資料共享，則您的 Analytics（分析）資料可能有資格用於個人化廣告。例如，這表示您可以使用收集的事件（例如first_open來建立和部署受眾群體清單以進行再行銷，除非您表明此類資料無法用於個人化廣告。

您可以使用以下任一選項以程式方式控制是否應將使用者的 Analytics 資料用於個人化廣告：

透過使用者屬性停用個人化廣告功能

Google 的同意模式 API是啟用和停用個人化廣告的建議方法。

但是，如果您的應用程式尚未使用同意模式，您可以使用以下選項控制個人化。

若要預設停用個人化廣告行為，請在套用的Info.plist檔案中將GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS的值設為NO （布林值）。

透過使用者屬性重新啟用個人化廣告功能

如果您使用AnalyticsUserPropertyAllowAdPersonalizationSignals參數來控制廣告個人化，您可以使用setUserProperty方式重新啟用廣告個人化，如下所示：

迅速

注意：此 Firebase 產品在 macOS 目標上不可用。
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

注意：此 Firebase 產品在 macOS 目標上不可用。
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

如果您選擇暫時停用分析收集（例如，直到最終使用者同意），並且您希望在為使用者重新啟用分析收集時控制個人化廣告功能，請確保指定此設定的呼叫先於您的呼叫。呼叫以重新啟用分析收集。例如：

迅速

注意：此 Firebase 產品在 macOS 目標上不可用。
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意：此 Firebase 產品在 macOS 目標上不可用。
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

確認您的設定

當透過上述定義的機制之一為使用者停用廣告個人化訊號時，從該使用者裝置記錄的後續事件捆綁包將包含名為non_personalized_ads的使用者屬性，其值為1，以指示該捆綁包中的事件不可用於個人化廣告。停用個人化廣告不會影響將數據用於測量目的，包括報告和歸因。

查看您的配置更改

一旦您更改了 Google Analytics（分析）設置，SDK 就會下載更改。該過程快速且無縫，因此您可以快速測試您的變更。當您在 Analytics 中進行更改時，可能需要幾分鐘的時間才能在您的應用程式中部署。如果您的應用程式已上線，則完整的部署過程可能最多需要一小時才能完成。