Ghi nhật ký sự kiện

Chọn nền tảng: iOS+ Android Web Flutter Unity C++


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ư thao tác 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 lại nhật ký của một số sự kiện cho bạn và bạn không cần thêm mã nào để nhận những sự kiện này. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể ghi lại tối đa 500 Analytics Sự kiện loại khác nhau trong ứng dụng của mình. 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 lại. Xin lưu ý rằng tên sự kiện có phân biệt chữ hoa chữ thường. Khi bạn ghi nhật ký 2 sự kiện có tên giống nhau và chỉ khác ở cách viết hoa viết thường, hệ thống sẽ ghi nhận đó là 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 bài viết 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ể sử dụng thực thể đó để ghi nhật ký sự kiện bằng logEvent() phương thức.

Để 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ử, ứng dụng du lịch và ứng dụng 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ể tìm thấy 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:

Ví dụ sau đây minh hoạ cách ghi nhật ký 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")
}
MainActivity.kt

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);
MainActivity.java

Ngoài các tham số được quy định, bạn có thể thêm các tham số sau vào bất kỳ sự kiện nào:

  • Tham số tuỳ chỉnh: Bạn có thể sử dụng tham 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 tham số sự kiện không phải dạng số và chỉ số tuỳ chỉnh cho mọi dữ liệu tham số được biểu diễn bằng dạng số tốt hơn. Sau khi ghi nhật ký 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. Hãy 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 tham số tuỳ chỉnh trong định nghĩa đối tượng có thể áp dụng cho mọi báo cáo. Tham số tuỳ chỉnh cũng được đưa vào 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 Google Analytics 4 BigQuery Export.

  • VALUE tham số: 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ể mà một loại sự kiện được đề xuất không đáp ứng được, 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ụ sau:

Kotlin 

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}
MainActivity.kt

Java 

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
MainActivity.java

Đặt tham số sự kiện mặc định

Bạn có thể ghi nhật ký các tham số trên các sự kiện bằng cách sử dụng setDefaultEventParameters. Tham số mặc định được liên kết với tất cả các sự kiện trong tương lai được ghi nhật ký.

Giống như tham số tuỳ chỉnh, hãy đăng ký tham số sự kiện mặc định để đảm bảo các tham 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 một tham số được chỉ định trong phương thức logEvent(), thì giá trị đó sẽ được sử dụng thay vì 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 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 việc 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. Tính năng này bao gồm cả sự kiện được ghi nhật ký tự động và 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 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 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 Firebase trang tổng quan của bảng điều khiển. Các trang tổng quan này cập nhật định kỳ trong suốt cả ngày. Để kiểm thử ngay lập tức, 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 từ trang tổng quan Sự kiện trong bảng điều khiển Firebase. Trang tổng quan này hiển thị 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 nhật ký.