了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

Bắt đầu với Google Analytics cho Unity

Google Analytics thu thập dữ liệu hành vi và sử dụng cho ứng dụng của bạn. SDK ghi lại hai loại thông tin chính:

  • Sự kiện: Điều 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.
  • Thuộc tính người dùng: Các thuộc tính bạn xác định để mô tả các phân đoạn trong cơ sở người dùng của mình, chẳng hạn như tùy chọn ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi nhật ký một số sự kiệnthuộc tính người dùng ; bạn không cần thêm bất kỳ mã nào để kích hoạt chúng. Nếu ứng dụng của bạn cần thu thập thêm dữ liệu, thì bạn có thể thiết lập tối đa 25 thuộc tính người dùng Analytics khác nhau và ghi nhật ký 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.

Để truy cập dữ liệu này:

  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.

Để 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. Để có được thông tin chi tiết tối đa trong các báo cáo, hãy ghi nhật ký các sự kiện Analytics được đề xuất phù hợp với ứng dụng của bạn và các thông số theo quy định của chúng. Điều này cũng đảm bảo rằng bạn được hưởng lợi từ các tính năng mới nhất của Google Analytics khi chúng khả dụng.

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

Bạn có thể ngay lập tức bắt đầu ghi nhật ký các sự kiện bằng phương thức LogEvent() .

Ví dụ sau đây ghi lại các sự kiện với nhiều loại đối số khác nhau:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

Bước tiếp theo