Ghi nhật ký sự kiện

Hướng dẫn này chỉ cho bạn cách đăng nhập 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 xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, sự kiện hệ thống hoặc lỗi.

Analytics tự động ghi lại một số sự kiện cho bạn; bạn không cần thêm bất kỳ mã nào để nhận chúng. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể đăng nhập tối đa 500 loại Sự kiện Analytics khác nhau trong ứng dụng của mình. Không có giới hạn về tổng khối lượng sự kiện mà ứng dụng của bạn ghi lại. Lưu ý rằng tên sự kiện phân biệt chữ hoa chữ thường và việc ghi nhật ký hai sự kiện có tên chỉ khác nhau trong trường hợp sẽ dẫn đến hai 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 của mình và có thể truy cập vào Analytics như được mô tả trong Bắt đầu với Analytics .

Ghi nhật ký sự kiện

Sau khi bạn đã tạo một phiên bản FirebaseAnalytics , bạn có thể sử dụng nó để 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 phổ biến giữa các loại ứng dụng khác nhau, bao gồm ứ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à khi nào sử dụng chúng, hãy xem Sự kiện được đề xuất .

Bạn có thể tìm thấy chi tiết triển khai cho các loại sự kiện được đề xuất ở các vị trí sau:

Ví dụ sau minh họa cách ghi lại sự kiện a SELECT_CONTENT :

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);

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")
}

Ngoài các thông số được chỉ đị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ố tùy chỉnh: Thông số tùy chỉnh có thể được sử dụng làm thứ nguyên hoặc chỉ số trong báo cáo Analytics . Bạn có thể sử dụng thứ nguyên tùy chỉnh cho dữ liệu thông số sự kiện không phải số và chỉ số tùy chỉnh cho bất kỳ dữ liệu thông số nào được trình bày bằng số tốt hơn. Khi bạn đã ghi nhật ký thông số tùy chỉnh bằng SDK, hãy đăng ký thứ nguyên hoặc chỉ số để đảm bảo các thông số tùy chỉnh đó xuất hiện trong báo cáo Analytics. Thực hiện việc này qua: Analytics> Sự kiện> Quản lý định nghĩa tùy chỉnh> Tạo thứ nguyên tùy chỉnh

    Thông số tùy chỉnh có thể được sử dụng trong định nghĩa đối tượng có thể được áp dụng cho mọi báo cáo. Thông số tùy chỉnh cũng được bao gồm 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à hơn thế nữa tại Google Analytics 4 BigQuery Export .

  • Thông số VALUE : VALUE là thông số mục đích chung hữu ích để tích lũy chỉ số chính liên quan đến sự kiện. Ví dụ bao gồm doanh thu, khoảng cách, thời gian và điểm.

Nếu ứng dụng của bạn có các nhu cầu cụ thể không thuộc loại sự kiện được đề xuất, bạn có thể ghi nhật ký các sự kiện tùy chỉnh của riêng mình như được minh họa trong ví dụ sau:

Java

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

Kotlin+KTX

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

Đặt thông số sự kiện mặc định

Bạn có thể ghi nhật ký các tham số qua các sự kiện bằng setDefaultEventParameters . Các 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 lại.

Giống như với các thông số tùy chỉnh, hãy đăng ký các thông số sự kiện mặc định để đảm bảo chúng xuất hiện trong báo cáo Analytics.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Nếu một tham số được chỉ định trong phương thức logEvent() , thì giá trị đó được sử dụng thay vì giá trị mặc định.

Để xóa 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 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ý các sự kiện bằng SDK để giúp xác minh rằng các sự kiện đang được ghi đúng cách. Điều này bao gồm cả các sự kiện được ghi tự động và thủ công.

Bạn có thể bật 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 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 thống kê tổng hợp về các sự kiện của mình trong trang tổng quan bảng điều khiển Firebase. Các trang tổng quan này cập nhật định kỳ trong ngày. Để kiểm tra ngay lập tức, hãy sử dụng đầu ra logcat như được mô tả trong phần trước.

Bạn có thể truy cập 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 được ứng dụng của bạn ghi lại.

,

Hướng dẫn này chỉ cho bạn cách đăng nhập 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 xảy ra trong ứng dụng của bạn, chẳng hạn như hành động của người dùng, sự kiện hệ thống hoặc lỗi.

Analytics tự động ghi lại một số sự kiện cho bạn; bạn không cần thêm bất kỳ mã nào để nhận chúng. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, bạn có thể đăng nhập tối đa 500 loại Sự kiện Analytics khác nhau trong ứng dụng của mình. Không có giới hạn về tổng khối lượng sự kiện mà ứng dụng của bạn ghi lại. Lưu ý rằng tên sự kiện phân biệt chữ hoa chữ thường và việc ghi nhật ký hai sự kiện có tên chỉ khác nhau trong trường hợp sẽ dẫn đến hai 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 của mình và có thể truy cập vào Analytics như được mô tả trong Bắt đầu với Analytics .

Ghi nhật ký sự kiện

Sau khi bạn đã tạo một phiên bản FirebaseAnalytics , bạn có thể sử dụng nó để 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 phổ biến giữa các loại ứng dụng khác nhau, bao gồm ứ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à khi nào sử dụng chúng, hãy xem Sự kiện được đề xuất .

Bạn có thể tìm thấy chi tiết triển khai cho các loại sự kiện được đề xuất ở các vị trí sau:

Ví dụ sau minh họa cách ghi lại sự kiện a SELECT_CONTENT :

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);

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")
}

Ngoài các thông số được chỉ đị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ố tùy chỉnh: Thông số tùy chỉnh có thể được sử dụng làm thứ nguyên hoặc chỉ số trong báo cáo Analytics . Bạn có thể sử dụng thứ nguyên tùy chỉnh cho dữ liệu thông số sự kiện không phải số và chỉ số tùy chỉnh cho bất kỳ dữ liệu thông số nào được trình bày bằng số tốt hơn. Khi bạn đã ghi nhật ký thông số tùy chỉnh bằng SDK, hãy đăng ký thứ nguyên hoặc chỉ số để đảm bảo các thông số tùy chỉnh đó xuất hiện trong báo cáo Analytics. Thực hiện việc này qua: Analytics> Sự kiện> Quản lý định nghĩa tùy chỉnh> Tạo thứ nguyên tùy chỉnh

    Thông số tùy chỉnh có thể được sử dụng trong định nghĩa đối tượng có thể được áp dụng cho mọi báo cáo. Thông số tùy chỉnh cũng được bao gồm 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à hơn thế nữa tại Google Analytics 4 BigQuery Export .

  • Thông số VALUE : VALUE là thông số mục đích chung hữu ích để tích lũy chỉ số chính liên quan đến sự kiện. Ví dụ bao gồm doanh thu, khoảng cách, thời gian và điểm.

Nếu ứng dụng của bạn có các nhu cầu cụ thể không thuộc loại sự kiện được đề xuất, bạn có thể ghi nhật ký các sự kiện tùy chỉnh của riêng mình như được minh họa trong ví dụ sau:

Java

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

Kotlin+KTX

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

Đặt thông số sự kiện mặc định

Bạn có thể ghi nhật ký các tham số qua các sự kiện bằng setDefaultEventParameters . Các 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 lại.

Giống như với các thông số tùy chỉnh, hãy đăng ký các thông số sự kiện mặc định để đảm bảo chúng xuất hiện trong báo cáo Analytics.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Nếu một tham số được chỉ định trong phương thức logEvent() , thì giá trị đó được sử dụng thay vì giá trị mặc định.

Để xóa 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 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ý các sự kiện bằng SDK để giúp xác minh rằng các sự kiện đang được ghi đúng cách. Điều này bao gồm cả các sự kiện được ghi tự động và thủ công.

Bạn có thể bật 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 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 thống kê tổng hợp về các sự kiện của mình trong trang tổng quan bảng điều khiển Firebase. Các trang tổng quan này cập nhật định kỳ trong ngày. Để kiểm tra ngay lập tức, hãy sử dụng đầu ra logcat như được mô tả trong phần trước.

Bạn có thể truy cập 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 được ứng dụng của bạn ghi lại.