HandyCafe Docs
owner

Hạng Thành Viên

Hệ thống hạng thành viên thưởng cho khách hàng thường xuyên bằng các chiết khấu tự động dựa trên hoạt động tích lũy của họ. Khi thành viên sử dụng quán (chi tiêu tiền, đăng nhập, mua gói, hoặc đặt hàng), họ sẽ tích lũy điểm thành viên. Khi tổng điểm của họ vượt qua ngưỡng hạng, họ sẽ được nâng lên hạng cao hơn và nhận chiết khấu lớn hơn cho giá phiên.

Cấu Trúc Hạng

Mỗi hạng thành viên được định nghĩa bởi bốn trường:

Trường Mô tả
code Mã ngắn duy nhất cho hạng (ví dụ: silver, gold, vip). Sử dụng nội bộ để nhận diện và trong phản hồi API.
name Tên hiển thị dễ đọc (ví dụ: "Thành viên Bạc", "Thành viên Vàng"). Hiển thị trong hồ sơ thành viên và trên màn hình khóa của khách hàng.
threshold_points Số điểm thành viên tối thiểu mà thành viên phải tích lũy để đủ điều kiện cho hạng này.
discount_bps Chiết khấu áp dụng cho giá phiên, được biểu thị bằng điểm cơ bản. 100 BPS tương đương 1%. Giá trị 500 nghĩa là chiết khấu 5%.

Các hạng được sắp xếp theo giá trị threshold_points của chúng. Một thành viên thuộc về hạng cao nhất mà họ đáp ứng ngưỡng điểm.

Chiết Khấu Điểm Cơ Bản (BPS)

Chiết khấu được biểu thị bằng điểm cơ bản (BPS) thay vì phần trăm để tránh lỗi làm tròn số thập phân trong tính toán tài chính. Một điểm cơ bản tương đương 0,01%, hoặc một phần trăm của một phần trăm.

Các giá trị chiết khấu phổ biến:

Giá Trị BPS Phần Trăm Ví dụ trên giá 1000 đơn vị/giờ
250 2,5% Thành viên trả 975 mỗi giờ
500 5% Thành viên trả 950 mỗi giờ
1000 10% Thành viên trả 900 mỗi giờ
1500 15% Thành viên trả 850 mỗi giờ
2000 20% Thành viên trả 800 mỗi giờ

Khi một thành viên có chiết khấu hạng bắt đầu một phiên, công cụ định giá sẽ giảm giá cơ bản theo discount_bps của hạng trước khi tính toán chi phí phân đoạn.

Sự Kiện Thành Viên

Thành viên tích lũy điểm thông qua sự kiện thành viên. Mỗi sự kiện ghi lại sự thay đổi điểm và hoạt động đã kích hoạt nó:

Loại Sự Kiện Mô tả Điểm Thông Thường
spend Thành viên đã thanh toán cho một phiên (trả sau hoặc trừ từ ví). Điểm tỷ lệ với số tiền chi tiêu. Thay đổi theo số tiền chi tiêu
usage Thành viên đã sử dụng PC hoặc console cho một phiên, bất kể thanh toán. Điểm dựa trên thời gian sử dụng. Thay đổi theo phút sử dụng
visit Thành viên đăng nhập từ PC khách hàng. Thưởng cố định cho mỗi lần ghé thăm, khuyến khích sự tham gia thường xuyên. Cố định mỗi lần ghé thăm
topup Thành viên nạp tiền vào ví. Điểm phản ánh số tiền nạp. Thay đổi theo số tiền nạp
order Thành viên đặt hàng sản phẩm (thức ăn, đồ uống, v.v.). Điểm tỷ lệ với tổng đơn hàng. Thay đổi theo tổng đơn hàng
adjustment Điều chỉnh điểm thủ công do quản trị viên thực hiện. Dùng cho các sửa chữa, khuyến mãi hoặc phần thưởng đặc biệt. Bất kỳ giá trị nào (dương hoặc âm)

Mỗi bản ghi sự kiện thành viên bao gồm:

  • points_delta: Số điểm tích lũy (dương) hoặc mất (âm) từ sự kiện này.
  • amount_minor: Số tiền liên quan đến sự kiện (đơn vị tiền tệ nhỏ), nếu có.
  • minutes_delta: Số phút liên quan đến sự kiện, nếu có.
  • source_entity / source_entity_id: Tham chiếu trở lại phiên, đơn hàng, hoặc giao dịch đã tạo ra sự kiện.
  • event_at: Dấu thời gian khi sự kiện xảy ra.

Nâng Hạng

Quá trình nâng hạng hoạt động như sau:

  1. Thành viên thực hiện một hoạt động (phiên, mua hàng, đăng nhập, v.v.).
  2. Hệ thống tạo một sự kiện thành viên với points_delta tương ứng.
  3. Tổng điểm của thành viên được tính lại là tổng của tất cả giá trị points_delta từ sự kiện thành viên của họ.
  4. Hệ thống kiểm tra xem tổng mới có đáp ứng ngưỡng cho hạng cao hơn không.
  5. Nếu thành viên đủ điều kiện cho hạng mới, trường tier của họ được cập nhật và chiết khấu mới có hiệu lực từ phiên tiếp theo của họ.

Việc gán hạng cũng có thể được thiết lập thủ công bởi quản trị viên, ghi đè tính toán tự động.

Cách Áp Dụng Chiết Khấu Hạng Cho Giá Phiên

Khi công cụ định giá tính toán chi phí của một phân đoạn phiên cho một thành viên:

  1. Giá cơ bản theo giờ được xác định bởi khung giá hiện tại.
  2. Nếu thành viên có hạng với giá trị discount_bps, giá cơ bản được giảm: discounted_price = base_price * (10000 - discount_bps) / 10000.
  3. Ngoài ra, các chiết khấu cấp thành viên riêng lẻ (member_discount_bps trên hồ sơ thành viên) được áp dụng nếu có.
  4. Tỷ lệ chiết khấu cuối cùng được sử dụng để tính toán chi phí phân đoạn.

Chiết khấu hạng và chiết khấu cấp thành viên có thể cộng dồn, mang lại lợi ích kết hợp cho thành viên.

Tạo và Quản Lý Hạng

Để tạo một hạng mới:

  1. Điều hướng đến Cài Đặt và mở phần Định Giá (hoặc khu vực quản lý hạng chuyên dụng).
  2. Nhấp vào Thêm Hạng.
  3. Nhập code (duy nhất, chữ thường), name (nhãn hiển thị), threshold points, và discount BPS.
  4. Lưu hạng.

Để chỉnh sửa một hạng hiện có, chọn nó từ danh sách và sửa đổi bất kỳ trường nào của nó. Thay đổi discount_bps của hạng sẽ có hiệu lực trên tất cả các thành viên hiện đang được gán cho hạng đó, bắt đầu từ phiên tiếp theo của họ.

Để xóa một hạng, loại bỏ nó khỏi danh sách. Các thành viên đã được gán cho hạng bị xóa sẽ quay lại hạng thấp hơn tiếp theo mà họ đủ điều kiện dựa trên điểm của họ.

Ví Dụ Cài Đặt Hạng

Một cấu hình ba hạng điển hình có thể trông như thế này:

Code Name Threshold Points Discount BPS
bronze Bronze 0 0
silver Silver 500 500
gold Gold 2000 1000
vip VIP 5000 1500

Trong cấu hình này, một thành viên mới bắt đầu ở hạng Bronze (không có chiết khấu). Sau khi tích lũy 500 điểm từ các lần ghé thăm, chi tiêu và đặt hàng, họ tự động nâng cấp lên Silver với chiết khấu 5%. Ở mức 2000 điểm, họ đạt hạng Gold (10%) và ở mức 5000 điểm, họ đạt trạng thái VIP (15%).