Client Admin Client Admin
Client Admin là dashboard dành cho từng tenant (client): quản lý rules, events, users, tiers, achievements, leaderboards, rewards, segments, campaigns và vòng quay may mắn (Lucky Wheel). Đăng nhập bằng tài khoản Admin của tenant (do Super Admin hoặc admin khác tạo). Sau khi đăng nhập, mọi thao tác trong dashboard dùng phiên của bạn.
Giá trị cho đối tác (use case)
Bạn không cần dev để thay đổi logic thưởng điểm: vào Client Admin, tạo/sửa Rule (vd. “mỗi lần nạp tiền cộng 10 điểm”), cấu hình Tier, Achievement, Reward, Campaign hay Lucky Wheel — tất cả qua giao diện. User của bạn thấy điểm, đổi quà, bảng xếp hạng ngay trên app/web nhờ Widget hoặc API. Một dashboard cho toàn bộ gamification của tenant: từ rule đến báo cáo.
Tích hợp từng bước (cho Developer)
- Nhận tài khoản Client Admin
Super Admin (hoặc admin khác) tạo tài khoản cho tenant của bạn. Đăng nhập Client Admin bằng email/password → nhận JWT.
- Lấy API Key cho tích hợp
Vào mục API Keys trong Client Admin, tạo key mới. Dùng key này cho Widget (hoặc backend trả key theo session), SDK track event, hoặc REST API server-to-server. Lưu key ngay vì không xem lại được.
- Cấu hình Rule & Event Type (nếu chưa có)
Trong Client Admin: Event Types → tạo loại sự kiện (vd.
deposit_made). Sau đó vào mục Rules (thường nằm trong Dashboard hoặc sidebar / Event Types & Events tùy phiên bản) → tạo rule “khi event =deposit_madethì cộng X điểm”. Khi app/website gửi event khớp (qua SDK hoặc API), Engine tự cộng điểm. - Nhúng Widget hoặc gọi API
Cho end-user xem điểm/đổi quà: nhúng Widget (xem trang Widget). Cho backend đọc/ghi: dùng REST API. Cho frontend bắn event: dùng SDK.
Rules — Tạo rule cộng điểm theo event
Đường đi trong UI: Rules (rule cộng điểm khi user gửi event) thường nằm trong Dashboard (dạng tab hoặc section “Rules”) hoặc trong sidebar Client Admin dưới tên “Rules” / “Event Types & Events” tùy phiên bản. Nếu không thấy mục “Rules”, hãy vào Dashboard — tại đây có thống kê điểm theo từng rule và thường có link/thao tác để tạo hoặc sửa rule.
Cách tạo rule: (1) Chọn event type đã khai báo (vd. deposit_made) — xem Event Types. (2) Thiết lập điều kiện (nếu có, vd. segment, tier). (3) Nhập số điểm được cộng khi rule khớp. Lưu rule. Sau đó mỗi khi app/website của bạn gửi event với event_type và event_data khớp, Engine tự động cộng điểm cho user.
Các trang hướng dẫn chi tiết
Mỗi tính năng có một trang riêng để bạn mở rộng nội dung sau này:
- Tính năng — Danh sách trang / tính năng đang có.
- Đăng nhập — Cách đăng nhập, JWT.
- Dashboard — Tổng quan thống kê tenant (và Rules nếu có).
- Event Logs — Danh sách / lịch sử event đã gửi.
- Notifications — Gửi thông báo (in-app) và quản lý kênh.
- Event Types — Cấu hình loại sự kiện (name, schema).
- Users — Quản lý user, điểm, lịch sử.
- Tiers — Hạng (Bronze, Silver, Gold…).
- Achievements — Nhiệm vụ / thành tích.
- Leaderboards — Bảng xếp hạng.
- Rewards — Catalog phần thưởng, đổi điểm.
- Segments — Phân đoạn user.
- Campaigns — Chiến dịch có thời hạn.
- Lucky Wheel — Vòng quay may mắn.
- API Key & CORS — Quản lý API Key, Track Event, CORS.
Client Admin is the dashboard for each tenant (client): manage rules, events, users, tiers, achievements, leaderboards, rewards, segments, campaigns, and Lucky Wheel. Log in with the tenant’s Admin account (created by Super Admin or another admin). After login, all actions in the dashboard use your session.
Value for partners (use case)
You don’t need dev to change reward logic: in Client Admin, create or edit Rules (e.g. “+10 points per deposit”), configure Tiers, Achievements, Rewards, Campaigns, or Lucky Wheel — all via the UI. Your users see points, redeem rewards, and leaderboards in your app or web via the Widget or API. One dashboard for the tenant’s entire gamification: from rules to reporting.
Step-by-step integration (for developers)
- Get Client Admin account
Super Admin (or another admin) creates an account for your tenant. Log in to Client Admin with email/password → receive JWT.
- Get API Key for integration
In Client Admin go to API Keys, create a new key. Use it for the Widget (or have your backend return the key per session), SDK track events, or server-to-server REST API. Save the key immediately; it can’t be viewed again.
- Configure Rules & Event Types (if needed)
In Client Admin: Event Types → create event type (e.g.
deposit_made). Then go to Rules (usually in Dashboard or in the sidebar under “Rules” / “Event Types & Events” depending on version) → create rule “when event =deposit_made, award X points”. When your app sends a matching event (via SDK or API), the Engine awards points automatically. - Embed Widget or call API
For end-users to see points/redeem: embed the Widget. For backend read/write: use REST API. For frontend to send events: use SDK.
Rules — Create rules to award points on events
Where to find Rules in the UI: Rules (award points when the user sends an event) are usually in the Dashboard (as a tab or “Rules” section) or in the Client Admin sidebar under “Rules” / “Event Types & Events” depending on the version. If you don’t see “Rules”, open the Dashboard — it shows stats per rule and often has a link or action to create or edit rules.
How to create a rule: (1) Select an event type you’ve already declared (e.g. deposit_made) — see Event Types. (2) Set conditions if any (e.g. segment, tier). (3) Enter the points to award when the rule matches. Save the rule. Then whenever your app sends an event with a matching event_type and event_data, the Engine awards points to the user automatically.
Detailed guide pages
Each feature has its own page so you can expand content later:
- Features — List of pages/features available.
- Login — How to log in, JWT.
- Dashboard — Tenant stats overview (and Rules if available).
- Event Logs — List/history of events sent.
- Notifications — Send in-app notifications and manage channels.
- Event Types — Configure event types (name, schema).
- Users — Manage users, points, history.
- Tiers — Ranks (Bronze, Silver, Gold…).
- Achievements — Missions/badges.
- Leaderboards — Rankings.
- Rewards — Reward catalog, redeem with points.
- Segments — User segments.
- Campaigns — Time-bound campaigns.
- Lucky Wheel — Spin-the-wheel.
- API Key & CORS — API Key management, Track Event, CORS.