本頁面說明 Google Analytics 提供的功能,可讓您控管 Analytics 資料的收集和使用方式。
停用Analytics資料收集功能
在某些情況下,您可能需要暫時或永久停用 Analytics 資料的收集作業,例如收集使用者同意聲明或履行法律義務。Google Analytics 提供多種選項,可停用及取消啟用Analytics產品素材資源集合。兩者搭配使用可支援許多常見用途。
暫時停用集合
如要暫時停用 Analytics 收集功能 (例如在收集資料前取得使用者同意聲明),您可以在應用程式的 AndroidManifest.xml 中,將 application 代碼的 firebase_analytics_collection_enabled 值設為 false。例如:
<meta-data android:name="firebase_analytics_collection_enabled" android:value="false" />
如要重新啟用收集作業 (例如在使用者提供同意聲明後),請呼叫 類別的 setAnalyticsCollectionEnabled() 方法。FirebaseAnalytics例如:
Kotlin
setAnalyticsCollectionEnabled(true);
Java
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
如果因故需要再次暫停收集資料,可以呼叫下列項目,系統會暫停收集資料,直到您重新啟用為止。
Kotlin
setAnalyticsCollectionEnabled(false);
Java
setAnalyticsCollectionEnabled(false);
Unity
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(false);
永久停用收藏內容
如要在應用程式版本中永久停用 Analytics 收集功能,請在 application 標記中,將應用程式 AndroidManifest.xml 的 firebase_analytics_collection_deactivated 設為 true。例如:
<meta-data android:name="firebase_analytics_collection_deactivated" android:value="true" />
停用廣告 ID 收集功能
如要停用 Android 應用程式中的廣告 ID收集作業,請在 application 標記的應用程式 AndroidManifest.xml 中,將 google_analytics_adid_collection_enabled 的值設為 false。例如:
<meta-data android:name="google_analytics_adid_collection_enabled" android:value="false" />
控管個人化廣告的資料收集作業
如果您已將Google Analytics專案連結至廣告帳戶、啟用廣告整合功能,或選擇分享資料,Analytics 資料可能符合用於個人化廣告的資格。舉例來說,除非您指明這類資料不得用於個人化廣告,否則您可以運用收集到的事件 (例如 first_open) 建立及放送再行銷目標對象名單。
您可以透過下列任一選項,以程式輔助方式控管是否要將使用者的 Analytics 資料用於個人化廣告:
建議:根據使用者的同意聲明選項,動態啟用或停用廣告個人化功能。導入 Google 的同意聲明模式 API。
在使用者層級啟用或停用廣告個人化: 將廣告個人化設定視為使用者屬性進行控管。
在 Analytics 資源層級啟用或停用廣告個人化功能: 在 Analytics 資源中,針對特定地理區域停用廣告個人化功能。
透過使用者屬性停用個人化廣告功能
Google 同意聲明模式 API 是啟用及停用個人化廣告的建議方式。不過,如果您的應用程式尚未採用同意聲明模式,可以透過下列選項控管個人化功能。
如要預設停用個人化廣告行為,請在應用程式的 AndroidManifest.xml 中,於 application 標記中指定下列欄位:
<meta-data android:name="google_analytics_default_allow_ad_personalization_signals" android:value="false" />
透過使用者屬性重新啟用個人化廣告功能
如果您使用 google_analytics_default_allow_ad_personalization_signals 參數控管廣告個人化設定,可以透過 setUserProperty 方法重新啟用廣告個人化設定,如下所示:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, "true" );
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, true);
如果您選擇暫時停用 Analytics 收集功能 (例如,等到使用者提供同意聲明為止),並想在為使用者重新啟用 Analytics 收集功能時,控管廣告個人化功能,請務必先呼叫函式來指定這項設定,再呼叫函式重新啟用 Analytics 收集功能。例如:
Kotlin
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Java
setUserProperty( ALLOW_AD_PERSONALIZATION_SIGNALS, … );
setAnalyticsCollectionEnabled(true);
Unity
Firebase.Analytics.FirebaseAnalytics.SetUserProperty(FirebaseAnalytics.UserPropertyAllowAdPersonalizationSignals, ...);
Firebase.Analytics.FirebaseAnalytics.SetAnalyticsCollectionEnabled(true);
確認設定
如果透過上述任一機制為使用者停用廣告個人化信號,後續從該使用者裝置記錄的事件組合會包含名為 non_personalized_ads 的使用者屬性,值為 1,表示該組合中的事件無法用於放送個人化廣告。停用個人化廣告不會影響資料的成效評估用途,包括報表和歸因。
查看設定變更
變更 Google Analytics 設定後,SDK 會下載變更。這個程序快速又流暢,因此您可以快速測試變更。在 Analytics 中進行變更後,可能需要幾分鐘才能部署到應用程式。如果應用程式已上線,完整的部署程序可能需要一小時才能完成。