Ghi nhật ký sự kiệ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.

Google 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 dữ liệu bổ sung, bạn có thể ghi lại 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 về chữ hoa chữ thường sẽ dẫn đến hai sự kiện riêng biệt.

Trước khi bắt đầu

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

• Đăng ký dự án Unity của bạn và định cấu hình để 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 chưa có dự án Unity, bạn có thể tải xuống ứng dụng mẫu .

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

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

Nhật ký sự kiện

Sau khi khởi tạo mô-đun Firebase.Analytics.FirebaseAnalytics , bạn có thể sử dụng mô-đun này để ghi nhật ký 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à thời điểm sử dụng chúng, hãy duyệt qua các bài viết về Sự kiện và thuộc tính trong Trung tâm trợ giúp Firebase.

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:

• Sự kiện gợi ý: xem danh sách Hằng số Event .
• Tham số quy định: xem danh sách Parameters hằng số.

Ví dụ sau minh họa cách ghi nhật ký Sự kiện SELECT_CONTENT được đề xuất:

    // 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ố tùy chỉnh: Thông số tùy chỉnh không được trình bày trực tiếp trong báo cáo Analytics của bạn, nhưng chúng có thể được sử 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. Các 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.

• Thông số VALUE : VALUE là thông số có mục đích chung hữu ích để tích lũy chỉ số chính liên quan đến Sự kiện Analytics. 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 có trong loại Sự kiện Analytics được đề xuất, thì bạn có thể ghi nhật ký Sự kiện Analytics tùy chỉnh của riêng mình như minh họa trong ví dụ sau:

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

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

adb shell setprop log.tag.FA VERBOSE

adb shell setprop log.tag.FA-SVC VERBOSE

adb logcat -v time -s FA FA-SVC

Xem các sự kiện phân tích trong bảng điều khiển

Bạn có thể xem số liệu thống kê tổng hợp về Sự kiện Analytics của mình trong bảng điều khiển của 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.

Để truy cập dữ liệu này trong bảng điều khiển Firebase:

1. Trong bảng điều khiển Firebase , hãy mở dự án của bạn.
2. Chọn Analytics từ trình đơn để xem trang tổng quan báo cáo Analytics.

Tab Sự kiện 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 Analytics riêng biệt được ứng dụng của bạn ghi lại. Đọc thêm về trang tổng quan báo cáo Analytics trong Trung tâm trợ giúp Firebase.