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 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, các sự kiện của 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 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 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 lại. Xin lưu ý rằng tên sự kiện có phân biệt chữ hoa chữ thường. Khi bạn ghi lại 2 sự kiện có tên giống nhau (chỉ khác ở cách viết hoa viết thường), hệ thống sẽ ghi nhận đó là 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 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 đó đã đượ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 bao gồm các nhiệm vụ trong cả bảng điều khiển 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).

Sự kiện trong nhật ký

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 phổ biến 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à ứng dụng 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 các bài viết về 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 cho 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.
• Thông số được quy định: xem danh sách hằng số Parameters.

Ví dụ sau đây minh hoạ cách ghi lại 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:

• Tham số tuỳ chỉnh: Tham số tuỳ chỉnh không được trình bày trực tiếp trong Analytics báo cáo, nhưng có thể được dùng 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. Tham số tuỳ chỉnh cũng được đưa vào 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à 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 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ó nhu cầu cụ thể không được loại Sự kiện Analytics đề xuất đáp ứng, thì bạn có thể ghi lại Sự kiện Analytics tuỳ chỉnh của riêng mình như trong ví dụ sau:

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

Xem sự kiện trong kết quả nhật ký

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

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

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

• Trang tổng quan 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 được ghi lại trong nhật ký sự kiện của ứng dụng.

• Trang tổng quan này được cập nhật định kỳ trong suốt cả ngày. Để thử nghiệm ngay, hãy sử dụng bảng điều khiển gỡ lỗi Xcode hoặc kết quả 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.