設定 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/>

如要重新啟用收集作業 (例如在使用者提供同意聲明後),請呼叫 AnalyticssetAnalyticsCollectionEnabled 執行個體方法。例如:

Swift

注意:macOS 目標不支援這項 Firebase 產品。
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意:macOS 目標不支援這項 Firebase 產品。
[FIRAnalytics setAnalyticsCollectionEnabled:YES];

Unity

Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);

如果因故需要再次暫停收款,可以撥打下列電話,收款功能就會暫停,直到你重新啟用為止。

Swift

注意:macOS 目標不支援這項 Firebase 產品。
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_DEACTIVATEDYES (布林值) 的優先順序,高於應用程式 Info.plistFIREBASE_ANALYTICS_COLLECTION_ENABLED 的任何值,以及使用 setAnalyticsCollectionEnabled 設定的任何值。

如要重新啟用收藏功能,請從Info.plist中移除 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED。將 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 設為 NO (布林值) 不會產生任何影響,且會導致與未在 Info.plist 檔案中設定 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED 相同的行為。

停用 IDFA 收集功能

如果您透過 CocoaPods 安裝 Firebase,方法是在應用程式的 Podfile 中加入 pod 'FirebaseAnalytics',並想在 Apple 應用程式中停用 IDFA (裝置的廣告 ID) 收集功能,請確保應用程式未包含 AdSupport 架構。

如要安裝 Firebase,但不具備任何廣告識別碼收集功能,請使用下列子規格取代 pod 'FirebaseAnalytics'

pod 'FirebaseAnalytics/Core'

如要進一步瞭解廣告識別碼,請參閱 Apple 說明文件:

停用 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 方法重新啟用廣告個人化,如下所示:

Swift

注意:macOS 目標不支援這項 Firebase 產品。
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)

Objective-C

注意:macOS 目標不支援這項 Firebase 產品。
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];

Unity

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

如果您選擇暫時停用 Analytics 收集功能 (例如,等到使用者提供同意聲明後再啟用),並想在為使用者重新啟用 Analytics 收集功能時控管廣告個人化功能,請務必先呼叫函式來指定這項設定,再呼叫函式重新啟用 Analytics 收集功能。例如:

Swift

注意:macOS 目標不支援這項 Firebase 產品。
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)

Objective-C

注意:macOS 目標不支援這項 Firebase 產品。
[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 中進行變更後,可能需要幾分鐘才能部署到應用程式。如果應用程式已上線,完整的部署程序可能需要一小時才能完成。