Mô tả chi tiết tính năng quản lý Metrics

Tính năng Quản lý các Độ đo (Metrics) trong module EzyGame cho phép người quản trị hệ thống nhanh chóng khai báo, cấu hình và theo dõi mọi chỉ số đo lường liên quan đến hành vi người chơi. Thông qua giao diện trực quan trên EzyPlatform, bạn có thể:

• Định nghĩa key để tham chiếu metric trong code hoặc API.
• Thiết lập câu lệnh SQL để đọc (SELECT) và ghi (UPDATE) giá trị metric từ/đến cơ sở dữ liệu.
• Đặt định dạng hiển thị, đơn vị và biểu tượng đại diện cho metric.

Mọi thay đổi được áp dụng ngay lập tức mà không cần deploy lại server, giúp bạn linh hoạt tối ưu chương trình gamification trong thời gian thực.

Các trường thông tin chính

• Id Số định danh tự động tăng.
• Tên hệ thống: Khóa (key) để tham chiếu metric trong code hoặc API (ví dụ: diamond_currency, ezygame_experience_point).
• Tên hiển thị: Nhãn (label) hiển thị trên UI, báo cáo, popup—dễ hiểu với người quản trị và người chơi.
• Đơn vị: Ký hiệu đơn vị đo lường (ví dụ: DMD, exp, m, %)
• Câu lệnh SELECT SQL: SQL dùng để đọc giá trị hiện tại của metric từ cơ sở dữ liệu, với tham số động (:playerId, :metricId, :gameName).
• Câu lệnh UPDATE SQL: SQL dùng để cập nhật hoặc chèn giá trị mới (:newValue) vào bảng dữ liệu tương ứng. Có thể là lệnh UPDATE hoặc procedure tùy cấu hình.
• Định dạng độ đo: Định nghĩa số lẻ, số chữ số thập phân hoặc cách hiển thị (00000.0000…)—đảm bảo giá trị hiện thị nhất quán.
• Biểu tượng: Icon hoặc emoji đại diện cho metric khi hiển thị trong game UI (nếu có).
• Tạo lúc / Cập nhật lúc: Thời gian tự động ghi nhận khi metric được tạo mới hoặc sửa đổi lần cuối (định dạng YYYY-MM-DD HH:MM:SS).
• Các hành động: Nút Sửa (✏️) để mở form chỉnh sửa; Nút Xóa (🗑️) để xoá metric (kèm confirm).

Tính năng thao tác

Thêm mới metric

• Click “Thêm mới” → Điền đầy đủ Tên độ đo, Tên hiển thị, Đơn vị, SQL SELECT & UPDATE, Định dạng, Icon.

• Hệ thống kiểm tra cú pháp SQL cơ bản và hiển thị lỗi (nếu có) trước khi lưu.

Chỉnh sửa metric

• Click ✏️ trên dòng tương ứng → Popup form cho phép cập nhật tất cả thông tin.

Xóa metric

• Click 🗑️ → Xác nhận xoá.
• Khi xoá, các điều kiện thành tựu hoặc sự kiện liên quan sẽ hiển thị cảnh báo để bạn kiểm tra phụ thuộc.

Cơ chế hoạt động

• Kết nối động: Mỗi khi game gọi API IncrementMetric hay GetMetric, hệ thống sẽ tự động chạy câu lệnh SELECT/UPDATE tương ứng để đọc hoặc ghi dữ liệu.
• Không cần deploy code: Việc sửa SQL hoặc thêm metric mới chỉ thực hiện trên dashboard, không ảnh hưởng đến code client/server.
• Đồng bộ realtime: Mọi thay đổi lưu trên dashboard ngay lập tức có hiệu lực, hỗ trợ A/B testing nhanh.

Lợi ích

• Linh hoạt: Kết nối được mọi bảng dữ liệu sẵn có bằng SQL tuỳ chỉnh.
• Nhanh chóng: Tạo metric mới chỉ trong 1–2 phút.
• Kiểm soát chặt chẽ: Mỗi metric đều có lịch sử cập nhật và icon rõ ràng.
• Mở rộng dễ dàng: Dễ dàng thêm metric mới khi phát sinh yêu cầu, không cần can thiệp code.