設定 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 執行個體方法。例如：

Swift

注意：這項 Firebase 產品不適用於 macOS 目標。
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意：這項 Firebase 產品不適用於 macOS 目標。
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

如果出於任何原因而需要再次暫停收集，您可以呼叫下列項目，並暫停收集功能，直到您重新啟用該功能為止。

Swift

注意：這項 Firebase 產品不適用於 macOS 目標。
Analytics.setAnalyticsCollectionEnabled(false)

Objective-C

[FIRAnalytics setAnalyticsCollectionEnabled:NO];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);

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 時，出現相同的行為。

停用廣告識別碼收集功能

如果您使用 CocoaPods 透過 CocoaPods 安裝 Firebase，方法是將 pod 'Firebase/Analytics' 新增至應用程式的 Podfile，並希望停止在 Apple 應用程式中收集 IDFA (裝置的廣告 ID)，請確認應用程式不含 AdSupport 架構。

如要在不使用任何廣告識別碼收集功能的情況下安裝 Firebase，請使用下列子規格取代 pod 'Firebase/Analytics'：

pod 'Firebase/AnalyticsWithoutAdIdSupport'

若想進一步瞭解廣告識別碼，請參閱 Apple 說明文件：

停用 IDFV 收集功能

如要停止在 Apple 應用程式中收集 IDFV (供應商 ID)，請在應用程式的 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 方法重新啟用廣告個人化，如下所示：

Swift

注意：這項 Firebase 產品不適用於 macOS 目標。
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

注意：這項 Firebase 產品不適用於 macOS 目標。
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);

如果您先前選擇暫時停用分析收集功能 (例如，直到使用者提供同意聲明為止)，且希望在為使用者重新啟用數據分析資料收集功能時控制個人化廣告功能，請務必在呼叫重新啟用 Analytics (分析) 的呼叫之前指定這項設定。例如：

Swift

注意：這項 Firebase 產品不適用於 macOS 目標。
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意：這項 Firebase 產品不適用於 macOS 目標。
[FIRAnalytics setUserPropertyString:... forName:kFIRUserPropertyAllowAdPersonalizationSignals];
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

確認設定

當您透過上述其中一種機制停用使用者的廣告個人化信號時，從該使用者裝置記錄的後續事件組合會包含名為 non_personalized_ads 的使用者屬性 (值為 1)，表示該組合中的事件無法用於個人化廣告。停用個人化廣告不會影響資料用於評估，包括報表和歸因。

查看設定變更

變更 Google Analytics (分析) 設定後，SDK 會下載變更。此程序快速流暢，因此您可以快速測試變更。在 Analytics (分析) 中進行變更後，可能需要幾分鐘的時間在應用程式中部署。如果您的應用程式已上線，完整的部署程序最多需要一個小時才能完成。