本快速入門導覽課程說明如何將 Google Analytics 新增至應用程式, 開始記錄事件。
「Google Analytics」會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要類型的資訊:
- 事件:應用程式運作情況,例如使用者動作、系統 事件或錯誤
- 使用者屬性:您定義的屬性,用來描述區隔 例如語言偏好設定或地理位置
Analytics 會自動記錄部分活動記錄 事件和 使用者屬性; 不需要新增任何程式碼
事前準備
如果您尚未將 Firebase 新增至 Android,請先完成這項操作。 專案,並確認 Google Analytics 已在 Firebase 專案中啟用:
如要建立新的 Firebase 專案,請啟用「Google Analytics」 專案建立流程
如果您使用的現有 Firebase 專案沒有 Google Analytics已啟用,請前往 整合項目 (
即可啟用)。 > 的分頁) (前往專案設定
在專案中啟用「Google Analytics」後,Firebase 應用程式會恢復為 已連結 Google Analytics 個資料串流。
在應用程式中新增 Analytics SDK
在模組 (應用程式層級) Gradle 檔案中 (通常為
<project>/<app-module>/build.gradle.kts
或<project>/<app-module>/build.gradle
)、 新增 Android Analytics 程式庫的依附元件。建議您使用 Firebase Android BoM敬上 管理程式庫版本管理dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.1.2")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
只要使用 Firebase Android BoM, 應用程式一律會使用相容的 Firebase Android 程式庫版本。
(替代做法) 新增 Firebase 程式庫依附元件,「不使用」 BoM
如果選擇不使用 Firebase BoM,請指定各個 Firebase 程式庫版本 都屬於依附元件行
請注意,如果您在應用程式中使用多個 Firebase 程式庫,強烈建議您 建議使用 BoM 管理程式庫版本,確保所有版本 相容。
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:22.0.2") }
請在
com.google.firebase.analytics.FirebaseAnalytics
你從事的活動高低:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
請在
onCreate()
方法中初始化這個變數:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
開始記錄事件
建立 FirebaseAnalytics
執行個體後,您就可以開始記錄
透過 logEvent()
方法建立事件。
有些事件是 建議用於所有應用程式; 有些則適合特定業務類型或產業使用。您應該傳送 建議事件及其相關的指定參數,以確保 方便您使用日後推出的功能 整合。本節說明如何將 預先定義的事件,如要進一步瞭解記錄事件,請參閱 記錄事件。
在下列情況中,下列程式碼會記錄 SELECT_CONTENT
事件
使用者點選應用程式中特定元素的次數。
Kotlin+KTX
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) { param(FirebaseAnalytics.Param.ITEM_ID, id) param(FirebaseAnalytics.Param.ITEM_NAME, name) param(FirebaseAnalytics.Param.CONTENT_TYPE, "image") }
Java
Bundle bundle = new Bundle(); bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id); bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name); bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image"); mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
您可以啟用詳細記錄功能來監控 SDK 的事件記錄, 確認事件記錄是否正確。這包括 以及手動記錄的事件
您可以使用一系列 adb
指令啟用詳細記錄功能:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
這個指令會在 Android Studio Logcat 中顯示事件,協助您 立即確認事件是否正在傳送。
後續步驟
- 解讀每份 Analytics 報表。
- 使用 DebugView 驗證事件。
- 在 Firebase 控制台探索您的資料。
- 瀏覽活動指南,和 使用者屬性。
- 瞭解如何將資料匯出至 BigQuery。