Docs GamifyEngine
Trang chủ Home

Hướng dẫn kết nối GamifyEngine GamifyEngine Connection Guide

Bạn là đối tác / doanh nghiệp muốn dùng dịch vụ hay developer muốn tích hợp? Chọn đường dẫn phù hợp bên dưới.

Tôi là đối tác — GamifyEngine làm được gì? Quyết định mua / Liên hệ Tôi là Developer — Tích hợp từng bước

GamifyEngine giải quyết vấn đề gì?

Nền tảng của bạn có điểm thưởng, hạng thành viên, nhiệm vụ, đổi quà và bảng xếp hạng — không cần tự build backend, chỉ cần kết nối và cấu hình. Dưới đây là các use case chính mà đối tác thường dùng.

📈

Tăng retention & quay lại

User có điểm, có hạng (Bronze → Gold) và nhiệm vụ hàng ngày → có lý do quay lại mỗi ngày. Nghiên cứu cho thấy loyalty points giảm đáng kể tỷ lệ rời bỏ.

🎯

Tự động cộng điểm theo hành vi

Cấu hình rule: “Mỗi lần nạp tiền cộng 10 điểm”, “Đăng nhập lần đầu cộng 50 điểm” — không cần dev, chỉ chỉnh trên dashboard. Hệ thống tự nhận sự kiện và cộng điểm.

🎁

Đổi điểm lấy ưu đãi / quà

User tích điểm đổi voucher, mã giảm giá, quà tặng. Bạn cấu hình catalog phần thưởng; khi user đổi, webhook gửi sang hệ thống bạn để fulfill (gửi mã, kích hoạt quà).

🏆

Bảng xếp hạng & cạnh tranh

Leaderboard theo điểm hoặc theo tháng → user cạnh tranh, share, viral. Kết hợp với achievement (huy hiệu, nhiệm vụ) tạo cảm giác tiến bộ rõ rệt.

🎡

Campaign & vòng quay may mắn

Chạy campaign có thời hạn: “Tháng 3 đăng nhập mỗi ngày tặng 50 điểm”. Lucky Wheel: user dùng điểm quay vòng quay, trúng giải theo xác suất — tăng tương tác mạnh.

👥

Phân đoạn & targeting

Segment user theo điểm, hạng, hành vi. Áp dụng rule hoặc campaign riêng cho từng nhóm — tặng thêm điểm cho user sắp lên hạng, ưu đãi cho segment VIP.

Đã hiểu giá trị? Xem trang Dành cho đối tác để so sánh tự build vs GamifyEngine, quy trình onboard và liên hệ demo / báo giá.

Tích hợp nhanh (cho Developer)

Chỉ cần vài bước là có điểm, hạng và đổi thưởng chạy trên app/website của bạn. Tất cả có hướng dẫn step-by-step trong từng trang menu.

  1. Lấy thông tin kết nối

    Nhận Base URL API và API Key (chuỗi token) từ bên vận hành GamifyEngine — hoặc đăng nhập Client Admin → mục API Keys để tạo key. Xem Trang chủ mục “Điều kiện cần có”.

  2. Chọn kênh tích hợp

    Muốn user thấy điểm/đổi quà trên web → nhúng Widget (vài dòng HTML + JS). Muốn backend của bạn gửi event / đọc điểm → dùng SDK hoặc REST API. Platform quản lý nhiều tenant → xem Super Admin.

  3. Làm theo step-by-step trong từng trang

    Mỗi trang (Widget, SDK, API & Webhook, Super Admin, Client Admin) có block “Tích hợp từng bước” — làm lần lượt là xong. Ví dụ Widget: thêm div → load script → gọi GamifyWidget.mount(...) với apiBaseUrl, apiKey, externalId.

Quick start end-to-end (một flow từ đầu đến cuối)

Làm lần lượt các bước dưới đây; mỗi bước có link tới trang chi tiết.

  1. Lấy credential (Bước 0) — Base URL API, API Key, Tenant (do bên vận hành cung cấp sau khi ký hợp đồng). Lấy API Key: Client Admin → API Key & CORS hoặc Super Admin (cho tenant).
  2. CORS — Nếu frontend (web/app) gọi API từ trình duyệt: thêm origin của bạn vào Client Admin → Settings → CORS (Allowed origins). Nếu không, request có thể bị 403 CORS_NOT_ALLOWED_FOR_TENANT.
  3. Event Type — Khai báo loại sự kiện trước khi track: Client Admin → Event Types. Tạo event type (vd. deposit_made) và event_data_schema nếu cần validate.
  4. Rule — Tạo rule cộng điểm theo event: trong Client Admin vào Dashboard hoặc mục chứa Rules → tạo rule “khi event = deposit_made (hoặc tên đã khai báo) thì cộng X điểm”. Khi app gửi event khớp, Engine tự cộng điểm.
  5. SDK hoặc Widget — SDK: GamifyEngine.init(...) rồi GamifyEngine.track('event_type', data). Widget: load script, gọi GamifyWidget.mount(...) với apiBaseUrl, apiKey, externalId.

Điều kiện cần có trước khi kết nối (Bước 0)

  • Base URL API — Ví dụ https://api.gamifyengine.com, do bên vận hành GamifyEngine cung cấp.
  • API Key — Một chuỗi token do hệ thống cấp; lấy từ Client Admin → API Keys (hoặc Super Admin cho tenant).
  • Tenant — Slug hoặc UUID khi gọi API (multi-tenant).
  • Widget (chế độ token) — Không cần API Key trên frontend; cần cấu hình Verify Token URL trong Admin.

Các mục hướng dẫn

Super AdminQuản lý đa tenant, tạo tenant, API Key, System Admin Client AdminRule, User, Tier, Achievement, Reward, Campaign, Lucky Wheel WidgetNhúng widget cho end-user — step-by-step SDK kết nốiInit, track event — step-by-step API and WebhookREST API, Webhook — step-by-step

Toàn bộ nội dung trên trang web này. Đối tác: xem use case phía trên. Developer: vào từng trang menu và làm theo “Tích hợp từng bước”.

Are you a partner / business looking to use the service or a developer integrating it? Pick your path below.

I'm a partner — What can GamifyEngine do? Decision & contact I'm a developer — Step-by-step integration

What problems does GamifyEngine solve?

Your platform gets points, tiers, missions, rewards, and leaderboards — no need to build the backend yourself, just connect and configure. Here are the main use cases partners use.

📈

Increase retention & return

Users have points, tiers (Bronze → Gold), and daily missions → a reason to come back every day. Research shows loyalty points significantly reduce churn.

🎯

Auto-award points by behavior

Configure rules: “+10 points per deposit”, “+50 points on first login” — no dev needed, just change settings in the dashboard. The system receives events and awards points automatically.

🎁

Redeem points for rewards

Users spend points on vouchers, discount codes, gifts. You configure the reward catalog; when a user redeems, a webhook notifies your system to fulfill (send code, activate gift).

🏆

Leaderboards & competition

Rankings by points or by month → users compete, share, go viral. Combined with achievements (badges, missions) for a clear sense of progress.

🎡

Campaigns & lucky wheel

Run time-bound campaigns: “In March, +50 points per daily login”. Lucky Wheel: users spend points to spin, win by probability — strong engagement driver.

👥

Segments & targeting

Segment users by points, tier, behavior. Apply different rules or campaigns per segment — bonus points for users close to next tier, VIP-only offers.

Got the value? See the For partners page for build-vs-buy comparison, onboarding process, and demo / quote contact.

Quick integration (for developers)

A few steps and you have points, tiers, and rewards running on your app or site. Each menu page has a step-by-step integration block.

  1. Get connection details

    Receive API Base URL and API Key (token string) from the GamifyEngine operator — or log in to Client Admin → API Keys to create one. See the “Prerequisites” section on this page.

  2. Choose integration channel

    Want users to see points/rewards on the web? Embed the Widget (a few lines of HTML + JS). Want your backend to send events or read points? Use the SDK or REST API. Managing multiple tenants? See Super Admin.

  3. Follow step-by-step on each page

    Each page (Widget, SDK, API & Webhook, Super Admin, Client Admin) has a “Step-by-step integration” block — follow the steps in order. Example Widget: add div → load script → call GamifyWidget.mount(...) with apiBaseUrl, apiKey, externalId.

Quick start end-to-end (one flow from start to finish)

Follow the steps below in order; each step links to the detailed page.

  1. Get credentials (Step 0) — API Base URL, API Key, Tenant (provided by the operator after contract). Get API Key: Client Admin → API Key & CORS or Super Admin (for tenant).
  2. CORS — If your frontend (web/app) calls the API from the browser: add your origin in Client Admin → Settings → CORS (Allowed origins). Otherwise requests may get 403 CORS_NOT_ALLOWED_FOR_TENANT.
  3. Event Type — Declare event types before tracking: Client Admin → Event Types. Create an event type (e.g. deposit_made) and event_data_schema if you need validation.
  4. Rule — Create a rule to award points on event: in Client Admin go to Dashboard or the section that contains Rules → create rule “when event = deposit_made (or your declared name), award X points”. When your app sends a matching event, the Engine awards points automatically.
  5. SDK or Widget — SDK: GamifyEngine.init(...) then GamifyEngine.track('event_type', data). Widget: load script, call GamifyWidget.mount(...) with apiBaseUrl, apiKey, externalId.

Prerequisites (Step 0)

  • API Base URL — e.g. https://api.gamifyengine.com, provided by the operator.
  • API Key — A token string; from Client Admin → API Keys (or Super Admin for tenant).
  • Tenant — Slug or UUID when calling the API (multi-tenant).
  • Widget (token mode) — No API Key on frontend; configure Verify Token URL in Admin.

Guide sections

Super AdminMulti-tenant, create tenant, API Key, System Admin Client AdminRules, Users, Tiers, Achievements, Rewards, Campaigns, Lucky Wheel WidgetEmbed for end-users — step-by-step Connection SDKInit, track event — step-by-step API and WebhookREST API, Webhook — step-by-step

All content is on this site. Partners: read the use cases above. Developers: open each menu page and follow “Step-by-step integration”.