本頁說明 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
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[FIRAnalytics setAnalyticsCollectionEnabled:YES];
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
如果因任何原因而需要再次暫停資料收集功能,您可以呼叫 追蹤以及最愛,直到您重新啟用為止。
Swift
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 資料收集功能
應用程式,在您的應用程式中將 FIREBASE_ANALYTICS_COLLECTION_DEACTIVATED
設為 YES
(布林值)
應用程式的 Info.plist
檔案。將 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 安裝 Firebase,並在應用程式的 Podfile 中加入 pod 'Firebase/Analytics'
,且希望停用 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。
在使用者層級啟用或停用廣告個人化功能: 以使用者屬性的形式控管廣告個人化:
在 Analytics 資源層級啟用或停用廣告個人化功能: 在 Analytics 資源中,根據地理區域停用廣告個人化功能。
透過使用者屬性停用個人化廣告功能
Google 同意聲明模式 API 是建議啟用及停用個人化廣告的做法。不過,如果您的應用程式尚未使用同意模式,您可以使用下列選項控管個人化功能。
如要預設為停用個人化廣告行為,請將
GOOGLE_ANALYTICS_DEFAULT_ALLOW_AD_PERSONALIZATION_SIGNALS
到 NO
(布林值)
在應用程式的 Info.plist
檔案中。
透過使用者屬性重新啟用個人化廣告功能
如果您使用 AnalyticsUserPropertyAllowAdPersonalizationSignals
參數來控制廣告個人化功能,可以使用 setUserProperty
方法重新啟用廣告個人化功能,如下所示:
Swift
Analytics.setUserProperty("true", forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Objective-C
[FIRAnalytics setUserPropertyString:@"YES" forName:kFIRUserPropertyAllowAdPersonalizationSignals];
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
如果您選擇暫時停用數據分析資料收集 (例如,在使用者提供同意聲明之前),並且想在重新啟用使用者數據分析資料收集時控制個人化廣告功能,請務必先呼叫指定這項設定,再呼叫重新啟用數據分析資料收集。例如:
Swift
Analytics.setUserProperty(..., forName: AnalyticsUserPropertyAllowAdPersonalizationSignals)
Analytics.setAnalyticsCollectionEnabled(true)
Objective-C
[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 中進行變更時,可能需要幾分鐘才能部署至應用程式。如果應用程式已上線,完整部署程序可能需要最多一小時才能完成。