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 hành vi và mức 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: Những gì đang diễn ra trong ứng dụng, chẳng hạn như thao tác của người dùng, các sự kiện của hệ thống hoặc lỗi phát sinh.
  • Thuộc tính người dùng: Các thuộc tính do 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ư ngôn ngữ ưu tiên hoặc vị trí địa lý.

Analytics 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 Analytics thuộc tính người dùng khác nhau và ghi lại tối đa 500 Analytics loại sự kiện 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.

Bạn có thể truy cập vào dữ liệu này trên 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ạo tự động cho từng loại Analytics nhật ký sự kiện riêng biệt mà ứng dụng của bạn ghi lại. Đọc 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 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ề 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. Để nhận được nhiều thông tin chi tiết nhất 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 thông 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 của Google Analytics ngay khi chúng 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 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ý

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

Ví dụ sau đây ghi lại các sự kiện có 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