Hướng dẫn này cho bạn biết cách ghi lại các sự kiện trong ứng dụng của bạn.
Sự kiện cung cấp thông tin chi tiết về những gì đang diễn ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, các sự kiện của hệ thống hoặc các lỗi.
Analytics sẽ tự động ghi nhật ký một số sự kiện cho bạn; bạn không cần thêm mã nào để nhận các sự kiện đó. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi nhật ký tối đa 500 Analytics Loại sự kiện khác nhau trong ứng dụng. Không có giới hạn về tổng số lượng sự kiện mà ứng dụng của bạn ghi nhật ký. Xin lưu ý rằng tên sự kiện có phân biệt chữ hoa chữ thường và việc ghi nhật ký 2 sự kiện có tên chỉ khác nhau về cách viết hoa chữ thường sẽ dẫn đến 2 sự kiện riêng biệt.
Trước khi bắt đầu
Đảm bảo rằng bạn đã thiết lập dự án và có thể truy cập vào Analytics như mô tả trong phần Bắt đầu sử dụng Analytics.
Ghi nhật ký sự kiện
Sau khi tạo một thực thể FirebaseAnalytics
, bạn có thể dùng thực thể đó để ghi lại các sự kiện bằng phương thức logEvent()
.
Để giúp bạn bắt đầu, SDK Analytics xác định một số sự kiện được đề xuất thường gặp ở nhiều loại ứng dụng, bao gồm cả ứng dụng bán lẻ và thương mại điện tử, du lịch và trò chơi. Để tìm hiểu thêm về những sự kiện này và thời điểm sử dụng, hãy xem bài viết Sự kiện được đề xuất.
Bạn có thể xem thông tin chi tiết về cách triển khai cho các loại sự kiện được đề xuất ở những vị trí sau:
- Sự kiện được đề xuất: xem tài liệu tham khảo về lớp
com.google.firebase.analytics.FirebaseAnalytics.Event
. - Tham số được quy định: xem tài liệu tham khảo
com.google.firebase.analytics.FirebaseAnalytics.Param
.
Ví dụ sau đây minh hoạ cách ghi nhật ký một sự kiện 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);
Ngoài các thông số được quy định, bạn có thể thêm các thông số sau vào bất kỳ sự kiện nào:
Thông số tuỳ chỉnh: Bạn có thể sử dụng thông số tuỳ chỉnh làm phương diện hoặc chỉ số trong báo cáo Analytics. Bạn có thể sử dụng phương diện tuỳ chỉnh cho dữ liệu thông số sự kiện không phải dạng số và chỉ số tuỳ chỉnh cho mọi dữ liệu thông số được biểu thị bằng số hiệu quả hơn. Sau khi bạn ghi lại một tham số tuỳ chỉnh bằng SDK, hãy đăng ký phương diện hoặc chỉ số để đảm bảo các tham số tuỳ chỉnh đó xuất hiện trong báo cáo Analytics. Bạn có thể thực hiện việc này bằng cách sử dụng Analytics > Sự kiện > Quản lý định nghĩa tuỳ chỉnh > Tạo phương diện tuỳ chỉnh
Bạn có thể sử dụng thông số tuỳ chỉnh trong các định nghĩa đối tượng có thể được áp dụng cho mọi báo cáo. Các thông số tuỳ chỉnh cũng có trong dữ liệu được xuất sang BigQuery nếu ứng dụng của bạn được liên kết với một dự án BigQuery. Tìm các truy vấn mẫu và nhiều thông tin khác tại BigQuery Export của Google Analytics 4.
tham số
VALUE
:VALUE
là một tham số đa năng, hữu ích cho việc tích luỹ một chỉ số chính liên quan đến một sự kiện. Ví dụ: doanh thu, khoảng cách, thời gian và điểm.
Nếu ứng dụng của bạn có những nhu cầu cụ thể không thuộc loại sự kiện được đề xuất, thì bạn có thể ghi nhật ký các sự kiện tuỳ chỉnh của riêng mình như trong ví dụ này:
Kotlin
firebaseAnalytics.logEvent("share_image") { param("image_name", name) param("full_text", text) }
Java
Bundle params = new Bundle(); params.putString("image_name", name); params.putString("full_text", text); mFirebaseAnalytics.logEvent("share_image", params);
Đặt thông số sự kiện mặc định
Bạn có thể ghi lại các thông số trên nhiều sự kiện bằng cách sử dụng setDefaultEventParameters
.
Các thông số mặc định được liên kết với tất cả sự kiện trong tương lai được ghi lại.
Tương tự như thông số tuỳ chỉnh, hãy đăng ký thông số sự kiện mặc định để đảm bảo các thông số đó xuất hiện trong báo cáo Analytics.
Kotlin
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); parameters.putString("level_name", "Caverns01"); parameters.putInt("level_difficulty", 4); mFirebaseAnalytics.setDefaultEventParameters(parameters);
Nếu bạn chỉ định một tham số trong phương thức logEvent()
, thì giá trị đó sẽ được dùng thay cho giá trị mặc định.
Để xoá một tham số mặc định, hãy gọi phương thức setDefaultEventParameters
với tham số được đặt thành null
.
Xem các sự kiện trong nhật ký gỡ lỗi của Android Studio
Bạn có thể bật tính năng ghi nhật ký chi tiết để theo dõi hoạt động ghi nhật ký sự kiện của SDK nhằm giúp xác minh rằng các sự kiện đang được ghi nhật ký đúng cách. Điều này bao gồm cả sự kiện được ghi lại tự động và theo cách thủ công.
Bạn có thể bật tính năng ghi nhật ký chi tiết bằng một loạt lệnh adb:
adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC
Lệnh này sẽ hiển thị các sự kiện của bạn trong logcat của Android Studio, giúp bạn xác minh ngay rằng các sự kiện đang được gửi.
Xem các sự kiện trong trang tổng quan
Bạn có thể xem số liệu thống kê tổng hợp về các sự kiện của mình trong trang tổng quan của bảng điều khiển Firebase. Các trang tổng quan này được cập nhật định kỳ trong ngày. Để kiểm thử ngay, hãy sử dụng đầu ra logcat như mô tả trong phần trước.
Bạn có thể truy cập vào dữ liệu này trên trang tổng quan Sự kiện trong bảng điều khiển Firebase. Trang tổng quan này cho thấy các báo cáo sự kiện được tạo tự động cho từng loại sự kiện riêng biệt mà ứng dụng của bạn ghi lại.