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ư 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.

Google Analytics sẽ tự động ghi lại 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 lại tối đa 500 loại sự kiện Analytics 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 và việc ghi lại 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

Trước khi có thể sử dụng Google Analytics, bạn cần:

  • Đăng ký dự án Unity và định cấu hình dự án đó để sử dụng Firebase.

    • Nếu dự án Unity của bạn đã sử dụng Firebase, thì dự án đó đã được đăng ký và định cấu hình cho Firebase.

    • Nếu không có dự án Unity, bạn có thể tải xuống ứng dụng mẫu.

  • Thêm Firebase Unity SDK (cụ thể là FirebaseAnalytics.unitypackage) vào dự án Unity.

Xin lưu ý rằng việc thêm Firebase vào dự án Unity bao gồm cả các bước trong bảng điều khiển của Firebase và trong dự án Unity đang mở (ví dụ: bạn tải tệp cấu hình Firebase xuống từ bảng điều khiển, sau đó di chuyển các tệp đó vào dự án Unity).Firebase

Ghi nhật ký sự kiện

Sau khi khởi chạy mô-đun Firebase.Analytics.FirebaseAnalytics, bạn có thể dùng mô-đun đó để 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 trong 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ề các sự kiện này và thời điểm sử dụng các sự kiện đó, hãy xem bài viết Sự kiện được đề xuất trong Trung tâm trợ giúp của Google Analytics.

Bạn có thể tìm thấy thông tin chi tiết về cách triển khai các sự kiện được đề xuất ở những vị trí sau:

  • Sự kiện được đề xuất: xem danh sách Event hằng số.
  • Thông số quy định: xem danh sách Parameters hằng số.

Ví dụ sau đây minh hoạ cách ghi lại một Sự kiện được đề xuất SELECT_CONTENT:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

Ngoài các thông số 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: Thông số tuỳ chỉnh không được trình bày trực tiếp trong báo cáo Analytics Analytics, nhưng có thể được dùng làm bộ lọc trong định nghĩa Đối tượng có thể áp dụng cho mọi báo cáo. Thông số tuỳ chỉnh cũng được đưa vào dữ liệu 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.

  • Thông số VALUE: VALUE là một thông số đa năng hữu ích cho việc tích luỹ một chỉ số chính liên quan đến Analytics 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à loại Analytics Sự kiện được đề xuất không đáp ứng được, thì bạn có thể ghi lại các Sự kiện tuỳ chỉnh của riêng mình Analytics như trong ví dụ này:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Xem sự kiện trong đầu ra của nhật ký

iOS+

Các sự kiện được ghi lại vào bảng điều khiển và có thể xem được khi chạy ứng dụng thông qua XCode.

Android

Bạn có thể bật tính năng ghi nhật ký chi tiết trong Nhật ký gỡ lỗi của Android Studio để giúp xác minh rằng SDK đang ghi nhật ký sự kiện đúng cách. Điều này bao gồm cả các sự kiện được ghi lại 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 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 sự kiện phân tích trong trang tổng quan

Trong bảng điều khiển của Firebase, bạn có thể xem số liệu thống kê tổng hợp về các sự kiện trong trang tổng quan Analytics > Sự kiện.

Xin lưu ý những điều sau về trang tổng quan này:

  • 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.

  • Trang tổng quan này được cập nhật định kỳ trong suốt cả ngày. Để kiểm thử ngay, hãy sử dụng bảng điều khiển gỡ lỗi Xcode hoặc đầu ra logcat như mô tả trong phần trước của hướng dẫn này.

Đọc thêm về trang tổng quan.