Bắt đầu sử dụng Google Analytics cho Unity

Chọn nền tảng: iOS+ Android Web Flutter Unity C++


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

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

Analytics sẽ tự động ghi lại một số sự kiện và thuộc tính người dùng; bạn không cần thêm mã nào để bật những sự kiện và thuộc tính 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ể thiết lập tối đa 25 thuộc tính người dùng Analytics và ghi lại tối đa 500 Analytics loại sự kiện trong ứng dụng của mình. 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.

Bạn có thể truy cập vào dữ liệu này trong các trang Analytics của bảng điều khiển Firebase.

Trang Analytics > Sự kiện cho thấy các báo cáo sự kiện được tự động tạo cho từng loại Analytics sự kiện riêng biệt mà ứng dụng của bạn ghi lại. Tìm hiểu thêm về trang tổng quan.

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

  • 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ác tác vụ trong 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).Firebase

Ghi nhật ký sự kiện

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

Ví dụ sau đây ghi lại các sự kiện bằng nhiều loại đối số:

// 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);

Các bước tiếp theo