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

注意:這項 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 安裝 Firebase,只要在應用程式的 Podfile 中加入 pod 'Firebase/Analytics',並希望在 Apple 應用程式中停用廣告識別碼 (裝置的廣告 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);

如果您選擇暫時停用分析資料收集功能 (例如,在使用者提供同意聲明後才停用),且希望在使用者重新啟用數據分析收集功能時,想要控管個人化廣告功能,請務必在呼叫重新啟用數據分析收集作業前,先指定這項設定。例如:

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 (分析) 中進行變更時,部署應用程式可能需要幾分鐘的時間才能完成。如果您的應用程式已上線,整個部署程序最多可能要一小時才能完成。