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

Google Analytics sẽ tự động ghi lại nhật ký của 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à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 nhật ký tối đa 500 loại sự kiện Analytics 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. Khi bạn ghi nhận 2 sự kiện có tên chỉ khác nhau về cách viết hoa, hệ thống sẽ ghi nhận đó là 2 sự kiện riêng biệt.

Trước khi bắt đầu

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

  • Đă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 chưa có dự án Unity, bạn có thể tải ứng dụng mẫu xuống.

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

Xin lưu ý rằng việc thêm Firebase vào dự án Unity của bạn bao gồm các thao tác 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 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).

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 này để 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ề các 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 trong Trung tâm trợ giúp của Google Analytics.

Bạn có thể xem 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 hằng số Event.
  • Các tham số được chỉ định: xem danh sách hằng số Parameters.

Ví dụ sau đây minh hoạ cách ghi nhật ký một 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ố đượ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: Thông số tuỳ chỉnh không được thể hiện trực tiếp trong báo cáo 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. 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.

  • VALUE Thông số: 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 một Sự kiện Analytics. 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 Analytics Loại sự kiện được đề xuất, bạn có thể ghi nhật ký Analytics Sự kiện tuỳ chỉnh của riêng mình như trong ví dụ này:

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

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

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ý các sự kiện đúng cách. Điều này áp dụng cho 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.

iOS+

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

Xem các sự kiện phân tích trong trang tổng quan

Bạn có thể xem số liệu thống kê tổng hợp về AnalyticsSự kiện 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 lập tức, hãy sử dụng đầu ra logcat như mô tả trong phần trước.

Cách truy cập vào 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 biểu tượng Analytics trong trình đơn để xem trang tổng quan báo cáo Analytics.

Thẻ Sự kiện 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 Analytics riêng biệt mà ứng dụng của bạn ghi lại. Đọc thêm về trang tổng quan.