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