本快速入門導覽課程說明如何在應用程式中新增 Google Analytics,並開始記錄事件。
Google Analytics 會收集應用程式的使用情況和行為資料。SDK 會記錄兩種主要資訊:
- 事件:應用程式的動態 (例如使用者動作、系統事件或錯誤)。
- 使用者屬性:您定義的屬性,用來描述使用者族群區隔,例如語言偏好設定或地理位置。
Analytics會自動記錄部分事件和使用者屬性,您不必新增任何程式碼即可啟用這些屬性。
事前準備
如果您尚未將 Firebase 新增至 Android 專案,請先新增,並確認 Firebase 專案已啟用 Google Analytics:
如果您要建立新的 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.16.0")) // 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 程式庫版本。
(替代做法) 不使用 BoM 新增 Firebase 程式庫依附元件
如果選擇不使用 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.5.0") }
在活動最上方宣告
com.google.firebase.analytics.FirebaseAnalytics
物件:Kotlin
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
在
onCreate()
方法中初始化:Kotlin
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
開始記錄事件
建立 FirebaseAnalytics
執行個體後,即可開始使用 logEvent()
方法記錄事件。
某些事件建議所有應用程式採用,其他事件則建議特定類型的商家或產業採用。建議您傳送包含規定參數的建議事件,這樣報表就能呈現最詳盡的資料,也方便您日後使用新推出的功能和整合服務。本節將示範如何記錄預先定義的事件。如要進一步瞭解如何記錄事件,請參閱「記錄事件」。
下方程式碼會在使用者點選應用程式中的特定元素時,記錄 SELECT_CONTENT
事件。
Kotlin
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。