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ư thông tin về người dùng hành độ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 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 bạn. 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 hai sự kiện có tên chỉ khác nhau trong trường hợp 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:

• Đăng ký dự án Unity của bạn 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ì tức là dự án đã đã đăng ký và định cấu hình cho Firebase.

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

• Thêm Firebase Unity SDK (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 bao gồm cả các tác vụ trong Bảng điều khiển của Firebase và trong dự án Unity mở của bạn (ví dụ: bạn tải các tệp cấu hình Firebase xuống từ bảng điều khiển, rồi di chuyển 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ể sử dụng phương thức này để ghi lại sự kiện bằng phương thức LogEvent().

Để giúp bạn bắt đầu, SDK Analytics sẽ xác định một số các sự kiện được đề xuất thường thấy của nhiều loại ứng dụng, bao gồm 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, hãy xem bài viết Sự kiện được đề xuất trong Trung tâm trợ giúp Google Analytics.

Bạn có thể tìm thấy thông tin triển khai cho các sự kiện được đề xuất trong phần sau vị trí:

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

Ví dụ sau minh hoạ cách ghi nhật ký SELECT_CONTENT Sự kiện:

    // 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 cho 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. Tuy nhiên, bạn có thể sử dụng các báo cáo này làm bộ lọc trong Định nghĩa về Đối tượng có thể áp dụng cho mọi báo cáo. Tùy chỉnh các thông số 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.

• Tham số VALUE: VALUE là tham số mục đích chung hữu ích khi tích luỹ chỉ số quan trọng liên quan đến 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ó các nhu cầu cụ thể không thuộc phạm vi của Loại sự kiện Analytics, bạn có thể ghi lại các sự kiện Analytics tùy chỉnh của riêng mình như 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 trang tổng quan

Bạn có thể xem số liệu thống kê tổng hợp về Sự kiện Analytics trong Trang tổng quan của bảng điều khiển Firebase. Các trang tổng quan này cập nhật định kỳ 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.

Cách truy cập vào dữ liệu này trong bảng điều khiển của Firebase:

1. Trong bảng điều khiển của Firebase, hãy mở dự án của bạn.
2. Chọn Số liệu phân tích trong trình đơn để xem Số liệu phân tích trang tổng quan báo cáo.

Thẻ Sự kiện cho thấy những báo cáo sự kiện được tạo tự động cho mỗi loại sự kiện Analytics riêng biệt được ghi lại bởi ứng dụng của bạn. Đọc thêm về trang tổng quan.