設定 Analytics (分析) 資料收集和使用設定

選取平台： iOS+ Android


本頁面說明 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 產品不適用於 watchOS 目標。 
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

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

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

如果因任何原因需要再次暫停收集，可以呼叫下列項目，系統就會暫停收集，直到您重新啟用為止。

Swift

注意：這項 Firebase 產品不適用於 watchOS 目標。 
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 相同。

停用廣告識別碼收集功能

如果您透過 SPM 或 CocoaPods 在應用程式中安裝 FirebaseAnalytics 模組，並想在 Apple 應用程式中停用廣告識別碼 (裝置的廣告 ID) 收集功能，請確認應用程式未納入 AdSupport 架構。

如要安裝 Firebase，但不啟用任何廣告識別碼收集功能，請使用下列指令，而非 FirebaseAnalytics 依附元件：

Swift Package Manager

  .target(
    name: "MyTargetName",
    dependencies: [
      .product(name: "FirebaseAnalyticsCore", package: "Firebase"),
      // ...
    ]
  ),

CocoaPods

pod 'FirebaseAnalytics/Core'

如要進一步瞭解廣告識別碼，請參閱 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 產品不適用於 watchOS 目標。 
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

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

Unity

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

如果您選擇暫時停用數據分析資料收集功能 (例如等到使用者提供同意聲明)，並想在重新啟用使用者的數據分析資料收集功能時，控管個人化廣告功能，請務必先呼叫指定這項設定，再呼叫重新啟用數據分析資料收集功能。例如：

Swift

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

Objective-C

注意：這項 Firebase 產品不適用於 watchOS 目標。 
[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中進行變更後，可能需要幾分鐘才能部署到應用程式。如果應用程式已上線，整個部署程序最多可能需要一小時才能完成。