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

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 2 loại thông tin chính:

  • Sự kiện: Những gì đang diễn 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 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ư lựa chọn ưu tiên về ngôn ngữ hoặc vị trí địa lý.

Analytics tự động ghi nhật ký 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 các 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 và ghi nhật ký tối đa 500 Analytics loại sự kiện 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 nhật ký.

Cách truy cập vào 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 biểu tượng Analytics trong trình đơn để xem trang tổng quan báo cáo Analytics.

Thẻ 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 sự kiện Analytics 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 thường gặp ở 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. Để nhận đượ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 thông số quy định của sự kiện đó. Nhờ đó, bạn có thể hưởng lợi từ các tính năng Google Analytics mới nhất ngay khi chúng ra mắt.

Trước khi bắt đầu

Để có thể sử dụng Google Analytics, bạn cần phải:

  • Đă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 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 của bạn bao gồm các thao tác 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 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).

Ghi nhật ký sự kiện

Bạn có thể bắt đầu ghi lại các 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 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